Delete a custom role (admin only)

DELETE 
/api/roles/:roleId

Deletes a custom role. Its members are moved to the role named by reassign_to (another custom role), or detached to their built-in base defaults when it is omitted.

Request

Responses

204

The role was deleted.

401

Not authenticated. code: account_disabled means the member's seat was deactivated in this workspace: the session is over even though the token was not revoked (clients sign out and clean up).

403

Authenticated but not allowed.

404

Resource not found (or not visible to the current tenant).

422

The request failed validation.