# Permission Matrix

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/).
:::