Roles and what each can do
The four workspace roles and which actions each may take, generated from the code's own permission checks.
Generated from the code by `apps/web/scripts/gen-enterprise-guides.mts`; do not edit by hand. A test fails if this differs from what the code produces. The full per-action list, with exceptions, is `docs/security/role-matrix.md`. Actions of Velor's own operator console are not listed: they exist only in Velor's staff workspace.
There are four roles: owner, admin, agent and member. There is no read-only role. A person has one role in each workspace they belong to, read from their membership of the workspace they are working in. The page /dashboard/settings/roles shows the same roles inside the product.
Every action the product exposes checks the caller's role on the server; hiding a button is never the control.
How many actions each level can take
| Who may take the action | Count |
|---|---|
| Owner only | 34 |
| Owner or admin | 252 |
| Owner, admin or agent | 58 |
| Any signed-in role | 28 |
Only an owner can
| Area | Actions |
|---|---|
| Dashboard | record attribution |
| Settings: actions.ts | set actions kill switch, set billing contact, set skills kill switch |
| Settings: custom-domain | add domain, remove domain, verify domain |
| Settings: data | request deletion, request export, set retention days |
| Settings: encryption | rewrap kek, rotate dek |
| Settings: privacy | accept legal document, update consent required |
| Settings: references | grant reference consent, revoke reference consent |
| Settings: scim | generate scim token, revoke scim token |
| Settings: security | set audit log retention, set idle timeout, set ip allowlist, set mfa required, set require approval destructive, set siem webhook, set slack webhook |
| Settings: sso | configure sso, delete sso, start sso domain verification, toggle sso enforcement, verify sso domain |
| team | change role, transfer ownership |
| voice | update voice minute limits |
| workspace | create workspace |
An owner or an admin can
| Area | Actions |
|---|---|
| actions | clear auto disable, create action, delete action, get action metrics, install action template, install sandbox actions, rotate signing secret, test invoke action, toggle enabled, update action |
| agents | preview publish check action, publish agent version action, run sandbox simulation, save agent draft version action, set rollout percent action |
| approvals | review approval |
| billing | set outcomes metering |
| connectors | create custom http action, install connector, rotate connector credential, rotate custom http signing secret, test connector credentials, test installed connector, uninstall connector |
| conversations | merge conversations, turn conversation into test |
| customers | create segment, delete segment, export dsar, update segment |
| evals | cancel run, delete dataset, generate from conversations, revoke eval run share, share eval run, start run |
| experiments | create experiment, update experiment status |
| guardrails | count recent check skips, create principle, delete guardrail, delete principle, list guardrails, list principles, list recent redactions, read held answers this week, read verify before send, save guardrail, set verify before send, test principle, toggle guardrail, update principle |
| help-center | create article, delete article, draft article from suggestion, publish article, suggest article topics, unpublish article, update article |
| insights | email value report to me |
| integrations | create mcp server, delete mcp server, set mcp server trust read only hints, sync mcp tools, toggle mcp server enabled, update mcp server auth |
| knowledge | approve kb draft, delete failed sources, delete source, dismiss kb finding, get source status, reingest source, reject kb draft, remove duplicate copy, test kb retrieval, trigger kb resync, update kb draft answer, upload knowledge confluence, upload knowledge crawl, upload knowledge csv, upload knowledge docx, upload knowledge json, upload knowledge notion, upload knowledge pdf, upload knowledge sitemap, upload knowledge text, upload knowledge url |
| migrate | import freshdesk action, import help scout action, import intercom action, import zendesk action |
| monitoring | acknowledge flag, create monitor, delete monitor, toggle monitor |
| Other | start sample explore |
| pilot | end pilot, save pilot targets |
| playground | delete config, list configs, load config, save config |
| quality | create brand voice guide, create rubric, create starter brand voice guide, create starter rubric, publish brand voice guide, publish rubric, set default rubric, set qa sample rate |
| Settings: actions.ts | set translation enabled |
| Settings: agent | generate blueprint, restore agent config version, save agent config |
| Settings: agent-prompt | save agent prompt, test discord webhook, test slack webhook, test teams webhook |
| Settings: api-keys | create api key, revoke api key |
| Settings: automation | create rule, delete rule, update rule |
| Settings: behaviors | add behavior, delete behavior, extract behaviors from sop, import behaviors, toggle behavior, update behavior |
| Settings: billing | request upgrade action, save billing identity action |
| Settings: blocked-visitors | block conversation visitor, unblock visitor |
| Settings: business-hours | save business hours |
| Settings: coaching | save coaching policy |
| Settings: custom-fields | create custom field, delete custom field |
| Settings: data | preview visitor erasure, request visitor erasure |
| Settings: experiments | create experiment, create prompt version, create prompt version from template, publish prompt version, set experiment status |
| Settings: import | import conversations, import knowledge sources, import routing rules, preview article import, preview canned import, preview record import, run article import, run canned import, run record import, undo article import, undo canned import, undo record import |
| Settings: integrations | check hub spot health, check salesforce health, disconnect hub spot, disconnect salesforce, set escalation destination |
| Settings: outbound | add do not call number, remove do not call number, save outbound settings |
| Settings: persona | approve faq, delete faq, generate faqs for org, save persona |
| Settings: privacy | subscribe to subprocessor notices, unsubscribe from subprocessor notices |
| Settings: proactive | save proactive config, save proactive rules |
| Settings: routing | save routing config, save sentiment threshold, set agent capacity |
| Settings: security | regenerate widget identity secret, test siem webhook action |
| Settings: sla | update sla notifications, update sla threshold |
| Settings: sms | check sms registration status |
| Settings: starter-pack | apply starter pack action |
| Settings: ticket-cost | save ticket cost |
| Settings: topics | create topic, delete topic, update topic |
| Settings: webhooks | create webhook, delete webhook, retry webhook delivery, rotate webhook secret, send test webhook, toggle webhook |
| Settings: widget | save widget allowed domains, save widget branding, save widget journey tracking, verify widget installation |
| Settings: workflows | create workflow, create workflow from template, delete workflow, set workflow enabled, update workflow graph |
| Sign-in and onboarding | add kb source, apply signup draft, create test escalation, did send wizard widget message, emit onboarding resumed, ensure onboarding row, generate kb quality gate, list kb sources, mark onboarding completed, mark step completed, mark step skipped, pause onboarding, update agent identity, update current step |
| skills | create skill, publish skill, toggle skill enabled, update skill |
| team | assign skill to agent, bulk invite teammates, invite teammate, remove member, remove skill from agent, resend invitation, revoke invitation, revoke team member sessions |
| triggers | create trigger, delete trigger, set trigger status |
| visitors | delete visitor memory |
| voice | add phone number, attach pathway to number, clone voice for number, configure number webhooks, create ivr menu, create pathway, create pathway from template, create persona, delete pathway, delete persona, enroll voice caller pin, list twilio account numbers, remove phone number, remove voice caller pin, set ivr menu live, set pathway enabled, set voice pin verification, update pathway graph, update persona, update phone number, update phone number stt language, update voice persona |
An agent can also
| Area | Actions |
|---|---|
| conversations | accept copilot draft, add conversation note, assign tag, bulk add tag, bulk assign, bulk resolve, bulk set priority, compose outbound, create org tag, create whisper, delete conversation note, delete org tag, dismiss failed delivery, edit and send copilot draft, get conversation tags, list org tags, mark answer wrong, pause conversation sla, reassign conversation, reclassify conversation, reject copilot draft, release conversation, reopen conversation, resend failed delivery, resolve conversation, resume conversation sla, retry agent reply delivery, send agent reply, set conversation copilot mode, snooze conversation, suggest replies, suggest reply, take over conversation, toggle starred, transfer conversation, unassign tag, unsnooze conversation, upload agent attachment |
| customers | merge visitor profiles, update visitor notes, upsert visitor profile |
| Dashboard | dismiss onboarding checklist |
| inbox | claim conversation, mark resolved, release conversation, set priority |
| knowledge | dismiss kb feedback finding, generate draft from gap |
| Other | add annotation |
| quality | claim quality review, mark score reviewed, resolve quality review |
| Settings: canned-responses | create canned response, delete canned response, update canned response |
| Settings: custom-fields | update conversation custom fields |
| visitors | add visitor note, delete visitor note |
Any signed-in member can
| Area | Actions |
|---|---|
| conversations | clear agent typing, clear composing, create saved view, delete saved view, file dispute action, get saved views, mark conversation read, set agent typing, set composing |
| notifications | mark all notifications read, mark notification read |
| Other | ask analytics, clear sample explore, send heartbeat, set presence status |
| report-problem | submit support report |
| Settings: notifications | save push preferences, update email frequency, update email pref |
| Settings: profileActions.ts | update agent phone |
| Settings: security | assert mfa enrollment allowed, generate mfa recovery codes, log mfa enrollment, remove mfa factor |
| Settings: sessions | revoke session, sign out all sessions |
| Settings: signatureActions.ts | save email signature |
| workspace | switch workspace |
In the product: /dashboard/settings/roles (sign-in required).