Guilds

List guild roles

List guild roles. Requires guilds OAuth scope if using bearer token. Returns all roles defined in the guild including their permissions and settings.

get/guilds/{guild_id}/roles

Path parameters

guild_idstring snowflake required

The ID of the guild

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.