Roles & Permissions
View as Markdown
OmnyBot uses **RBAC (Role-Based Access Control)** to govern access across every feature. Each member can hold one or more roles; their effective permissions are the **union** of all permissions granted by their assigned roles.
:::note[Required permission]
Viewing and editing roles requires the **`role:manage`** permission.
:::
## Built-in system roles
| Role | Scope |
| --- | --- |
| **Owner** | Full administrative control over the workspace, including general settings, billing, roles, and workspace deletion. |
| **Manager / Admin** | Full operational control over conversations, channels, members, AI bots, and knowledge base, without Owner-only workspace deletion. |
| **Agent** | Handles customer conversations in the Team Inbox and uses authorized workspace resources. |
| **Viewer** | Read-only access to monitor workspace activity without editing settings or sending messages. |
## Create a custom role
When your team needs finer separation of duties (for example, a role dedicated only to Knowledge Base curation or Audit Log review):
1. Go to **Settings → Admin → Roles**.
2. Click **Create Role**, then enter a name and description.
3. Toggle individual permissions across functional groups (Workspace, Members, Roles, Channels, Inbox, AI & Knowledge Base, Billing, Logs, etc.).
4. Save the role and assign it to teammates under [Members & Invitations](/workspace-management/members/).
OmnyBot uses RBAC (Role-Based Access Control) to govern access across every feature. Each member can hold one or more roles; their effective permissions are the union of all permissions granted by their assigned roles.
Built-in system roles
Section titled “Built-in system roles”| Role | Scope |
|---|---|
| Owner | Full administrative control over the workspace, including general settings, billing, roles, and workspace deletion. |
| Manager / Admin | Full operational control over conversations, channels, members, AI bots, and knowledge base, without Owner-only workspace deletion. |
| Agent | Handles customer conversations in the Team Inbox and uses authorized workspace resources. |
| Viewer | Read-only access to monitor workspace activity without editing settings or sending messages. |
Create a custom role
Section titled “Create a custom role”When your team needs finer separation of duties (for example, a role dedicated only to Knowledge Base curation or Audit Log review):
- Go to Settings → Admin → Roles.
- Click Create Role, then enter a name and description.
- Toggle individual permissions across functional groups (Workspace, Members, Roles, Channels, Inbox, AI & Knowledge Base, Billing, Logs, etc.).
- Save the role and assign it to teammates under Members & Invitations.