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?
Step-by-Step Procedure
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.
Click "Edit"
The dialog is titled "Edit <roleKey>". "Role Key" and "Type" are disabled and cannot change.
Change what you need
Edit "Name", "Data Scope", "Tier (1-6)", "Min Clearance (1-5)", "Description", "Direct Permissions" and "Denied Permissions (separation of duties)".
Save
Click "Save Role". On success the card refreshes with a higher version number.
The role carries the new settings and version; the Mesh reflects any permission changes.
Troubleshooting & Failure Modes
Was this guide helpful?
Help us refine our platform documentation