Help Center/Governance, RBAC & Security Desk/How to edit a role's permissions, scope and clearance
Governance, RBAC & Security Desk•Last updated: 2026-10-20•3 min read

How to edit a role's permissions, scope and clearance

The Edit button on a role card opens the same form with the key and type locked; saving bumps the role version and audits the change.

Have questions or need step-by-step guidance on this topic?

Ask AI Copilot

Step-by-Step Procedure

1

Find the role

On /admin/rbac/roles locate the role card. Badges show type, tier, version, default data scope and number of direct permissions; system roles also show a "Locked" tag.

2

Click "Edit"

The dialog is titled "Edit <roleKey>". "Role Key" and "Type" are disabled and cannot change.

3

Change what you need

Edit "Name", "Data Scope", "Tier (1-6)", "Min Clearance (1-5)", "Description", "Direct Permissions" and "Denied Permissions (separation of duties)".

4

Save

Click "Save Role". On success the card refreshes with a higher version number.

Expected Operational Outcome

The role carries the new settings and version; the Mesh reflects any permission changes.

Troubleshooting & Failure Modes

Symptom: was modified concurrently (expected version N). Re-fetch and retry.
Likely Cause: Someone else saved the role first.
Resolution: Close the dialog, let the page refresh and edit again.
Symptom: Cannot change identity/type of system-protected role
Likely Cause: An attempt to change key or type of a protected role.
Resolution: Leave key and type untouched.

Was this guide helpful?

Help us refine our platform documentation