Creating Roles
Admin Only
This page is only visible to organization administrators.
Roles group resources and users together to simplify permission management.
Creating a Role
Navigate to Roles under the Admin section in the sidebar.
- Click Add Role.
- Fill in the form:
- Name — A unique role name (e.g., "Production DB Access")
- Description — An optional description of what this role grants access to
- Click Create.
The role appears in the roles table. You can now assign resources and users to it.
Roles Table
| Column | Description |
|---|---|
| (Expand) | Click to expand and see assigned resources and users |
| Name | Role name |
| Description | Role description |
| Resources | Number of assigned resources |
| Users | Number of assigned users |
| (Delete) | Delete the role |
Expanded View
Click a role row to expand it and see two sections:
- Resources — Lists all resources assigned to this role, with a Remove button for each and an Add resource... dropdown to assign more
- Users — Lists all users assigned to this role, with a Remove button for each and an Add user... dropdown to assign more
Deleting a Role
Click the delete button (trash icon) on the role row. This unassigns all users and resources from the role.
warning
Deleting a role removes access for all users assigned to it. Make sure users have alternative access before deleting.
Next Steps
API Reference: For programmatic access, see Create Role.