Sign in

v13

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

Replace a role in a role set

Replaces a role in a role set with another role. This atomically removes the source role and reassigns any members to the destination role.

post/role_sets/{role_set_key_or_id}/roles/replace

Path parameters

role_set_key_or_idstring required

The key or ID of the role set

Request body

role_keystring required

The key of the role to remove from the role set

to_role_keystring required

The key of the role to reassign members to

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