Delete a role

Delete a role from the system.

Authorization: Users can delete roles they have permission to manage. Permissions are checked via Cerbos policies.

Cascade Effects:

• Removes the role from all groups that have it assigned
• Removes all action permissions associated with the role
• Updates Cerbos policies to reflect the role deletion

Use Cases:

• Remove obsolete or unused roles
• Administrative role cleanup
• Security compliance and role minimization
• System reorganization

Safety: Role deletion is irreversible. Ensure the role is no longer needed before deletion.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

role_name · string · required

Response

204

Role deleted successfully