Help Center/Governance, RBAC & Security Desk/How to delete a custom role
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?

Ask AI Copilot

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