Sign in

v13

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-04237161688.6 KB
Role Sets

Add roles to a role set

Adds one or more roles to an existing role set. You can optionally update the default role or creator role when adding new roles.

post/role_sets/{role_set_key_or_id}/roles

Path parameters

role_set_key_or_idstring required

The key or ID of the role set

Request body

role_keysstring[] required

Array of role keys to add to the role set. Must contain at least one role and no more than 10 roles.

default_role_keystring

Optionally update the default role to one of the newly added roles.

creator_role_keystring

Optionally update the creator role to one of the newly added roles.

Response

Success

object'role_set' required
idstring required

The unique identifier of the role set

namestring required

The name of the role set

keystring required

A unique key for the role set (e.g., "role_set:default")

descriptionstring nullable required

Optional description of the role set

type'initial' | 'custom' required

The type of the role set ("initial" or "custom")

created_atinteger required

Unix timestamp of role set creation

updated_atinteger required

Unix timestamp of last role set update