Skip to main content
PUT
/
guilds
/
{guild_id}
/
bans
/
{user_id}
cURL
curl --request PUT \
  --url https://discord.com/api/v10/guilds/{guild_id}/bans/{user_id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "delete_message_seconds": 302400,
  "delete_message_days": 3
}
'
{
  "code": 123,
  "message": "<string>",
  "retry_after": 123,
  "global": true
}

Authorizations

Authorization
string
header
required

Discord bot token

Path Parameters

guild_id
string<snowflake>
required
user_id
string<snowflake>
required

Body

application/json
delete_message_seconds
integer | null
Required range: 0 <= x <= 604800
delete_message_days
integer | null
Required range: 0 <= x <= 7

Response

204 response for ban_user_from_guild