Skip to main content
PATCH
/
guilds
/
{guild_id}
/
roles
cURL
curl --request PATCH \
  --url https://discord.com/api/v10/guilds/{guild_id}/roles \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "id": "<unknown>",
    "position": 123
  }
]
'
[
  {
    "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

Body

application/json
id
null | string<snowflake>
position
integer<int32> | null

Response

200 response for bulk_update_guild_roles

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