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

guild_idstring snowflake required

The ID of the guild

role_idstring snowflake required

The ID of the role

namestring

The name of the role (1-100 characters)

colorinteger

The color of the role as an integer

permissionsstring int64

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

Success

idstring required

The unique identifier for this role

namestring required

The name of the role

colorinteger required

The colour of the role as an integer

positioninteger required

The position of the role in the role hierarchy

hoist_positioninteger

permissionsstring int64 required

The permissions bitfield for the role

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

No recorded changes to this endpoint across all 1 revision of this API.