{
"success": false,
"message": "This API token is tenant-scoped. Please provide project_id in the request payload or query parameters, or use a project-scoped token.",
"code": "PROJECT_REQUIRED"
}
{
"error": "Invalid or expired token",
"message": "The provided token is invalid or has expired"
}
{
"success": false,
"message": "This API token is tenant-scoped. Please provide project_id in the request payload or query parameters, or use a project-scoped token.",
"code": "PROJECT_REQUIRED"
}
{
"error": "Invalid or expired token",
"message": "The provided token is invalid or has expired"
}
A CallVA API token, sent as Authorization: Bearer <token>.
Creating one. In the CallVA dashboard, open the organization's Settings, then API Keys, and choose Create API Key: give the key a name, choose its role, and choose its project scope - All projects for an organization-wide token, or one project for a project token. The key is shown once, when it is created, and cannot be read again; store it then. Creating keys needs the api_tokens.create permission, which owners and admins hold, and a key cannot create another key.
Organization-wide or project token. A project token works in the one project it was created for; any project named in the request is ignored. An organization-wide token reaches the projects of its organization, and each request names its project with the X-Project-ID header or project_id (query string for reads and deletes, body for writes).
What it can call. The token's role decides which endpoints it may call; each endpoint names the permission it requires, and a token whose role lacks it is answered 403.
The project this request acts in. Required with an organization-wide token (or send project_id instead); ignored with a project token, which always acts in its own project.
Body
application/json
The call's field values, keyed by field key. The keys and the type each takes are the project's data model, listed by GET /custom-fields; a key outside it, or a value of the wrong type, answers 422.
A call record. Besides its identity, it carries every field of the project's data model at the top level, keyed by field key, with the value typed as the field is (GET /custom-fields lists them); dates and times are ISO 8601 in UTC.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"CallVA","description":"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.","colors":{"primary":"#2563EB","light":"#60A5FA","dark":"#1D4ED8"},"logo":{"light":"https://mintcdn.com/call-va/JVDhnfnOC_cj2yK9/logo/light.svg?fit=max\u0026auto=format\u0026n=JVDhnfnOC_cj2yK9\u0026q=85\u0026s=54be2b6b3422833c0be254822800787d","dark":"https://mintcdn.com/call-va/JVDhnfnOC_cj2yK9/logo/dark.svg?fit=max\u0026auto=format\u0026n=JVDhnfnOC_cj2yK9\u0026q=85\u0026s=65a8cbd3efaf926082e5310bab80062d","href":"/introduction"},"favicon":"https://mintcdn.com/call-va/JVDhnfnOC_cj2yK9/favicon.svg?fit=max\u0026auto=format\u0026n=JVDhnfnOC_cj2yK9\u0026q=85\u0026s=978d59692ec2c0c4bd751fd8442527d8","api":{"playground":{"display":"interactive","proxy":false},"examples":{"languages":["curl","python","javascript"]}},"appearance":{"default":"system"},"navbar":{"links":[{"href":"https://app.callva.io","label":"Dashboard"}],"primary":{"type":"button","label":"Get an API token","href":"/quickstart"}},"footer":{"socials":{"website":"https://callva.io"}},"icons":{"library":"lucide"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"call-va","hasAudioNarration":false,"actualSubdomain":"call-va","customDomains":["docs.callva.io"],"gitSource":{"type":"github","owner":"callva-io","repo":"callva-new","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":"","_id":"6af3b530f75528b5276fc235"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af3dd3cf673501ce2bd9797","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"API Reference","count":128},{"language":"default","tag":"Automations","count":13},{"language":"default","tag":"Documentation","count":9},{"language":"default","tag":"Custom field groups","count":9},{"language":"default","tag":"Actions","count":8},{"language":"default","tag":"Calls","count":8},{"language":"default","tag":"Agents","count":7},{"language":"default","tag":"Webhook schedules","count":7},{"language":"default","tag":"Custom fields","count":6},{"language":"default","tag":"Phone numbers","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/calls/create-a-call","slug":"/api-reference/calls/create-a-call","pageMetadata":{"title":"Create a call","description":"Requires permission: `calls.create`.\n\nWhat a token may call depends on its role: see [Authentication and permissions](/authentication). Guide: [Calls and outbound dispatch](/guides/calls).","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /calls","href":"/api-reference/calls/create-a-call","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Requires permission: \", _jsx(_components.code, {\n children: \"calls.create\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"What a token may call depends on its role: see \", _jsx(_components.a, {\n href: \"/authentication\",\n children: \"Authentication and permissions\"\n }), \". Guide: \", _jsx(_components.a, {\n href: \"/guides/calls\",\n children: \"Calls and outbound dispatch\"\n }), \".\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a call","description":"Requires permission: `calls.create`.\n\nWhat a token may call depends on its role: see [Authentication and permissions](/authentication). Guide: [Calls and outbound dispatch](/guides/calls).","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /calls","href":"/api-reference/calls/create-a-call","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"calls.store","description":"Requires permission: `calls.create`.\n\nWhat a token may call depends on its role: see [Authentication and permissions](/authentication). Guide: [Calls and outbound dispatch](/guides/calls).","summary":"Create a call","tags":["Calls"],"parameters":["a00df8a5-ca6f-438c-bef6-6d01610fa882"],"requestBody":"54b6dd80-b334-471e-a842-1bbf3ff1438a","responses":{"201":"47d8b8aa-9492-4fd9-9881-275e1fb36559","400":"b9ff0823-5e74-48d8-bf5c-baa61489d1bc","401":"5c8da040-7b03-4351-b6a5-1c00b7ca2afa","403":"48defaa5-6664-4dcd-9d35-01f742467197","422":"438d5c74-6af3-4313-adb4-44177fcb263c","500":"0f545fa8-6849-4b71-b6bc-ec1427441e78"},"x-permission":"calls.create","method":"post","type":"path","servers":["3975e912-c006-431b-bcbd-5666032bcaec","be9bf2fb-2313-465b-bfea-88d55c4cebba","19512535-2ca6-49f7-8ce4-dc53100548f4"],"security":["0b2ec7b0-3c6f-4fff-bcce-c9eb234ba891"],"path":"/calls","baseUrlOptions":["https://api.callva.io/api/v1/external","https://staging.api.callva.io/api/v1/external","https://api.dev.callva.io/api/v1/external"],"title":"Create a call","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"a00df8a5-ca6f-438c-bef6-6d01610fa882":{"name":"X-Project-ID","in":"header","description":"The project this request acts in. Required with an organization-wide token (or send `project_id` instead); ignored with a project token, which always acts in its own project.","schema":{"type":"string","format":"uuid","description":"The project this request acts in. Required with an organization-wide token (or send `project_id` instead); ignored with a project token, which always acts in its own project.","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"description":"The call's field values, keyed by field key. The keys and the type each takes are the project's data model, listed by `GET /custom-fields`; a key outside it, or a value of the wrong type, answers 422.","content":{"application/json":{"schema":{"type":"object","examples":[{"status":"completed","appointment_confirmed":true}],"additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalProperties","typeLabel":"any"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"completed","appointment_confirmed":true}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"47d8b8aa-9492-4fd9-9881-275e1fb36559":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","const":"Call created successfully","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"data":{"type":"object","description":"A call record. Besides its identity, it carries every field of the project's data model at the top level, keyed by field key, with the value typed as the field is (`GET /custom-fields` lists them); dates and times are ISO 8601 in UTC.","properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"data.id","typeLabel":"string\u003cuuid>"},"tenant_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"data.tenant_id","typeLabel":"string\u003cuuid>"},"project_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"data.project_id","typeLabel":"string\u003cuuid>"},"created_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.created_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"data.created_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time> | null"},"updated_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.updated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"data.updated_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.updated_at","typeLabel":"string\u003cdate-time> | null"}},"required":["id","tenant_id","project_id","created_at","updated_at"],"additionalProperties":{"oneOf":[{}],"uniqueKey":"data.additionalProperties","typeLabel":"any"},"title":"CallResource","isRequired":true,"uniqueKey":"data","typeLabel":"CallResource · object"}},"required":["success","message","data"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"message":"Call created successfully","data":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","tenant_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","project_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"b9ff0823-5e74-48d8-bf5c-baa61489d1bc":{"description":"An organization-wide token named no project.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","examples":[false],"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","examples":["This API token is tenant-scoped. Please provide project_id in the request payload or query parameters, or use a project-scoped token."],"isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","examples":["PROJECT_REQUIRED"],"isRequired":true,"uniqueKey":"code","typeLabel":"string"}},"required":["success","message","code"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"message":"This API token is tenant-scoped. Please provide project_id in the request payload or query parameters, or use a project-scoped token.","code":"PROJECT_REQUIRED"}}},"exampleType":"generated"}},"exampleType":"generated"},"5c8da040-7b03-4351-b6a5-1c00b7ca2afa":{"description":"The bearer token is missing, invalid, revoked or expired.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","examples":["Invalid or expired token"],"isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","examples":["The provided token is invalid or has expired"],"isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Invalid or expired token","message":"The provided token is invalid or has expired"}}},"exampleType":"generated"}},"exampleType":"generated"},"48defaa5-6664-4dcd-9d35-01f742467197":{"description":"The token's role does not hold the permission this endpoint requires.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","examples":[false],"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","examples":["Insufficient permission."],"isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","examples":["insufficient_permission"],"isRequired":true,"uniqueKey":"code","typeLabel":"string"}},"required":["success","message","code"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"message":"Insufficient permission.","code":"insufficient_permission"}}},"exampleType":"generated"}},"exampleType":"generated"},"438d5c74-6af3-4313-adb4-44177fcb263c":{"description":"Validation error","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["success","message"],"properties":{"success":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.0.success","typeLabel":"boolean"},"message":{"type":"string","const":"Validation failed","isRequired":true,"uniqueKey":"oneOf.0.message","typeLabel":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"oneOf.0.errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"oneOf.0.errors.additionalProperties","typeLabel":"string[]"},"uniqueKey":"oneOf.0.errors","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["message","errors"],"properties":{"message":{"type":"string","description":"Errors overview.","isRequired":true,"uniqueKey":"oneOf.1.message","typeLabel":"string"},"errors":{"type":"object","description":"A detailed description of each field that failed validation.","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"oneOf.1.errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"oneOf.1.errors.additionalProperties","typeLabel":"string[]"},"isRequired":true,"uniqueKey":"oneOf.1.errors","typeLabel":"object"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"message":"Validation failed","errors":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"0f545fa8-6849-4b71-b6bc-ec1427441e78":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["success","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"0b2ec7b0-3c6f-4fff-bcce-c9eb234ba891":{"bearerAuth":{"type":"http","description":"A CallVA API token, sent as `Authorization: Bearer \u003ctoken>`.\n\n**Creating one.** In the CallVA dashboard, open the organization's Settings, then API Keys, and choose Create API Key: give the key a name, choose its role, and choose its project scope - All projects for an organization-wide token, or one project for a project token. The key is shown once, when it is created, and cannot be read again; store it then. Creating keys needs the `api_tokens.create` permission, which owners and admins hold, and a key cannot create another key.\n\n**Organization-wide or project token.** A project token works in the one project it was created for; any project named in the request is ignored. An organization-wide token reaches the projects of its organization, and each request names its project with the `X-Project-ID` header or `project_id` (query string for reads and deletes, body for writes).\n\n**What it can call.** The token's role decides which endpoints it may call; each endpoint names the permission it requires, and a token whose role lacks it is answered `403`.","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"3975e912-c006-431b-bcbd-5666032bcaec":{"url":"https://api.callva.io/api/v1/external","description":"Production"},"be9bf2fb-2313-465b-bfea-88d55c4cebba":{"url":"https://staging.api.callva.io/api/v1/external","description":"Staging"},"19512535-2ca6-49f7-8ce4-dc53100548f4":{"url":"https://api.dev.callva.io/api/v1/external","description":"Development"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","description":"A CallVA API token, sent as `Authorization: Bearer \u003ctoken>`.\n\n**Creating one.** In the CallVA dashboard, open the organization's Settings, then API Keys, and choose Create API Key: give the key a name, choose its role, and choose its project scope - All projects for an organization-wide token, or one project for a project token. The key is shown once, when it is created, and cannot be read again; store it then. Creating keys needs the `api_tokens.create` permission, which owners and admins hold, and a key cannot create another key.\n\n**Organization-wide or project token.** A project token works in the one project it was created for; any project named in the request is ignored. An organization-wide token reaches the projects of its organization, and each request names its project with the `X-Project-ID` header or `project_id` (query string for reads and deletes, body for writes).\n\n**What it can call.** The token's role decides which endpoints it may call; each endpoint names the permission it requires, and a token whose role lacks it is answered `403`.","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"A CallVA API token, sent as `Authorization: Bearer \u003ctoken>`.\n\n**Creating one.** In the CallVA dashboard, open the organization's Settings, then API Keys, and choose Create API Key: give the key a name, choose its role, and choose its project scope - All projects for an organization-wide token, or one project for a project token. The key is shown once, when it is created, and cannot be read again; store it then. Creating keys needs the `api_tokens.create` permission, which owners and admins hold, and a key cannot create another key.\n\n**Organization-wide or project token.** A project token works in the one project it was created for; any project named in the request is ignored. An organization-wide token reaches the projects of its organization, and each request names its project with the `X-Project-ID` header or `project_id` (query string for reads and deletes, body for writes).\n\n**What it can call.** The token's role decides which endpoints it may call; each endpoint names the permission it requires, and a token whose role lacks it is answered `403`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"call-va","siteName":"CallVA","title":"Create a call - CallVA","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-11T02:46:36.893Z","originalFileLocation":"api-reference/calls/create-a-call.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Requires permission: calls.create. What a token may call depends on its role: see Authentication and permissions. Guide: Calls and outbound dispatch.\">\u003cmeta data-mint-head name=\"application-name\" content=\"CallVA\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/call-va/OocbCK5JGH14FXOT/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/call-va/OocbCK5JGH14FXOT/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/call-va/OocbCK5JGH14FXOT/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/call-va/OocbCK5JGH14FXOT/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/call-va/OocbCK5JGH14FXOT/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/call-va/OocbCK5JGH14FXOT/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/call-va/OocbCK5JGH14FXOT/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/call-va/OocbCK5JGH14FXOT/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/call-va/OocbCK5JGH14FXOT/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a call - CallVA\">\u003cmeta data-mint-head property=\"og:description\" content=\"Requires permission: calls.create. What a token may call depends on its role: see Authentication and permissions. Guide: Calls and outbound dispatch.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"CallVA\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.callva.io/api-reference/calls/create-a-call\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://call-va.mintlify.site/_mintlify/api/og/v2?division=Calls\u0026amp;title=Create+a+call\u0026amp;description=Requires+permission%3A+%60calls.create%60.%0A%0AWhat+a+token+may+call+depends+on+its+role%3A+see+%5BAuthentication+and+permissions%5D%28%2Fauthentication%29.+Guide%3A+%5BCalls+and+outbou\u0026amp;theme=848dcf36653d057026529a79\u0026amp;signature=67e922004e164d82b0c63b564d6998b98d6865e601051d882b08ce79f6725be4\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a call - CallVA\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Requires permission: calls.create. What a token may call depends on its role: see Authentication and permissions. Guide: Calls and outbound dispatch.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://call-va.mintlify.site/_mintlify/api/og/v2?division=Calls\u0026amp;title=Create+a+call\u0026amp;description=Requires+permission%3A+%60calls.create%60.%0A%0AWhat+a+token+may+call+depends+on+its+role%3A+see+%5BAuthentication+and+permissions%5D%28%2Fauthentication%29.+Guide%3A+%5BCalls+and+outbou\u0026amp;theme=848dcf36653d057026529a79\u0026amp;signature=67e922004e164d82b0c63b564d6998b98d6865e601051d882b08ce79f6725be4\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/call-va/OocbCK5JGH14FXOT/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"CallVA\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.callva.io/api-reference/calls/create-a-call\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/calls/create-a-call.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.callva.io/#organization\",\"name\":\"CallVA\",\"url\":\"https://docs.callva.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/call-va/JVDhnfnOC_cj2yK9/logo/light.svg?fit=max\u0026auto=format\u0026n=JVDhnfnOC_cj2yK9\u0026q=85\u0026s=54be2b6b3422833c0be254822800787d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.callva.io#website\",\"name\":\"CallVA\",\"url\":\"https://docs.callva.io\",\"publisher\":{\"@id\":\"https://docs.callva.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.callva.io/api-reference/calls/create-a-call#webpage\",\"url\":\"https://docs.callva.io/api-reference/calls/create-a-call\",\"name\":\"Create a call\",\"description\":\"Requires permission: calls.create. What a token may call depends on its role: see Authentication and permissions. Guide: Calls and outbound dispatch.\",\"dateModified\":\"2026-11-11T02:46:36.893Z\",\"isPartOf\":{\"@id\":\"https://docs.callva.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.callva.io/api-reference/calls/create-a-call#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.callva.io/api-reference/calls/create-a-call#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Calls\",\"item\":\"https://docs.callva.io/api-reference/calls/aggregate-calls\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a call\",\"item\":\"https://docs.callva.io/api-reference/calls/create-a-call\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.callva.io/api-reference/calls/create-a-call#apireference\",\"headline\":\"Create a call\",\"name\":\"Create a call\",\"description\":\"Requires permission: calls.create. What a token may call depends on its role: see Authentication and permissions. Guide: Calls and outbound dispatch.\",\"url\":\"https://docs.callva.io/api-reference/calls/create-a-call\",\"mainEntityOfPage\":{\"@id\":\"https://docs.callva.io/api-reference/calls/create-a-call#webpage\"},\"dateModified\":\"2026-11-11T02:46:36.893Z\",\"publisher\":{\"@id\":\"https://docs.callva.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.callva.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"CallVA\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"CallVA\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/calls/create-a-call.md","siteName":"CallVA","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","icon":"square-terminal","groups":[{"group":"Overview","pages":[{"title":"API reference","icon":"square-terminal","href":"/api-reference/introduction"}]},{"group":"Actions","pages":[{"title":"List a call's actions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /calls/{call}/actions","href":"/api-reference/actions/list-a-calls-actions"},{"title":"Run a record action","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /calls/{call}/actions/{action}","href":"/api-reference/actions/run-a-record-action"},{"title":"List a call's action runs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /calls/{call}/action-runs","href":"/api-reference/actions/list-a-calls-action-runs"},{"title":"List actions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /actions","href":"/api-reference/actions/list-actions"},{"title":"Create an action","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /actions","href":"/api-reference/actions/create-an-action"},{"title":"Get an action","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /actions/{action}","href":"/api-reference/actions/get-an-action"},{"title":"Delete an action","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /actions/{action}","href":"/api-reference/actions/delete-an-action"},{"title":"Update an action","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /actions/{action}","href":"/api-reference/actions/update-an-action"}]},{"group":"Agent tools","pages":[{"title":"List an agent's tools","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{id}/tools","href":"/api-reference/agent-tools/list-an-agents-tools"},{"title":"Get an agent's tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{id}/tools/{key}","href":"/api-reference/agent-tools/get-an-agents-tool"},{"title":"Replace an agent's tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /agents/{id}/tools/{key}","href":"/api-reference/agent-tools/replace-an-agents-tool"},{"title":"Delete an agent's tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /agents/{id}/tools/{key}","href":"/api-reference/agent-tools/delete-an-agents-tool"},{"title":"Update an agent's tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /agents/{id}/tools/{key}","href":"/api-reference/agent-tools/update-an-agents-tool"}]},{"group":"Agents","pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents","href":"/api-reference/agents/list-agents"},{"title":"Create an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents","href":"/api-reference/agents/create-an-agent"},{"title":"Get the default agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/default","href":"/api-reference/agents/get-the-default-agent"},{"title":"Get an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{id}","href":"/api-reference/agents/get-an-agent"},{"title":"Delete an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /agents/{id}","href":"/api-reference/agents/delete-an-agent"},{"title":"Update an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /agents/{id}","href":"/api-reference/agents/update-an-agent"},{"title":"Clone an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{id}/clone","href":"/api-reference/agents/clone-an-agent"}]},{"group":"Assets","pages":[{"title":"List assets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /assets","href":"/api-reference/assets/list-assets"},{"title":"Create an asset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /assets","href":"/api-reference/assets/create-an-asset"},{"title":"Get an asset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /assets/{id}","href":"/api-reference/assets/get-an-asset"},{"title":"Delete an asset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /assets/{id}","href":"/api-reference/assets/delete-an-asset"},{"title":"Update an asset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /assets/{id}","href":"/api-reference/assets/update-an-asset"}]},{"group":"Automation triggers","pages":[{"title":"List automation triggers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /automations/{id}/triggers","href":"/api-reference/automation-triggers/list-automation-triggers"},{"title":"Create an automation trigger","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /automations/{id}/triggers","href":"/api-reference/automation-triggers/create-an-automation-trigger"},{"title":"Update an automation trigger","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /automations/{id}/triggers/{path}","href":"/api-reference/automation-triggers/update-an-automation-trigger"},{"title":"Delete an automation trigger","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /automations/{id}/triggers/{path}","href":"/api-reference/automation-triggers/delete-an-automation-trigger"},{"title":"Toggle an automation trigger","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /automations/{id}/triggers/{path}/toggle","href":"/api-reference/automation-triggers/toggle-an-automation-trigger"}]},{"group":"Automations","pages":[{"title":"List a call's automation runs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /calls/{callId}/automation-runs","href":"/api-reference/automations/list-a-calls-automation-runs"},{"title":"Get the automation runtime","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /automations/runtime-info","href":"/api-reference/automations/get-the-automation-runtime"},{"title":"List all automation runs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /automations/runs","href":"/api-reference/automations/list-all-automation-runs"},{"title":"List automations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /automations","href":"/api-reference/automations/list-automations"},{"title":"Create an automation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /automations","href":"/api-reference/automations/create-an-automation"},{"title":"Get an automation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /automations/{id}","href":"/api-reference/automations/get-an-automation"},{"title":"Update an automation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /automations/{id}","href":"/api-reference/automations/update-an-automation"},{"title":"Delete an automation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /automations/{id}","href":"/api-reference/automations/delete-an-automation"},{"title":"Get an automation's code","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /automations/{id}/code","href":"/api-reference/automations/get-an-automations-code"},{"title":"Replace an automation's code","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /automations/{id}/code","href":"/api-reference/automations/replace-an-automations-code"},{"title":"Run an automation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /automations/{id}/run","href":"/api-reference/automations/run-an-automation"},{"title":"List an automation's runs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /automations/{id}/runs","href":"/api-reference/automations/list-an-automations-runs"},{"title":"Get an automation run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /automations/{id}/runs/{jobId}","href":"/api-reference/automations/get-an-automation-run"}]},{"group":"Calls","pages":[{"title":"Aggregate calls","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /calls/aggregate","href":"/api-reference/calls/aggregate-calls"},{"title":"Get call trends","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /calls/trends","href":"/api-reference/calls/get-call-trends"},{"title":"Update calls in bulk","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /calls/batch","href":"/api-reference/calls/update-calls-in-bulk"},{"title":"List calls","description":"Requires permission: `calls.read`.\n\nWhat a token may call depends on its role: see [Authentication and permissions](/authentication). Guide: [Calls and outbound dispatch](/guides/calls).\n\nEvery field of the project's data model filters the list by its key:\n`field_key=value` for an exact match, or `field_key_\u003coperator>=value`\nwith an operator of `gt`, `gte`, `lt`, `lte`, `ne`, `like`, `in`, `nin`,\n`nullneq`, `null`, `not_null`, `empty` or `not_empty`, as far as the\nfield's type allows it. Only fields marked filterable take a filter, and\na filter the field cannot take answers 422. The fields and their types\nare listed by `GET /custom-fields`.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /calls","href":"/api-reference/calls/list-calls"},{"title":"Create a call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /calls","href":"/api-reference/calls/create-a-call"},{"title":"Get a call","description":"Requires permission: `calls.read`.\n\nWhat a token may call depends on its role: see [Authentication and permissions](/authentication). Guide: [Calls and outbound dispatch](/guides/calls).","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /calls/{call}","href":"/api-reference/calls/get-a-call"},{"title":"Update a call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /calls/{call}","href":"/api-reference/calls/update-a-call"},{"title":"Delete a call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /calls/{call}","href":"/api-reference/calls/delete-a-call"}]},{"group":"Custom field groups","pages":[{"title":"List custom field groups","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /custom-field-groups","href":"/api-reference/custom-field-groups/list-custom-field-groups"},{"title":"Create a custom field group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /custom-field-groups","href":"/api-reference/custom-field-groups/create-a-custom-field-group"},{"title":"Delete a custom field group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /custom-field-groups/{groupId}","href":"/api-reference/custom-field-groups/delete-a-custom-field-group"},{"title":"Update a custom field group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /custom-field-groups/{groupId}","href":"/api-reference/custom-field-groups/update-a-custom-field-group"},{"title":"Reorder custom field groups","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /custom-field-groups/reorder","href":"/api-reference/custom-field-groups/reorder-custom-field-groups"},{"title":"Add a field to a group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /custom-field-groups/{groupId}/fields","href":"/api-reference/custom-field-groups/add-a-field-to-a-group"},{"title":"Remove a field from a group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /custom-field-groups/{groupId}/fields/{fieldId}","href":"/api-reference/custom-field-groups/remove-a-field-from-a-group"},{"title":"Update a field's group settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /custom-field-groups/{groupId}/fields/{fieldId}","href":"/api-reference/custom-field-groups/update-a-fields-group-settings"},{"title":"Reorder a group's fields","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /custom-field-groups/{groupId}/fields/reorder","href":"/api-reference/custom-field-groups/reorder-a-groups-fields"}]},{"group":"Custom fields","pages":[{"title":"Get the extraction schema","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /custom-fields/extraction-schema","href":"/api-reference/custom-fields/get-the-extraction-schema"},{"title":"Get a field's deletion impact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /custom-fields/{custom_field}/delete-impact","href":"/api-reference/custom-fields/get-a-fields-deletion-impact"},{"title":"List custom fields","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /custom-fields","href":"/api-reference/custom-fields/list-custom-fields"},{"title":"Create a custom field","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /custom-fields","href":"/api-reference/custom-fields/create-a-custom-field"},{"title":"Update a custom field","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /custom-fields/{custom_field}","href":"/api-reference/custom-fields/update-a-custom-field"},{"title":"Delete a custom field","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /custom-fields/{custom_field}","href":"/api-reference/custom-fields/delete-a-custom-field"}]},{"group":"Issues","pages":[{"title":"List issues","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issues","href":"/api-reference/issues/list-issues"},{"title":"Create an issue","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /issues","href":"/api-reference/issues/create-an-issue"},{"title":"Get an issue","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issues/{issue}","href":"/api-reference/issues/get-an-issue"},{"title":"Delete an issue","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /issues/{issue}","href":"/api-reference/issues/delete-an-issue"},{"title":"Update an issue","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /issues/{issue}","href":"/api-reference/issues/update-an-issue"}]},{"group":"Knowledge","pages":[{"title":"List knowledge items","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /knowledge","href":"/api-reference/knowledge/list-knowledge-items"},{"title":"Create a knowledge item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /knowledge","href":"/api-reference/knowledge/create-a-knowledge-item"},{"title":"Get a knowledge item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /knowledge/{knowledgeItem}","href":"/api-reference/knowledge/get-a-knowledge-item"},{"title":"Delete a knowledge item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /knowledge/{knowledgeItem}","href":"/api-reference/knowledge/delete-a-knowledge-item"},{"title":"Update a knowledge item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /knowledge/{knowledgeItem}","href":"/api-reference/knowledge/update-a-knowledge-item"}]},{"group":"Outbound calls","pages":[{"title":"Place an outbound call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /call","href":"/api-reference/outbound-calls/place-an-outbound-call"}]},{"group":"Phone numbers","pages":[{"title":"List phone numbers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /phone-numbers","href":"/api-reference/phone-numbers/list-phone-numbers"},{"title":"Create a phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /phone-numbers","href":"/api-reference/phone-numbers/create-a-phone-number"},{"title":"Get a phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /phone-numbers/{id}","href":"/api-reference/phone-numbers/get-a-phone-number"},{"title":"Delete a phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /phone-numbers/{id}","href":"/api-reference/phone-numbers/delete-a-phone-number"},{"title":"Update a phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /phone-numbers/{id}","href":"/api-reference/phone-numbers/update-a-phone-number"},{"title":"Assign an agent to a number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /phone-numbers/{id}/agent","href":"/api-reference/phone-numbers/assign-an-agent-to-a-number"}]},{"group":"Phone providers","pages":[{"title":"List phone provider types","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /phone-providers/types","href":"/api-reference/phone-providers/list-phone-provider-types"},{"title":"List phone providers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /phone-providers","href":"/api-reference/phone-providers/list-phone-providers"}]},{"group":"Presets","pages":[{"title":"List the preset catalogue","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /presets","href":"/api-reference/presets/list-the-preset-catalogue"},{"title":"List an agent's presets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{id}/presets","href":"/api-reference/presets/list-an-agents-presets"},{"title":"Get an agent's preset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{id}/presets/{preset}","href":"/api-reference/presets/get-an-agents-preset"},{"title":"Replace an agent's preset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /agents/{id}/presets/{preset}","href":"/api-reference/presets/replace-an-agents-preset"},{"title":"Update an agent's preset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /agents/{id}/presets/{preset}","href":"/api-reference/presets/update-an-agents-preset"},{"title":"Activate an agent's preset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{id}/presets/{preset}/activate","href":"/api-reference/presets/activate-an-agents-preset"}]},{"group":"Project settings","pages":[{"title":"List project settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /settings/project","href":"/api-reference/project-settings/list-project-settings"},{"title":"Reveal a project setting","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /settings/project/{definitionId}/reveal","href":"/api-reference/project-settings/reveal-a-project-setting"},{"title":"Rotate the webhook signing secret","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /settings/project/agent-webhook-secret/generate","href":"/api-reference/project-settings/rotate-the-webhook-signing-secret"}]},{"group":"Projects","pages":[{"title":"List projects","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /projects","href":"/api-reference/projects/list-projects"},{"title":"Create a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /projects","href":"/api-reference/projects/create-a-project"},{"title":"Get a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /projects/{id}","href":"/api-reference/projects/get-a-project"},{"title":"Delete a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /projects/{id}","href":"/api-reference/projects/delete-a-project"},{"title":"Update a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /projects/{id}","href":"/api-reference/projects/update-a-project"}]},{"group":"Recordings","pages":[{"title":"Stream a call's recording","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /calls/{callId}/recording","href":"/api-reference/recordings/stream-a-calls-recording"},{"title":"Purge a recording's cache","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /calls/{callId}/recording","href":"/api-reference/recordings/purge-a-recordings-cache"}]},{"group":"Saved views","pages":[{"title":"List saved views","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /ui-views","href":"/api-reference/saved-views/list-saved-views"},{"title":"Create a saved view","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /ui-views","href":"/api-reference/saved-views/create-a-saved-view"},{"title":"Get a saved view","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /ui-views/{view}","href":"/api-reference/saved-views/get-a-saved-view"},{"title":"Delete a saved view","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /ui-views/{view}","href":"/api-reference/saved-views/delete-a-saved-view"},{"title":"Update a saved view","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /ui-views/{view}","href":"/api-reference/saved-views/update-a-saved-view"},{"title":"Set the default saved view","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /ui-views/{view}/set-default","href":"/api-reference/saved-views/set-the-default-saved-view"}]},{"group":"Transcripts","pages":[{"title":"Get a call's transcript","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /calls/{callId}/transcript","href":"/api-reference/transcripts/get-a-calls-transcript"},{"title":"Replace a call's transcript","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /calls/{callId}/transcript","href":"/api-reference/transcripts/replace-a-calls-transcript"},{"title":"Save a call's transcript","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /calls/{callId}/transcript","href":"/api-reference/transcripts/save-a-calls-transcript"},{"title":"Delete a call's transcript","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /calls/{callId}/transcript","href":"/api-reference/transcripts/delete-a-calls-transcript"},{"title":"Get a transcript download link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /calls/{callId}/transcript/url","href":"/api-reference/transcripts/get-a-transcript-download-link"}]},{"group":"Variables","pages":[{"title":"List variables","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /variables","href":"/api-reference/variables/list-variables"},{"title":"Create a variable","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /variables","href":"/api-reference/variables/create-a-variable"},{"title":"Delete a variable","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /variables/{path}","href":"/api-reference/variables/delete-a-variable"},{"title":"Update a variable","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /variables/{path}","href":"/api-reference/variables/update-a-variable"}]},{"group":"Webhook logs","pages":[{"title":"List a call's webhook logs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /calls/{callId}/webhook-logs","href":"/api-reference/webhook-logs/list-a-calls-webhook-logs"},{"title":"List webhook logs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /webhook-logs","href":"/api-reference/webhook-logs/list-webhook-logs"},{"title":"List webhook log filters","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /webhook-logs/filters","href":"/api-reference/webhook-logs/list-webhook-log-filters"},{"title":"Get a webhook log","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /webhook-logs/{webhookLog}","href":"/api-reference/webhook-logs/get-a-webhook-log"}]},{"group":"Webhook schedules","pages":[{"title":"List webhook schedules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /webhook-schedule","href":"/api-reference/webhook-schedules/list-webhook-schedules"},{"title":"Create a webhook schedule","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /webhook-schedule","href":"/api-reference/webhook-schedules/create-a-webhook-schedule"},{"title":"Get a webhook schedule","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /webhook-schedule/{id}","href":"/api-reference/webhook-schedules/get-a-webhook-schedule"},{"title":"Update a webhook schedule","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /webhook-schedule/{id}","href":"/api-reference/webhook-schedules/update-a-webhook-schedule"},{"title":"Delete a webhook schedule","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /webhook-schedule/{id}","href":"/api-reference/webhook-schedules/delete-a-webhook-schedule"},{"title":"Preview a webhook schedule","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /webhook-schedule/{id}/preview","href":"/api-reference/webhook-schedules/preview-a-webhook-schedule"},{"title":"List a schedule's executions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /webhook-schedule/{id}/execution","href":"/api-reference/webhook-schedules/list-a-schedules-executions"}]}]}]},"basePath":"","title":"Create a call - CallVA","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C9Wu0MeN.js","utils-jWgu-6Qf.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DBD8f9qn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BGuX1ui5.js","snippetPresets-Evy63nQB.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BQHO1lnV.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-B6C8m-t_.js","shallow-BG4cT0fH.js","getApiPlaygroundDisplay-CgEPrE-D.js","CodeSnippet-CU8JyZ9N.js","CodeSnippets-BnxHU32T.js","Page-D6S0Yh6q.js","getPastedJson-CwiYOonh.js","icon-DYDpWmDf.js","MethodPill-C-J-l7_c.js","DuplicateIcon-B6ARwg9w.js","createIcon-Dsv4MtDq.js","DynamicMarkdown-CtasenyM.js","SectionHeading-YNcgYwjB.js","axios-vUo_bRtp.js","Markdown-CwLx6PAg.js","clsx-C3kuh_dz.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CmKHfscc.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-U3mI6Ljh.js"]}