Ban a user

POST {{baseUrl}}/v3/group_channels/:channel_url/ban

Ban a user

Bans a user from a group channel. A banned user is immediately expelled from a channel and allowed to join the channel again after a set time period.

https://sendbird.com/docs/chat/v3/platform-api/guides/group-channel#2-ban-a-user

Request Body

{"channel_url"=>"<string>", "user_id"=>"<string>", "agent_id"=>"<string>", "seconds"=>"<integer>", "description"=>"<string>"}

HEADERS

KeyDatatypeRequiredDescription
Api-Tokenstring(Required)
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;user&quot;:{&quot;require_auth_for_profile_image&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_online&quot;:&quot;\u003cboolean\u003e&quot;,&quot;user_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;access_token&quot;:&quot;\u003cstring\u003e&quot;,&quot;has_ever_logged_in&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_active&quot;:&quot;\u003cboolean\u003e&quot;,&quot;last_seen_at&quot;:&quot;\u003cinteger\u003e&quot;,&quot;nickname&quot;:&quot;\u003cstring\u003e&quot;,&quot;discovery_keys&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;session_tokens&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;preferred_languages&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;profile_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;created_at&quot;:&quot;\u003cinteger\u003e&quot;,&quot;phone_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;local&quot;:&quot;\u003cstring\u003e&quot;,&quot;locale&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_hide_me_from_friends&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_shadow_blocked&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_created&quot;:&quot;\u003cboolean\u003e&quot;,&quot;metadata&quot;:{&quot;constructor&quot;:{&quot;arguments&quot;:{},&quot;caller&quot;:{&quot;value&quot;:&quot;\u003cCircular reference to #/components/schemas/Function detected\u003e&quot;},&quot;length&quot;:&quot;\u003cnumber\u003e&quot;,&quot;prototype&quot;:{}}},&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;end_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;start_at&quot;:&quot;\u003cnumber\u003e&quot;},&quot;start_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;end_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;metadata&quot;:{&quot;anyOf&quot;:&quot;\u003cstring\u003e&quot;},&quot;next_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;nickname&quot;:&quot;\u003cstring\u003e&quot;,&quot;profile_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;require_auth_for_profile_image&quot;:&quot;\u003cboolean\u003e&quot;,&quot;user_id&quot;:&quot;\u003cstring\u003e&quot;}