Permission Matrix
View as Markdown
Every permission in OmnyBot follows a `resource:action` format. The live catalog of 13 permission keys across 5 groups is synced directly from the backend when creating or editing roles under **Settings → Admin → Roles**.
## Core permission groups
| Group | Permission keys | Scope |
| --- | --- | --- |
| **Workspace** | `workspace:manage`, `member:manage`, `role:manage`, `billing:manage`, `audit:read` | Manage general settings, members, custom roles, billing, and view Audit Logs. |
| **Connected Channels** | `nick:read:all`, `nick:operate`, `nick:connect`, `nick:delete` | View, operate (reconnect/disconnect/proxy), connect new channels, soft-delete, or restore from Trash. |
| **Inbox** | `inbox:read:all`, `inbox:reply` | View all workspace conversations and send, react, or recall messages. |
| **AI & Knowledge** | `ai:manage` | Configure AI Bots, MCP connections, Knowledge Base, and AI knowledge gaps. |
| **CRM & Operations** | `crm:manage` | Legacy/internal permission key retained in the catalog for backend CRM operations. |
## Built-in role comparison
| Capability | Owner | Manager | Agent | Viewer |
| --- | :---: | :---: | :---: | :---: |
| Delete Workspace | ✓ | — | — | — |
| General Settings (`workspace:manage`), Roles (`role:manage`), Billing (`billing:manage`) | ✓ | — | — | — |
| Manage Members (`member:manage`) | ✓ | ✓ | — | — |
| View Audit Logs (`audit:read`) | ✓ | ✓ | — | — |
| Manage Channels (`nick:connect`, `nick:operate`, `nick:delete`) | ✓ | ✓ | — | — |
| View Channels & Inbox (`nick:read:all`, `inbox:read:all`) | ✓ | ✓ | ✓ | ✓ |
| Reply in Inbox (`inbox:reply`) | ✓ | ✓ | ✓ | — |
| Manage AI & Knowledge (`ai:manage`) & `crm:manage` | ✓ | ✓ | — | — |
:::tip[Permission union rule]
When a member holds multiple roles (**Scale** plan and above), OmnyBot grants the **union** of all permissions across those roles. See the full key-by-key table in [Roles & Permissions Matrix](/reference/roles-permissions/) and role setup in [Overview & Custom Roles](/workspace-management/roles/).
:::
Every permission in OmnyBot follows a resource:action format. The live catalog of 13 permission keys across 5 groups is synced directly from the backend when creating or editing roles under Settings → Admin → Roles.
Core permission groups
Section titled “Core permission groups”| Group | Permission keys | Scope |
|---|---|---|
| Workspace | workspace:manage, member:manage, role:manage, billing:manage, audit:read | Manage general settings, members, custom roles, billing, and view Audit Logs. |
| Connected Channels | nick:read:all, nick:operate, nick:connect, nick:delete | View, operate (reconnect/disconnect/proxy), connect new channels, soft-delete, or restore from Trash. |
| Inbox | inbox:read:all, inbox:reply | View all workspace conversations and send, react, or recall messages. |
| AI & Knowledge | ai:manage | Configure AI Bots, MCP connections, Knowledge Base, and AI knowledge gaps. |
| CRM & Operations | crm:manage | Legacy/internal permission key retained in the catalog for backend CRM operations. |
Built-in role comparison
Section titled “Built-in role comparison”| Capability | Owner | Manager | Agent | Viewer |
|---|---|---|---|---|
| Delete Workspace | ✓ | — | — | — |
General Settings (workspace:manage), Roles (role:manage), Billing (billing:manage) | ✓ | — | — | — |
Manage Members (member:manage) | ✓ | ✓ | — | — |
View Audit Logs (audit:read) | ✓ | ✓ | — | — |
Manage Channels (nick:connect, nick:operate, nick:delete) | ✓ | ✓ | — | — |
View Channels & Inbox (nick:read:all, inbox:read:all) | ✓ | ✓ | ✓ | ✓ |
Reply in Inbox (inbox:reply) | ✓ | ✓ | ✓ | — |
Manage AI & Knowledge (ai:manage) & crm:manage | ✓ | ✓ | — | — |