Skip to main content
PATCH
/
guilds
/
{guild_id}
/
roles
/
{role_id}
cURL
curl --request PATCH \
  --url https://discord.com/api/v10/guilds/{guild_id}/roles/{role_id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "permissions": 123,
  "color": 8388607,
  "colors": "<unknown>",
  "hoist": true,
  "mentionable": true,
  "icon": "<string>",
  "unicode_emoji": "<string>"
}
'
{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "permissions": "<string>",
  "position": 123,
  "color": 123,
  "colors": {
    "primary_color": 123,
    "secondary_color": 123,
    "tertiary_color": 123
  },
  "hoist": true,
  "managed": true,
  "mentionable": true,
  "icon": "<string>",
  "unicode_emoji": "<string>",
  "flags": 123,
  "tags": {
    "premium_subscriber": "<unknown>",
    "bot_id": "<string>",
    "integration_id": "<string>",
    "subscription_listing_id": "<string>",
    "available_for_purchase": "<unknown>",
    "guild_connections": "<unknown>"
  }
}

Authorizations

Authorization
string
header
required

Discord bot token

Path Parameters

guild_id
string<snowflake>
required
role_id
string<snowflake>
required

Body

application/json
name
string | null
Maximum string length: 100
permissions
integer | null
color
integer | null
Required range: 0 <= x <= 16777215
colors
object
hoist
boolean | null
mentionable
boolean | null
icon
string | null
unicode_emoji
string | null
Maximum string length: 100

Response

200 response for update_guild_role

id
string<snowflake>
required
name
string
required
description
string | null
required
permissions
string
required
position
integer<int32>
required
color
integer<int32>
required
colors
object
required
hoist
boolean
required
managed
boolean
required
mentionable
boolean
required
icon
string | null
required
unicode_emoji
string | null
required
flags
integer<int32>
required
tags
object