Skip to main content
DELETE
Delete a custom role
🔒 Admin only. Requires administrator privileges — the authenticated principal (API key, embed JWT, or any bearer token) must belong to a user with the admin role. Deletes the role and every assignment of it, from users and from groups. Built-in roles cannot be deleted.

Authorizations

Authorization
string
header
required

Token authentication. Send Authorization: Bearer <YOUR_TOKEN>.

Path Parameters

roleId
number
required

Response

Successful response