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

string snowflake required
OR
integer required

The ID of the guild

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