agents:create | Create agents |
agents:read | List and get agents |
agents:update | Update or deactivate agents |
tools:create | Create tools |
tools:read | List and get tools |
tools:update | Attach, detach, or modify tools |
phone_numbers:search | Search and list phone numbers |
phone_numbers:purchase | Purchase phone numbers |
phone_numbers:configure | Assign agents to phone numbers |
billing:read | View billing status |
billing:manage | Setup payment method and top up |
calls:create | Place outbound calls |
calls:read | List and get call history |
shared_links:read | List and get shared links |
shared_links:manage | Create and revoke shared links |
flows:read | List flow versions for an agent |
flows:test | Run the hermetic flow simulator (POST /agents/:id/flow/test). Separate from agents:update because flow tests can spend money on eval LLMs and external API calls. |
integrations:read | List third-party integrations connected to your company |
integrations:manage | Disconnect (revoke) existing integrations. The public API does not connect new integrations — that happens via the dashboard OAuth flow. |
do_not_call:read | List and look up Do-Not-Call entries |
do_not_call:manage | Add, update, and remove Do-Not-Call entries |
dispositions:read | List and get call dispositions |
dispositions:manage | Create, update, and delete call dispositions |
leads:read | List and get leads |
leads:manage | Create, update, and delete leads |
lead_tags:read | List and get lead tags |
lead_tags:manage | Create, update, and delete lead tags |
campaigns:read | List and get campaigns, their stats, and their enrolled contacts |
campaigns:manage | Create, update, and archive campaigns, enroll or exclude contacts, and launch/pause/resume/stop them |
affiliates:read | Read your own affiliate commission stats and sub-affiliates. Always scoped to the key’s own workspace — it never grants access to another company’s figures. Keys issued before this scope existed do not hold it; create a new key to use the affiliate endpoints. |
agent_eval:read | List and get eval personas, cases, suites, runs, turns, and evaluations |
agent_eval:create | Create eval personas, cases, and suites |
agent_eval:update | Update eval personas, cases, and suites |
agent_eval:delete | Soft-delete eval personas, cases, and suites |
agent_eval:run | Start case and suite runs, and cancel a running eval. Separate from agent_eval:create because runs are billed against your credit balance. |