Governance, RBAC & Security Desk•Last updated: 2026-10-20•3 min read
How to delete a custom role
Non-protected roles can be deleted from their card; system-protected ("Locked") roles cannot.
Have questions or need step-by-step guidance on this topic?
Step-by-Step Procedure
1
Pick a deletable role
On /admin/rbac/roles the "Delete" button is disabled on cards with the "Locked" tag.
2
Click "Delete"
A confirmation reads "Delete role "<roleKey>"? This cannot be undone."
3
Confirm
Choose OK. The card disappears. If the server refuses, a red message appears above the grid.
Expected Operational Outcome
The role is removed and the deletion is recorded in the governance audit chain.
Troubleshooting & Failure Modes
Symptom: Cannot delete system-protected role
Likely Cause: You tried to delete a Locked role.
Resolution: System roles cannot be deleted; edit permissions instead if allowed.
Was this guide helpful?
Help us refine our platform documentation