# CallVA

> CallVA is an operations platform for AI voice agents: queues, data models, outcomes, recordings, transcripts and analytics around every call, reachable by API, MCP and CLI.

- [Introduction](https://docs.callva.io/introduction.md): CallVA is an operations platform for AI voice agents. Reach it from your own system over the API, from an AI agent over MCP, or from a terminal with the CLI.
- [Quickstart](https://docs.callva.io/quickstart.md): Create an API token, talk to your voice agent in the browser, and read the call back over the API.
- [Authentication and permissions](https://docs.callva.io/authentication.md): How API tokens work, organization-wide and project tokens, roles and permissions, why a request is refused, and how to give each integration only what it needs.
- [Connect an AI agent over MCP](https://docs.callva.io/mcp.md): Connect Claude, ChatGPT, Cursor or any MCP client to one CallVA project over OAuth, with no API key to copy.
- [The callva CLI](https://docs.callva.io/cli.md): Operate CallVA from a shell: one command per External API operation, JSON in and out, built for AI agents and scripts.
- [Calls and outbound dispatch](https://docs.callva.io/guides/calls.md): The call record, how to list, filter, aggregate and change calls, and how POST /call places an outbound call and what happens after it.
- [Custom fields](https://docs.callva.io/guides/custom-fields.md): Define your project's data model: field types, behaviour flags, groups, validation of call values, the extraction schema, and safe deletion.
- [Webhooks](https://docs.callva.io/guides/webhooks.md): Receive a call's lifecycle events at your own URL, call any URL on a rule-driven schedule, and read the log of every request a call's processing went through.
- [Automations](https://docs.callva.io/guides/automations.md): Run your own scripts inside CallVA - on a call's events, on a schedule, over HTTP or on demand - with project variables and secrets, run history and logs, and runs traced back to the call they handled.
- [API reference](https://docs.callva.io/api-reference/introduction.md): Base URL, authentication, the playground, project selection, the response envelope, pagination and errors of the CallVA External API.
- [List a call's actions](https://docs.callva.io/api-reference/actions/list-a-calls-actions.md): Requires permission: `actions.execute`.
- [Run a record action](https://docs.callva.io/api-reference/actions/run-a-record-action.md): Requires permission: `actions.execute`.
- [List a call's action runs](https://docs.callva.io/api-reference/actions/list-a-calls-action-runs.md): Requires permission: `actions.read`.
- [List actions](https://docs.callva.io/api-reference/actions/list-actions.md): Requires permission: `actions.read`.
- [Create an action](https://docs.callva.io/api-reference/actions/create-an-action.md): Requires permission: `actions.create`.
- [Get an action](https://docs.callva.io/api-reference/actions/get-an-action.md): Requires permission: `actions.read`.
- [Delete an action](https://docs.callva.io/api-reference/actions/delete-an-action.md): Requires permission: `actions.delete`.
- [Update an action](https://docs.callva.io/api-reference/actions/update-an-action.md): Requires permission: `actions.update`.
- [List an agent's tools](https://docs.callva.io/api-reference/agent-tools/list-an-agents-tools.md): Requires permission: `agents.read`.
- [Get an agent's tool](https://docs.callva.io/api-reference/agent-tools/get-an-agents-tool.md): Requires permission: `agents.read`.
- [Replace an agent's tool](https://docs.callva.io/api-reference/agent-tools/replace-an-agents-tool.md): Requires permission: `agents.update`.
- [Delete an agent's tool](https://docs.callva.io/api-reference/agent-tools/delete-an-agents-tool.md): Requires permission: `agents.update`.
- [Update an agent's tool](https://docs.callva.io/api-reference/agent-tools/update-an-agents-tool.md): Requires permission: `agents.update`.
- [List agents](https://docs.callva.io/api-reference/agents/list-agents.md): Requires permission: `agents.read`.
- [Create an agent](https://docs.callva.io/api-reference/agents/create-an-agent.md): Requires permission: `agents.create`.
- [Get the default agent](https://docs.callva.io/api-reference/agents/get-the-default-agent.md): Requires permission: `agents.read`.
- [Get an agent](https://docs.callva.io/api-reference/agents/get-an-agent.md): Requires permission: `agents.read`.
- [Delete an agent](https://docs.callva.io/api-reference/agents/delete-an-agent.md): Requires permission: `agents.delete`.
- [Update an agent](https://docs.callva.io/api-reference/agents/update-an-agent.md): Requires permission: `agents.update`.
- [Clone an agent](https://docs.callva.io/api-reference/agents/clone-an-agent.md): Requires permission: `agents.create`.
- [List assets](https://docs.callva.io/api-reference/assets/list-assets.md): Requires permission: `assets.read`.
- [Create an asset](https://docs.callva.io/api-reference/assets/create-an-asset.md): Requires permission: `assets.create`.
- [Get an asset](https://docs.callva.io/api-reference/assets/get-an-asset.md): Requires permission: `assets.read`.
- [Delete an asset](https://docs.callva.io/api-reference/assets/delete-an-asset.md): Requires permission: `assets.delete`.
- [Update an asset](https://docs.callva.io/api-reference/assets/update-an-asset.md): Requires permission: `assets.update`.
- [List automation triggers](https://docs.callva.io/api-reference/automation-triggers/list-automation-triggers.md): Requires permission: `automations.manage`.
- [Create an automation trigger](https://docs.callva.io/api-reference/automation-triggers/create-an-automation-trigger.md): Requires permission: `automations.manage`.
- [Update an automation trigger](https://docs.callva.io/api-reference/automation-triggers/update-an-automation-trigger.md): Requires permission: `automations.update`.
- [Delete an automation trigger](https://docs.callva.io/api-reference/automation-triggers/delete-an-automation-trigger.md): Requires permission: `automations.delete`.
- [Toggle an automation trigger](https://docs.callva.io/api-reference/automation-triggers/toggle-an-automation-trigger.md): Requires permission: `automations.manage`.
- [List a call's automation runs](https://docs.callva.io/api-reference/automations/list-a-calls-automation-runs.md): Requires permission: `automations.read`.
- [Get the automation runtime](https://docs.callva.io/api-reference/automations/get-the-automation-runtime.md): Requires permission: `automations.read`.
- [List all automation runs](https://docs.callva.io/api-reference/automations/list-all-automation-runs.md): Requires permission: `automations.read`.
- [List automations](https://docs.callva.io/api-reference/automations/list-automations.md): Requires permission: `automations.read`.
- [Create an automation](https://docs.callva.io/api-reference/automations/create-an-automation.md): Requires permission: `automations.create`.
- [Get an automation](https://docs.callva.io/api-reference/automations/get-an-automation.md): Requires permission: `automations.read`.
- [Update an automation](https://docs.callva.io/api-reference/automations/update-an-automation.md): Requires permission: `automations.update`.
- [Delete an automation](https://docs.callva.io/api-reference/automations/delete-an-automation.md): Requires permission: `automations.delete`.
- [Get an automation's code](https://docs.callva.io/api-reference/automations/get-an-automations-code.md): Requires permission: `automations.read`.
- [Replace an automation's code](https://docs.callva.io/api-reference/automations/replace-an-automations-code.md): Requires permission: `automations.update`.
- [Run an automation](https://docs.callva.io/api-reference/automations/run-an-automation.md): Requires permission: `automations.manage`.
- [List an automation's runs](https://docs.callva.io/api-reference/automations/list-an-automations-runs.md): Requires permission: `automations.read`.
- [Get an automation run](https://docs.callva.io/api-reference/automations/get-an-automation-run.md): Requires permission: `automations.read`.
- [Aggregate calls](https://docs.callva.io/api-reference/calls/aggregate-calls.md): Requires permission: `calls.read`.
- [Get call trends](https://docs.callva.io/api-reference/calls/get-call-trends.md): Requires permission: `calls.read`.
- [Update calls in bulk](https://docs.callva.io/api-reference/calls/update-calls-in-bulk.md): Requires permission: `calls.update`.
- [List calls](https://docs.callva.io/api-reference/calls/list-calls.md): Requires permission: `calls.read`.
- [Create a call](https://docs.callva.io/api-reference/calls/create-a-call.md): Requires permission: `calls.create`.
- [Get a call](https://docs.callva.io/api-reference/calls/get-a-call.md): Requires permission: `calls.read`.
- [Update a call](https://docs.callva.io/api-reference/calls/update-a-call.md): Requires permission: `calls.update`.
- [Delete a call](https://docs.callva.io/api-reference/calls/delete-a-call.md): Requires permission: `calls.delete`.
- [List custom field groups](https://docs.callva.io/api-reference/custom-field-groups/list-custom-field-groups.md): Requires permission: any one of `calls.read`, `fields.create`, `fields.update`, `fields.delete`, `field_groups.create`, `field_groups.update`, `field_groups.delete`. The answer carries field definitions only, never call data.
- [Create a custom field group](https://docs.callva.io/api-reference/custom-field-groups/create-a-custom-field-group.md): Requires permission: `field_groups.create`.
- [Delete a custom field group](https://docs.callva.io/api-reference/custom-field-groups/delete-a-custom-field-group.md): Requires permission: `field_groups.delete`.
- [Update a custom field group](https://docs.callva.io/api-reference/custom-field-groups/update-a-custom-field-group.md): Requires permission: `field_groups.update`.
- [Reorder custom field groups](https://docs.callva.io/api-reference/custom-field-groups/reorder-custom-field-groups.md): Requires permission: `field_groups.update`.
- [Add a field to a group](https://docs.callva.io/api-reference/custom-field-groups/add-a-field-to-a-group.md): Requires permission: `field_groups.update`.
- [Remove a field from a group](https://docs.callva.io/api-reference/custom-field-groups/remove-a-field-from-a-group.md): Requires permission: `field_groups.update`.
- [Update a field's group settings](https://docs.callva.io/api-reference/custom-field-groups/update-a-fields-group-settings.md): Requires permission: `field_groups.update`.
- [Reorder a group's fields](https://docs.callva.io/api-reference/custom-field-groups/reorder-a-groups-fields.md): Requires permission: `field_groups.update`.
- [Get the extraction schema](https://docs.callva.io/api-reference/custom-fields/get-the-extraction-schema.md): Requires permission: any one of `calls.read`, `fields.create`, `fields.update`, `fields.delete`, `field_groups.create`, `field_groups.update`, `field_groups.delete`. The answer carries field definitions only, never call data.
- [Get a field's deletion impact](https://docs.callva.io/api-reference/custom-fields/get-a-fields-deletion-impact.md): Requires permission: any one of `calls.read`, `fields.create`, `fields.update`, `fields.delete`, `field_groups.create`, `field_groups.update`, `field_groups.delete`. The answer carries field definitions only, never call data.
- [List custom fields](https://docs.callva.io/api-reference/custom-fields/list-custom-fields.md): Requires permission: any one of `calls.read`, `fields.create`, `fields.update`, `fields.delete`, `field_groups.create`, `field_groups.update`, `field_groups.delete`. The answer carries field definitions only, never call data.
- [Create a custom field](https://docs.callva.io/api-reference/custom-fields/create-a-custom-field.md): Requires permission: `fields.create`.
- [Update a custom field](https://docs.callva.io/api-reference/custom-fields/update-a-custom-field.md): Requires permission: `fields.update`.
- [Delete a custom field](https://docs.callva.io/api-reference/custom-fields/delete-a-custom-field.md): Requires permission: `fields.delete`.
- [List issues](https://docs.callva.io/api-reference/issues/list-issues.md): Requires permission: `issues.read`.
- [Create an issue](https://docs.callva.io/api-reference/issues/create-an-issue.md): Requires permission: `issues.create`.
- [Get an issue](https://docs.callva.io/api-reference/issues/get-an-issue.md): Requires permission: `issues.read`.
- [Delete an issue](https://docs.callva.io/api-reference/issues/delete-an-issue.md): Requires permission: `issues.delete`.
- [Update an issue](https://docs.callva.io/api-reference/issues/update-an-issue.md): Requires permission: `issues.update`.
- [List knowledge items](https://docs.callva.io/api-reference/knowledge/list-knowledge-items.md): Requires permission: `knowledge.read`.
- [Create a knowledge item](https://docs.callva.io/api-reference/knowledge/create-a-knowledge-item.md): Requires permission: `knowledge.create`.
- [Get a knowledge item](https://docs.callva.io/api-reference/knowledge/get-a-knowledge-item.md): Requires permission: `knowledge.read`.
- [Delete a knowledge item](https://docs.callva.io/api-reference/knowledge/delete-a-knowledge-item.md): Requires permission: `knowledge.delete`.
- [Update a knowledge item](https://docs.callva.io/api-reference/knowledge/update-a-knowledge-item.md): Requires permission: `knowledge.update`.
- [Place an outbound call](https://docs.callva.io/api-reference/outbound-calls/place-an-outbound-call.md): Requires permission: `outbound_calls.create`.
- [List phone numbers](https://docs.callva.io/api-reference/phone-numbers/list-phone-numbers.md): Requires permission: `phone_numbers.read`.
- [Create a phone number](https://docs.callva.io/api-reference/phone-numbers/create-a-phone-number.md): Requires permission: `phone_numbers.create`.
- [Get a phone number](https://docs.callva.io/api-reference/phone-numbers/get-a-phone-number.md): Requires permission: `phone_numbers.read`.
- [Delete a phone number](https://docs.callva.io/api-reference/phone-numbers/delete-a-phone-number.md): Requires permission: `phone_numbers.delete`.
- [Update a phone number](https://docs.callva.io/api-reference/phone-numbers/update-a-phone-number.md): Requires permission: `phone_numbers.update`.
- [Assign an agent to a number](https://docs.callva.io/api-reference/phone-numbers/assign-an-agent-to-a-number.md): Requires permission: `phone_numbers.update`.
- [List phone provider types](https://docs.callva.io/api-reference/phone-providers/list-phone-provider-types.md): Requires permission: `providers.read`.
- [List phone providers](https://docs.callva.io/api-reference/phone-providers/list-phone-providers.md): Requires permission: `providers.read`.
- [List the preset catalogue](https://docs.callva.io/api-reference/presets/list-the-preset-catalogue.md): Requires permission: `dashboard.read`.
- [List an agent's presets](https://docs.callva.io/api-reference/presets/list-an-agents-presets.md): Requires permission: `agents.read`.
- [Get an agent's preset](https://docs.callva.io/api-reference/presets/get-an-agents-preset.md): Requires permission: `agents.read`.
- [Replace an agent's preset](https://docs.callva.io/api-reference/presets/replace-an-agents-preset.md): Requires permission: `agents.update`.
- [Update an agent's preset](https://docs.callva.io/api-reference/presets/update-an-agents-preset.md): Requires permission: `agents.update`.
- [Activate an agent's preset](https://docs.callva.io/api-reference/presets/activate-an-agents-preset.md): Requires permission: `agents.update`.
- [List project settings](https://docs.callva.io/api-reference/project-settings/list-project-settings.md): Requires permission: `settings.read`.
- [Reveal a project setting](https://docs.callva.io/api-reference/project-settings/reveal-a-project-setting.md): Requires permission: `project_secrets.read`.
- [Rotate the webhook signing secret](https://docs.callva.io/api-reference/project-settings/rotate-the-webhook-signing-secret.md): Requires permission: `settings.update`.
- [List projects](https://docs.callva.io/api-reference/projects/list-projects.md): Requires permission: none beyond reaching the project. A token answers only for the projects its role reaches.
- [Create a project](https://docs.callva.io/api-reference/projects/create-a-project.md): Requires permission: `projects.create`.
- [Get a project](https://docs.callva.io/api-reference/projects/get-a-project.md): Requires permission: none beyond reaching the project. A token answers only for the projects its role reaches.
- [Delete a project](https://docs.callva.io/api-reference/projects/delete-a-project.md): Requires permission: `projects.delete`.
- [Update a project](https://docs.callva.io/api-reference/projects/update-a-project.md): Requires permission: `projects.update`.
- [Stream a call's recording](https://docs.callva.io/api-reference/recordings/stream-a-calls-recording.md): Requires permission: `recordings.read`.
- [Purge a recording's cache](https://docs.callva.io/api-reference/recordings/purge-a-recordings-cache.md): Requires permission: `recordings.delete`.
- [List saved views](https://docs.callva.io/api-reference/saved-views/list-saved-views.md): Requires permission: `dashboard.read`.
- [Create a saved view](https://docs.callva.io/api-reference/saved-views/create-a-saved-view.md): Requires permission: `shared_views.manage`.
- [Get a saved view](https://docs.callva.io/api-reference/saved-views/get-a-saved-view.md): Requires permission: `dashboard.read`.
- [Delete a saved view](https://docs.callva.io/api-reference/saved-views/delete-a-saved-view.md): Requires permission: `shared_views.manage`.
- [Update a saved view](https://docs.callva.io/api-reference/saved-views/update-a-saved-view.md): Requires permission: `shared_views.manage`.
- [Set the default saved view](https://docs.callva.io/api-reference/saved-views/set-the-default-saved-view.md): Requires permission: `shared_views.manage`.
- [Get a call's transcript](https://docs.callva.io/api-reference/transcripts/get-a-calls-transcript.md): Requires permission: `transcripts.read`.
- [Replace a call's transcript](https://docs.callva.io/api-reference/transcripts/replace-a-calls-transcript.md): Requires permission: `transcripts.update`.
- [Save a call's transcript](https://docs.callva.io/api-reference/transcripts/save-a-calls-transcript.md): Requires permission: `transcripts.create`.
- [Delete a call's transcript](https://docs.callva.io/api-reference/transcripts/delete-a-calls-transcript.md): Requires permission: `transcripts.delete`.
- [Get a transcript download link](https://docs.callva.io/api-reference/transcripts/get-a-transcript-download-link.md): Requires permission: `transcripts.read`.
- [List variables](https://docs.callva.io/api-reference/variables/list-variables.md): Requires permission: `variables.read`.
- [Create a variable](https://docs.callva.io/api-reference/variables/create-a-variable.md): Requires permission: `variables.create`.
- [Delete a variable](https://docs.callva.io/api-reference/variables/delete-a-variable.md): Requires permission: `variables.delete`.
- [Update a variable](https://docs.callva.io/api-reference/variables/update-a-variable.md): Requires permission: `variables.update`.
- [List a call's webhook logs](https://docs.callva.io/api-reference/webhook-logs/list-a-calls-webhook-logs.md): Requires permission: `webhook_logs.read`.
- [List webhook logs](https://docs.callva.io/api-reference/webhook-logs/list-webhook-logs.md): Requires permission: `webhook_logs.read`.
- [List webhook log filters](https://docs.callva.io/api-reference/webhook-logs/list-webhook-log-filters.md): Requires permission: `webhook_logs.read`.
- [Get a webhook log](https://docs.callva.io/api-reference/webhook-logs/get-a-webhook-log.md): Requires permission: `webhook_logs.read`.
- [List webhook schedules](https://docs.callva.io/api-reference/webhook-schedules/list-webhook-schedules.md): Requires permission: `schedules.read`.
- [Create a webhook schedule](https://docs.callva.io/api-reference/webhook-schedules/create-a-webhook-schedule.md): Requires permission: `schedules.create`.
- [Get a webhook schedule](https://docs.callva.io/api-reference/webhook-schedules/get-a-webhook-schedule.md): Requires permission: `schedules.read`.
- [Update a webhook schedule](https://docs.callva.io/api-reference/webhook-schedules/update-a-webhook-schedule.md): Requires permission: `schedules.update`.
- [Delete a webhook schedule](https://docs.callva.io/api-reference/webhook-schedules/delete-a-webhook-schedule.md): Requires permission: `schedules.delete`.
- [Preview a webhook schedule](https://docs.callva.io/api-reference/webhook-schedules/preview-a-webhook-schedule.md): Requires permission: `schedules.read`.
- [List a schedule's executions](https://docs.callva.io/api-reference/webhook-schedules/list-a-schedules-executions.md): Requires permission: `schedules.read`.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.