Sign in
Guilds

Update guild role

Update guild role. Requires manage_roles permission. Modifies role name, permissions, color, and other settings.

patch/guilds/{guild_id}/roles/{role_id}

Path parameters

string snowflake required
OR
integer required

The ID of the guild

string snowflake required
OR
integer required

The ID of the role

Request body

namestring

The name of the role (1-100 characters)

colorinteger
hoistboolean

Whether the role should be displayed separately in the member list

hoist_positioninteger nullable

The position of the role in the hoisted member list

mentionableboolean

Whether the role can be mentioned by anyone

Response

Success

idstring snowflake required
namestring required

The name of the role

colorinteger required
positioninteger required
hoist_positioninteger
permissionsstring int64 required

Permission bitfield as string

hoistboolean required

Whether this role is displayed separately in the member list

mentionableboolean required

Whether this role can be mentioned by anyone

unicode_emojistring nullable

The unicode emoji for this role

Changes