Help Screens Roles & permissions
Role detail ROL-02
View or edit a role's permissions.
| Who can use it | users.list (read), roles.manage (write) |
|---|---|
| Where it is | /admin/roles/:roleId · link: https://hub.substratalapps.com/admin/roles/:roleId or substratal://admin/roles/:roleId |
| Available on | Web (PWA), iOS / iPadOS, Android, Windows, Linux (GNOME), macOS |
| Phase | MVP |
What you can do here
- Save
- Delete — 409 → still assigned
Related guides
- Roles and permissions — Built-in roles, creating narrower ones, and assigning them safely.
On your platform
| App | Status | How it's built |
|---|---|---|
| Web (PWA) | — | Detail pane with header, tablist, toolbar; full page < 768 px |
| iOS / iPadOS | — | Pushed view; segmented Picker; toolbar actions |
| Android | Planned | Detail pane / pushed screen; PrimaryTabRow; top-bar actions |
| Windows | — | Detail pane / drill-in page; SelectorBar tabs; CommandBar actions |
| Linux (GNOME) | — | Content pane; AdwViewSwitcher; header-bar actions |
| macOS | — | Detail column; tabs as segmented Picker in toolbar principal |
Status is reported by each app's repository; — means that app doesn't report it yet.
For developers: API calls
| Method | Path | What it does |
|---|---|---|
| GET | /users | List or search users |
| GET | /permissions | List every Permission key the caller can see |
| GET | /roles/{id} | Fetch one Role |
| PATCH | /roles/{id} | Change a Role's permissions or description |
| DELETE | /roles/{id} | Delete an unassigned, non-seed Role |
Every call sends Substratal-Version: 1. Paths are at the host root, with no /v1.