Guilds

Create guild role

Create guild role. Requires manage_roles permission. Creates a new role with specified name, permissions, and color.

post/guilds/{guild_id}/roles

Path parameters

guild_idstring snowflake required

The ID of the guild

namestring required

The name of the role (1-100 characters)

colorinteger

The color of the role as an integer (default: 0)

permissionsstring int64

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.