Dashboard: Users & Roles
Routerly has a role-based access control (RBAC) system for the dashboard. Users are granted permissions via roles. Three built-in roles are provided; you can create additional custom roles with any combination of permissions.
Permissions
| Permission | Description |
|---|---|
project:read | View projects and their configuration |
project:write | Create, edit, and delete projects |
model:read | View registered models |
model:write | Create, edit, and delete models |
user:read | View dashboard users |
user:write | Create, edit, and delete users, assign roles |
report:read | View usage analytics and request logs |
Built-in Roles
| Role | Permissions |
|---|---|
admin | All permissions |
operator | project:read, project:write, model:read, model:write, report:read |
viewer | project:read, model:read, report:read |
Managing Users
Adding a User
- Open Users in the sidebar
- Click + New User
- Enter the email address, password, and assign a role
- Click Create
The new user can log in immediately.
Editing a User
Click the Edit icon to change the user's email, password, or role.
Removing a User
Click the Delete icon and confirm. The user's session is invalidated immediately.
Custom Roles
Custom roles let you define granular permission sets for specific team members.
Creating a Custom Role
- Open Roles in the sidebar
- Click + New Role
- Give the role a name (e.g.
billing_reviewer) - Check the permissions this role should have
- Click Save
Custom roles can be assigned to users the same way as built-in roles.
Editing / Deleting a Custom Role
Click Edit to change the role's permissions. Users with this role are affected immediately.
Click Delete to remove the role. Users who had this role will lose their dashboard access. Reassign them first.
Project-Level User Assignment
Users can also be assigned to specific projects (from the project's Users tab). This limits their access to that project without changing their global role.
CLI Management
# List all users
routerly user list
# Add a user
routerly user add --email [email protected] --role operator
# Remove a user
routerly user remove --email [email protected]
# List roles
routerly role list
# Add a custom role
routerly role add --name billing_reviewer --permissions report:read
# Remove a custom role
routerly role remove --name billing_reviewer