Registers an inbound call that your telephony already holds and returns the SIP destination to bridge it to.
Use this when you own the inbound call flow and decide per call which agent should answer. The call record is
created up front with the supplied variables, so the call ID you receive here is the same ID on the result
webhook, call results and recordings. Bridge the live call to the returned SIP URI and the agent starts.
callDeadline is how long the registration stays valid. If the call is not bridged by then, it is canceled and reported through the result webhook. Default is 10 minutes, maximum 24 hours.
Registration details: caller number, called number, variables, deadline
Registration of an inbound call that your telephony already holds. Registering creates the call record with its settings before the audio arrives, and returns the SIP destination to bridge the live call to. The agent starts as soon as the call reaches that destination.
Data for variable interpolation in agent prompts. Values can be referenced in prompts using {{variableName}} syntax. Merged with the agent's AdditionalData.
Time until which the registration stays valid. If the call has not been bridged to the SIP destination by then, the registration is canceled and reported through the result webhook. Defaults to 10 minutes after registration; cannot exceed 24 hours.
Identifier of one of your verified custom SIP domains (see /api/v1/sip-domains). When set, the returned SIP URI uses that domain instead of the shared Dasha domain. The domain must be Active.
Response
Call registered successfully
Response after registering an inbound call. Store the call ID: it is the correlation key on every webhook and call result for this call. Bridge the live call to the SIP URI to start the agent.
Current status. A fresh registration is Registered; it becomes Running when the call reaches the SIP destination and Canceled if the deadline passes first.
Data for variable interpolation in agent prompts, as supplied at registration.
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Dasha BlackBox Documentation","description":"Build, deploy, and monitor voice AI agents with Dasha BlackBox. Complete documentation for creating intelligent conversational AI agents with advanced voice capabilities.","colors":{"primary":"#4F46E5","light":"#6366F1","dark":"#312E81"},"logo":{"light":"https://mintcdn.com/dasha-628f9d33/OIOU150RbPNcpw0P/docs/logo-wordmark-light.svg?fit=max\u0026auto=format\u0026n=OIOU150RbPNcpw0P\u0026q=85\u0026s=d09a8bf9e3455eda1fccc003884b3cdf","dark":"https://mintcdn.com/dasha-628f9d33/OIOU150RbPNcpw0P/docs/logo-wordmark-dark.svg?fit=max\u0026auto=format\u0026n=OIOU150RbPNcpw0P\u0026q=85\u0026s=1a3ce52b54cb5126d7f2cd2a42c27fa3","href":"https://blackbox.dasha.ai"},"favicon":"https://mintcdn.com/dasha-628f9d33/PM9rl5FBZe1J7dH8/docs/logo.svg?fit=max\u0026auto=format\u0026n=PM9rl5FBZe1J7dH8\u0026q=85\u0026s=21c9365f53a83564419467531fb20a5d","api":{"playground":{"display":"interactive"},"examples":{"languages":["javascript","curl","python"]}},"navbar":{"links":[{"href":"https://dasha.ai","label":"Explore other Dasha products"},{"href":"mailto:support+blackbox@dasha.ai","label":"Get Support"}],"primary":{"type":"button","label":"Go to Dashboard","href":"https://blackbox.dasha.ai"}},"footer":{"socials":{"x":"https://x.com/dashaai_","linkedin":"https://www.linkedin.com/company/dashaai","github":"https://github.com/dasha-ai"},"links":[{"header":"Resources","items":[{"label":"Main Website","href":"https://dasha.ai"},{"label":"Dashboard","href":"https://blackbox.dasha.ai"},{"label":"Status","href":"https://status.dasha.ai"}]},{"header":"Support","items":[{"label":"Get Support","href":"mailto:support+blackbox@dasha.ai"}]}]},"search":{"prompt":"Search Dasha BlackBox docs..."},"seo":{"metatags":{"canonical":"https://blackbox.dasha.ai"},"indexing":"navigable"},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":true},"integrations":{"posthog":{"apiKey":"phc_bF01JhDcDBEhCGS2wY8QMkGqrzgBQ25KxhcziHgwDvm","apiHost":"https://us.i.posthog.com"}},"errors":{"404":{"redirect":false,"title":"Page Not Found","description":"This page doesn't exist. Try using the search or navigation to find what you're looking for."}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"global":{"anchors":[{"anchor":"Status","icon":"chart-line","href":"https://status.dasha.ai"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dasha-628f9d33","hasAudioNarration":false,"actualSubdomain":"dasha-628f9d33","customDomains":["docs.blackbox.dasha.ai"],"gitSource":{"type":"github","owner":"dasha-ai","repo":"blackbox-docs","deployBranch":"production","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aeafa53b434e7d02a3a2567","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API Reference","count":119},{"language":"default","tag":"Documentation","count":64},{"language":"default","tag":"Create","count":19},{"language":"default","tag":"Advanced Features","count":18},{"language":"default","tag":"Deploy","count":11},{"language":"default","tag":"Introduction","count":9},{"language":"default","tag":"Calls","count":9},{"language":"default","tag":"Misc","count":9},{"language":"default","tag":"WebIntegrations","count":9},{"language":"default","tag":"Document","count":8}]},"assistantConfig":{"deflection":{"enabled":true,"email":"support@dasha.ai"}},"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":"docs/api-reference/calls/register-inbound-call","slug":"/docs/api-reference/calls/register-inbound-call","pageMetadata":{"title":"Register inbound call","description":"Registers an inbound call that your telephony already holds and returns the SIP destination to bridge it to.\nUse this when you own the inbound call flow and decide per call which agent should answer. The call record is\ncreated up front with the supplied variables, so the call ID you receive here is the same ID on the result\nwebhook, call results and recordings. Bridge the live call to the returned SIP URI and the agent starts.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/calls/register","href":"/docs/api-reference/calls/register-inbound-call","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Registers an inbound call that your telephony already holds and returns the SIP destination to bridge it to.\\nUse this when you own the inbound call flow and decide per call which agent should answer. The call record is\\ncreated up front with the supplied variables, so the call ID you receive here is the same ID on the result\\nwebhook, call results and recordings. Bridge the live call to the returned SIP URI and the agent starts.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,ol:`ol`,p:`p`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`register-then-bridge-flow`,children:`Register-then-bridge flow`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Your telephony receives the inbound call and decides which agent should answer.`}),`\n`,_jsx(_components.li,{children:`Call this endpoint with the agent ID, the caller number and any variables the agent needs.`}),`\n`,_jsxs(_components.li,{children:[`Store the returned `,_jsx(_components.code,{children:`callId`}),` and bridge the live call to the returned `,_jsx(_components.code,{children:`sipUri`}),` (`,_jsx(_components.code,{children:`sip:{callId}@sip-reg.blackbox.dasha.ai`}),`).`]}),`\n`,_jsxs(_components.li,{children:[`The agent answers as soon as the call arrives. Results arrive on the agent’s result webhook with the same `,_jsx(_components.code,{children:`callId`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`deadline`,children:`Deadline`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`callDeadline`}),` is how long the registration stays valid. If the call is not bridged by then, it is canceled and reported through the result webhook. Default is 10 minutes, maximum 24 hours.`]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`The response includes the assigned `,_jsx(_components.code,{children:`callId`}),`, the `,_jsx(_components.code,{children:`sipUri`}),` to bridge to, and the stored settings. The call has status `,_jsx(_components.code,{children:`Registered`}),` until the audio arrives.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"title":"Register inbound call","description":"Registers an inbound call that your telephony already holds and returns the SIP destination to bridge it to.\nUse this when you own the inbound call flow and decide per call which agent should answer. The call record is\ncreated up front with the supplied variables, so the call ID you receive here is the same ID on the result\nwebhook, call results and recordings. Bridge the live call to the returned SIP URI and the agent starts.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/calls/register","href":"/docs/api-reference/calls/register-inbound-call","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Register-then-bridge flow","slug":"register-then-bridge-flow","depth":2,"children":[]},{"title":"Deadline","slug":"deadline","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Calls"],"summary":"Register inbound call","description":"Registers an inbound call that your telephony already holds and returns the SIP destination to bridge it to.\nUse this when you own the inbound call flow and decide per call which agent should answer. The call record is\ncreated up front with the supplied variables, so the call ID you receive here is the same ID on the result\nwebhook, call results and recordings. Bridge the live call to the returned SIP URI and the agent starts.","parameters":["fd2c3f4b-dc96-4339-a63f-e0bb263092a2"],"requestBody":"945bdac5-25a3-49bb-82ea-e5a974165220","responses":{"201":"61d35504-e70b-40c1-abc6-d70a63407f30","400":"fbe1460e-066a-41cd-8f04-be1640be6a59","401":"ee10d23c-58cc-4cdd-a722-618429d1897b","403":"3814bc3d-003f-4433-a0a5-5b16d97ef74d","404":"fba2d543-1cbb-4345-87ad-f36a812c22b5","500":"d9262ed4-6b65-4f1b-958e-43117b64c52e","501":"49c3e92a-3edd-4e2b-9220-bea75afc3643"},"x-mint":{"content":"## Register-then-bridge flow\n\n1. Your telephony receives the inbound call and decides which agent should answer.\n2. Call this endpoint with the agent ID, the caller number and any variables the agent needs.\n3. Store the returned `callId` and bridge the live call to the returned `sipUri` (`sip:{callId}@sip-reg.blackbox.dasha.ai`).\n4. The agent answers as soon as the call arrives. Results arrive on the agent's result webhook with the same `callId`.\n\n## Deadline\n\n`callDeadline` is how long the registration stays valid. If the call is not bridged by then, it is canceled and reported through the result webhook. Default is 10 minutes, maximum 24 hours.\n\n## Response\n\nThe response includes the assigned `callId`, the `sipUri` to bridge to, and the stored settings. The call has status `Registered` until the audio arrives."},"method":"post","type":"path","servers":["5fb0835c-a4f0-4503-aebe-00595f89e21f"],"security":["438e7f68-a155-42fd-8675-9d1199ae2693","bcfc7084-0b9a-4851-80ea-de419eddc013"],"path":"/api/v1/calls/register","baseUrlOptions":["https://blackbox.dasha.ai"],"title":"Register inbound call","codeSamples":[],"requestExampleLanguages":["javascript","bash","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"fd2c3f4b-dc96-4339-a63f-e0bb263092a2":{"name":"agentId","in":"query","description":"Agent identifier","schema":{"type":"string","description":"Agent identifier","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"description":"Registration details: caller number, called number, variables, deadline","content":{"application/json":{"schema":{"type":"object","description":"Registration of an inbound call that your telephony already holds. Registering creates the call record with its settings before the audio arrives, and returns the SIP destination to bridge the live call to. The agent starts as soon as the call reaches that destination.","required":["fromNumber"],"properties":{"fromNumber":{"minLength":1,"type":"string","description":"Number of the original caller (E.164 recommended). Stored as the call endpoint and reported back on every webhook for this call.","isRequired":true,"uniqueKey":"fromNumber","typeLabel":"string"},"toNumber":{"oneOf":[{"type":"string","description":"Number that received the inbound call. Optional, informational only.","default":null,"uniqueKey":"toNumber.oneOf.0","typeLabel":"string"},{"type":"null","description":"Number that received the inbound call. Optional, informational only.","default":null,"uniqueKey":"toNumber.oneOf.1","typeLabel":"null"}],"uniqueKey":"toNumber","typeLabel":"string | null"},"additionalData":{"oneOf":[{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalData.oneOf.0.additionalProperties","typeLabel":"any"},"description":"Data for variable interpolation in agent prompts. Values can be referenced in prompts using {{variableName}} syntax. Merged with the agent's AdditionalData.","uniqueKey":"additionalData.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalData.oneOf.1.additionalProperties","typeLabel":"any"},"description":"Data for variable interpolation in agent prompts. Values can be referenced in prompts using {{variableName}} syntax. Merged with the agent's AdditionalData.","uniqueKey":"additionalData.oneOf.1","typeLabel":"null"}],"uniqueKey":"additionalData","typeLabel":"object | null"},"callDeadline":{"oneOf":[{"type":"string","description":"Time until which the registration stays valid. If the call has not been bridged to the SIP destination by then, the registration is canceled and reported through the result webhook. Defaults to 10 minutes after registration; cannot exceed 24 hours.","format":"date-time","default":null,"uniqueKey":"callDeadline.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"Time until which the registration stays valid. If the call has not been bridged to the SIP destination by then, the registration is canceled and reported through the result webhook. Defaults to 10 minutes after registration; cannot exceed 24 hours.","format":"date-time","default":null,"uniqueKey":"callDeadline.oneOf.1","typeLabel":"null"}],"uniqueKey":"callDeadline","typeLabel":"string\u003cdate-time> | null"},"sipDomainId":{"oneOf":[{"type":"string","description":"Identifier of one of your verified custom SIP domains (see /api/v1/sip-domains). When set, the returned SIP URI uses that domain instead of the shared Dasha domain. The domain must be Active.","format":"uuid","default":null,"uniqueKey":"sipDomainId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","description":"Identifier of one of your verified custom SIP domains (see /api/v1/sip-domains). When set, the returned SIP URI uses that domain instead of the shared Dasha domain. The domain must be Active.","format":"uuid","default":null,"uniqueKey":"sipDomainId.oneOf.1","typeLabel":"null"}],"uniqueKey":"sipDomainId","typeLabel":"string\u003cuuid> | null"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"fromNumber":"\u003cstring>","toNumber":null,"additionalData":{},"callDeadline":null,"sipDomainId":null}}},"exampleType":"generated"},"text/json":{"schema":{"type":"object","description":"Registration of an inbound call that your telephony already holds. Registering creates the call record with its settings before the audio arrives, and returns the SIP destination to bridge the live call to. The agent starts as soon as the call reaches that destination.","required":["fromNumber"],"properties":{"fromNumber":{"minLength":1,"type":"string","description":"Number of the original caller (E.164 recommended). Stored as the call endpoint and reported back on every webhook for this call.","isRequired":true,"uniqueKey":"fromNumber","typeLabel":"string"},"toNumber":{"oneOf":[{"type":"string","description":"Number that received the inbound call. Optional, informational only.","default":null,"uniqueKey":"toNumber.oneOf.0","typeLabel":"string"},{"type":"null","description":"Number that received the inbound call. Optional, informational only.","default":null,"uniqueKey":"toNumber.oneOf.1","typeLabel":"null"}],"uniqueKey":"toNumber","typeLabel":"string | null"},"additionalData":{"oneOf":[{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalData.oneOf.0.additionalProperties","typeLabel":"any"},"description":"Data for variable interpolation in agent prompts. Values can be referenced in prompts using {{variableName}} syntax. Merged with the agent's AdditionalData.","uniqueKey":"additionalData.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalData.oneOf.1.additionalProperties","typeLabel":"any"},"description":"Data for variable interpolation in agent prompts. Values can be referenced in prompts using {{variableName}} syntax. Merged with the agent's AdditionalData.","uniqueKey":"additionalData.oneOf.1","typeLabel":"null"}],"uniqueKey":"additionalData","typeLabel":"object | null"},"callDeadline":{"oneOf":[{"type":"string","description":"Time until which the registration stays valid. If the call has not been bridged to the SIP destination by then, the registration is canceled and reported through the result webhook. Defaults to 10 minutes after registration; cannot exceed 24 hours.","format":"date-time","default":null,"uniqueKey":"callDeadline.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"Time until which the registration stays valid. If the call has not been bridged to the SIP destination by then, the registration is canceled and reported through the result webhook. Defaults to 10 minutes after registration; cannot exceed 24 hours.","format":"date-time","default":null,"uniqueKey":"callDeadline.oneOf.1","typeLabel":"null"}],"uniqueKey":"callDeadline","typeLabel":"string\u003cdate-time> | null"},"sipDomainId":{"oneOf":[{"type":"string","description":"Identifier of one of your verified custom SIP domains (see /api/v1/sip-domains). When set, the returned SIP URI uses that domain instead of the shared Dasha domain. The domain must be Active.","format":"uuid","default":null,"uniqueKey":"sipDomainId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","description":"Identifier of one of your verified custom SIP domains (see /api/v1/sip-domains). When set, the returned SIP URI uses that domain instead of the shared Dasha domain. The domain must be Active.","format":"uuid","default":null,"uniqueKey":"sipDomainId.oneOf.1","typeLabel":"null"}],"uniqueKey":"sipDomainId","typeLabel":"string\u003cuuid> | null"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"fromNumber":"\u003cstring>","toNumber":null,"additionalData":{},"callDeadline":null,"sipDomainId":null}}},"exampleType":"generated"},"application/*+json":{"schema":{"type":"object","description":"Registration of an inbound call that your telephony already holds. Registering creates the call record with its settings before the audio arrives, and returns the SIP destination to bridge the live call to. The agent starts as soon as the call reaches that destination.","required":["fromNumber"],"properties":{"fromNumber":{"minLength":1,"type":"string","description":"Number of the original caller (E.164 recommended). Stored as the call endpoint and reported back on every webhook for this call.","isRequired":true,"uniqueKey":"fromNumber","typeLabel":"string"},"toNumber":{"oneOf":[{"type":"string","description":"Number that received the inbound call. Optional, informational only.","default":null,"uniqueKey":"toNumber.oneOf.0","typeLabel":"string"},{"type":"null","description":"Number that received the inbound call. Optional, informational only.","default":null,"uniqueKey":"toNumber.oneOf.1","typeLabel":"null"}],"uniqueKey":"toNumber","typeLabel":"string | null"},"additionalData":{"oneOf":[{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalData.oneOf.0.additionalProperties","typeLabel":"any"},"description":"Data for variable interpolation in agent prompts. Values can be referenced in prompts using {{variableName}} syntax. Merged with the agent's AdditionalData.","uniqueKey":"additionalData.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalData.oneOf.1.additionalProperties","typeLabel":"any"},"description":"Data for variable interpolation in agent prompts. Values can be referenced in prompts using {{variableName}} syntax. Merged with the agent's AdditionalData.","uniqueKey":"additionalData.oneOf.1","typeLabel":"null"}],"uniqueKey":"additionalData","typeLabel":"object | null"},"callDeadline":{"oneOf":[{"type":"string","description":"Time until which the registration stays valid. If the call has not been bridged to the SIP destination by then, the registration is canceled and reported through the result webhook. Defaults to 10 minutes after registration; cannot exceed 24 hours.","format":"date-time","default":null,"uniqueKey":"callDeadline.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"Time until which the registration stays valid. If the call has not been bridged to the SIP destination by then, the registration is canceled and reported through the result webhook. Defaults to 10 minutes after registration; cannot exceed 24 hours.","format":"date-time","default":null,"uniqueKey":"callDeadline.oneOf.1","typeLabel":"null"}],"uniqueKey":"callDeadline","typeLabel":"string\u003cdate-time> | null"},"sipDomainId":{"oneOf":[{"type":"string","description":"Identifier of one of your verified custom SIP domains (see /api/v1/sip-domains). When set, the returned SIP URI uses that domain instead of the shared Dasha domain. The domain must be Active.","format":"uuid","default":null,"uniqueKey":"sipDomainId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","description":"Identifier of one of your verified custom SIP domains (see /api/v1/sip-domains). When set, the returned SIP URI uses that domain instead of the shared Dasha domain. The domain must be Active.","format":"uuid","default":null,"uniqueKey":"sipDomainId.oneOf.1","typeLabel":"null"}],"uniqueKey":"sipDomainId","typeLabel":"string\u003cuuid> | null"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"fromNumber":"\u003cstring>","toNumber":null,"additionalData":{},"callDeadline":null,"sipDomainId":null}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"61d35504-e70b-40c1-abc6-d70a63407f30":{"description":"Call registered successfully","content":{"application/json":{"schema":{"required":["agentId","callDeadline","callId","createdTime","direction","fromNumber","orgId","sipUri","status"],"type":"object","properties":{"callId":{"minLength":1,"type":"string","description":"Unique identifier for this call. Same value on the result webhook, in call results, and in the SIP URI user part.","isRequired":true,"uniqueKey":"callId","typeLabel":"string"},"sipUri":{"minLength":1,"type":"string","description":"SIP destination to bridge the live call to, in the form sip:{callId}@{domain}.","isRequired":true,"uniqueKey":"sipUri","typeLabel":"string"},"orgId":{"minLength":1,"type":"string","description":"Organization that owns this call.","isRequired":true,"uniqueKey":"orgId","typeLabel":"string"},"agentId":{"minLength":1,"type":"string","description":"Agent that will handle this call.","isRequired":true,"uniqueKey":"agentId","typeLabel":"string"},"fromNumber":{"minLength":1,"type":"string","description":"Number of the original caller, as supplied at registration.","isRequired":true,"uniqueKey":"fromNumber","typeLabel":"string"},"status":{"type":"string","description":"Current status. A fresh registration is Registered; it becomes Running when the call reaches the SIP destination and Canceled if the deadline passes first.","enum":["Unknown","Created","Pending","Queued","Completed","Failed","Canceled","Running","Registered"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"direction":{"type":"string","description":"Always Inbound for registered calls.","enum":["Outbound","Inbound"],"isRequired":true,"uniqueKey":"direction","typeLabel":"enum\u003cstring>"},"callDeadline":{"type":"string","description":"Time until which the registration stays valid.","format":"date-time","isRequired":true,"uniqueKey":"callDeadline","typeLabel":"string\u003cdate-time>"},"createdTime":{"type":"string","description":"Timestamp when the call was registered.","format":"date-time","isRequired":true,"uniqueKey":"createdTime","typeLabel":"string\u003cdate-time>"},"sipDomainId":{"oneOf":[{"type":"string","description":"Custom SIP domain used for the SIP URI, when one was requested. Null when the shared Dasha domain is used.","format":"uuid","uniqueKey":"sipDomainId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","description":"Custom SIP domain used for the SIP URI, when one was requested. Null when the shared Dasha domain is used.","format":"uuid","uniqueKey":"sipDomainId.oneOf.1","typeLabel":"null"}],"uniqueKey":"sipDomainId","typeLabel":"string\u003cuuid> | null"},"toNumber":{"oneOf":[{"type":"string","description":"Number that received the inbound call, as supplied at registration.","uniqueKey":"toNumber.oneOf.0","typeLabel":"string"},{"type":"null","description":"Number that received the inbound call, as supplied at registration.","uniqueKey":"toNumber.oneOf.1","typeLabel":"null"}],"uniqueKey":"toNumber","typeLabel":"string | null"},"additionalData":{"oneOf":[{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalData.oneOf.0.additionalProperties","typeLabel":"any"},"description":"Data for variable interpolation in agent prompts, as supplied at registration.","uniqueKey":"additionalData.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalData.oneOf.1.additionalProperties","typeLabel":"any"},"description":"Data for variable interpolation in agent prompts, as supplied at registration.","uniqueKey":"additionalData.oneOf.1","typeLabel":"null"}],"uniqueKey":"additionalData","typeLabel":"object | null"}},"additionalProperties":false,"description":"Response after registering an inbound call. Store the call ID: it is the correlation key on every webhook and call result for this call. Bridge the live call to the SIP URI to start the agent.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"callId":"\u003cstring>","sipUri":"\u003cstring>","orgId":"\u003cstring>","agentId":"\u003cstring>","fromNumber":"\u003cstring>","status":"Unknown","direction":"Outbound","callDeadline":"2023-11-07T05:31:56Z","createdTime":"2023-11-07T05:31:56Z","sipDomainId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","toNumber":"\u003cstring>","additionalData":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"fbe1460e-066a-41cd-8f04-be1640be6a59":{"description":"Invalid configuration, validation errors, or deadline beyond the allowed maximum","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"oneOf":[{"type":"string","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"status.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer\u003cint32> | null"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalProperties","typeLabel":"any"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"ee10d23c-58cc-4cdd-a722-618429d1897b":{"description":"Authentication failed or API key is missing","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"oneOf":[{"type":"string","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"status.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer\u003cint32> | null"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalProperties","typeLabel":"any"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"3814bc3d-003f-4433-a0a5-5b16d97ef74d":{"description":"Access denied or agent not accessible","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"oneOf":[{"type":"string","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"status.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer\u003cint32> | null"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalProperties","typeLabel":"any"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"fba2d543-1cbb-4345-87ad-f36a812c22b5":{"description":"Agent with specified ID does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"oneOf":[{"type":"string","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"status.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer\u003cint32> | null"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalProperties","typeLabel":"any"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"d9262ed4-6b65-4f1b-958e-43117b64c52e":{"description":"Server error occurred during call registration","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"49c3e92a-3edd-4e2b-9220-bea75afc3643":{"description":"Register call is not configured on this deployment","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"438e7f68-a155-42fd-8675-9d1199ae2693":{"ApiKey":{"type":"http","description":"API Key Authentication (Bearer {key})","scheme":"Bearer","scopes":[],"schemeName":"ApiKey"}},"bcfc7084-0b9a-4851-80ea-de419eddc013":{"OAuth":{"type":"oauth2","flows":{"implicit":{"authorizationUrl":"https://auth.dasha.ai/connect/authorize","scopes":{"platform_api":"Platform API"}}},"scopes":[],"schemeName":"OAuth"}}},"servers":{"5fb0835c-a4f0-4503-aebe-00595f89e21f":{"url":"https://blackbox.dasha.ai","description":"Dasha BlackBox Agent API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","description":"API Key Authentication (Bearer {key})","scheme":"Bearer","scopes":[],"schemeName":"ApiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API Key Authentication (Bearer {key})","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKey","name":"Authorization"}],"title":"ApiKey"},{"schemes":[{"scheme":{"type":"oauth2","flows":{"implicit":{"authorizationUrl":"https://auth.dasha.ai/connect/authorize","scopes":{"platform_api":"Platform API"}}},"scopes":[],"schemeName":"OAuth"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"The access token received from the authorization server in the OAuth 2.0 flow.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"OAuth","name":"Authorization"}],"title":"OAuth"}]},"originalFileLocation":"https://blackbox.dasha.ai/swagger/v1/swagger.json"},"subdomain":"dasha-628f9d33","siteName":"Dasha BlackBox Documentation","title":"Register inbound call - Dasha BlackBox Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T09:27:34.402Z","originalFileLocation":"docs/api-reference/calls/register-inbound-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=\"Registers an inbound call that your telephony already holds and returns the SIP destination to bridge it to. Use this when you own the inbound call flow and decide per call which agent should answer. The call record is created up front with the supplied variables, so the call ID you receive here is the same ID on the result webhook, call results and recordings. Bridge the live call to the returned SIP URI and the agent starts.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Dasha BlackBox Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dasha-628f9d33/fTvoboiNZnitZ8gw/_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/dasha-628f9d33/fTvoboiNZnitZ8gw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dasha-628f9d33/fTvoboiNZnitZ8gw/_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/dasha-628f9d33/fTvoboiNZnitZ8gw/_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/dasha-628f9d33/fTvoboiNZnitZ8gw/_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/dasha-628f9d33/fTvoboiNZnitZ8gw/_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/dasha-628f9d33/fTvoboiNZnitZ8gw/_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/dasha-628f9d33/fTvoboiNZnitZ8gw/_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/dasha-628f9d33/fTvoboiNZnitZ8gw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Register inbound call - Dasha BlackBox Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Registers an inbound call that your telephony already holds and returns the SIP destination to bridge it to. Use this when you own the inbound call flow and decide per call which agent should answer. The call record is created up front with the supplied variables, so the call ID you receive here is the same ID on the result webhook, call results and recordings. Bridge the live call to the returned SIP URI and the agent starts.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Dasha BlackBox Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://blackbox.dasha.ai/docs/api-reference/calls/register-inbound-call\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dasha-628f9d33.mintlify.site/_mintlify/api/og/v2?division=Calls\u0026amp;title=Register+inbound+call\u0026amp;description=Registers+an+inbound+call+that+your+telephony+already+holds+and+returns+the+SIP+destination+to+bridge+it+to.%0AUse+this+when+you+own+the+inbound+call+flow+and+dec\u0026amp;theme=8f648b54f3a39a57bca8af12\u0026amp;signature=14a1613e08c443c3183ab5e8d02b2f6c26d267e042fbb551d3b5c316fe3ecee5\">\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=\"Register inbound call - Dasha BlackBox Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Registers an inbound call that your telephony already holds and returns the SIP destination to bridge it to. Use this when you own the inbound call flow and decide per call which agent should answer. The call record is created up front with the supplied variables, so the call ID you receive here is the same ID on the result webhook, call results and recordings. Bridge the live call to the returned SIP URI and the agent starts.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dasha-628f9d33.mintlify.site/_mintlify/api/og/v2?division=Calls\u0026amp;title=Register+inbound+call\u0026amp;description=Registers+an+inbound+call+that+your+telephony+already+holds+and+returns+the+SIP+destination+to+bridge+it+to.%0AUse+this+when+you+own+the+inbound+call+flow+and+dec\u0026amp;theme=8f648b54f3a39a57bca8af12\u0026amp;signature=14a1613e08c443c3183ab5e8d02b2f6c26d267e042fbb551d3b5c316fe3ecee5\">\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/dasha-628f9d33/fTvoboiNZnitZ8gw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Dasha BlackBox Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4F46E5\">\u003clink data-mint-head rel=\"canonical\" href=\"https://blackbox.dasha.ai/docs/api-reference/calls/register-inbound-call\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/calls/register-inbound-call.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://blackbox.dasha.ai/#organization\",\"name\":\"Dasha BlackBox Documentation\",\"url\":\"https://blackbox.dasha.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dasha-628f9d33/OIOU150RbPNcpw0P/docs/logo-wordmark-light.svg?fit=max\u0026auto=format\u0026n=OIOU150RbPNcpw0P\u0026q=85\u0026s=d09a8bf9e3455eda1fccc003884b3cdf\"}},{\"@type\":\"WebSite\",\"@id\":\"https://blackbox.dasha.ai#website\",\"name\":\"Dasha BlackBox Documentation\",\"url\":\"https://blackbox.dasha.ai\",\"publisher\":{\"@id\":\"https://blackbox.dasha.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://blackbox.dasha.ai/docs/api-reference/calls/register-inbound-call#webpage\",\"url\":\"https://blackbox.dasha.ai/docs/api-reference/calls/register-inbound-call\",\"name\":\"Register inbound call\",\"description\":\"Registers an inbound call that your telephony already holds and returns the SIP destination to bridge it to. Use this when you own the inbound call flow and decide per call which agent should answer. The call record is created up front with the supplied variables, so the call ID you receive here is the same ID on the result webhook, call results and recordings. Bridge the live call to the returned SIP URI and the agent starts.\",\"dateModified\":\"2026-11-04T09:27:34.402Z\",\"isPartOf\":{\"@id\":\"https://blackbox.dasha.ai#website\"},\"breadcrumb\":{\"@id\":\"https://blackbox.dasha.ai/docs/api-reference/calls/register-inbound-call#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://blackbox.dasha.ai/docs/api-reference/calls/register-inbound-call#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Calls\",\"item\":\"https://blackbox.dasha.ai/docs/api-reference/calls/create-call\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Register inbound call\",\"item\":\"https://blackbox.dasha.ai/docs/api-reference/calls/register-inbound-call\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://blackbox.dasha.ai/docs/api-reference/calls/register-inbound-call#apireference\",\"headline\":\"Register inbound call\",\"name\":\"Register inbound call\",\"description\":\"Registers an inbound call that your telephony already holds and returns the SIP destination to bridge it to. Use this when you own the inbound call flow and decide per call which agent should answer. The call record is created up front with the supplied variables, so the call ID you receive here is the same ID on the result webhook, call results and recordings. Bridge the live call to the returned SIP URI and the agent starts.\",\"url\":\"https://blackbox.dasha.ai/docs/api-reference/calls/register-inbound-call\",\"mainEntityOfPage\":{\"@id\":\"https://blackbox.dasha.ai/docs/api-reference/calls/register-inbound-call#webpage\"},\"dateModified\":\"2026-11-04T09:27:34.402Z\",\"publisher\":{\"@id\":\"https://blackbox.dasha.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://blackbox.dasha.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Dasha BlackBox Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Dasha BlackBox Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/calls/register-inbound-call.md","siteName":"Dasha BlackBox Documentation","nav":{"global":{"anchors":[{"anchor":"Status","icon":"chart-line","href":"https://status.dasha.ai"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/docs/introduction/what-is-blackbox"}]},{"tab":"API Reference","groups":[{"group":"ActivityLogs","pages":[{"title":"Search activity log","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/activity-logs/search","href":"/docs/api-reference/activitylogs/search-activity-log"}]},{"group":"Agents","pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/agents","href":"/docs/api-reference/agents/list-agents"},{"title":"Create agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/agents","href":"/docs/api-reference/agents/create-agent"},{"title":"Get agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/agents/{agentId}","href":"/docs/api-reference/agents/get-agent"},{"title":"Update agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/agents/{agentId}","href":"/docs/api-reference/agents/update-agent"},{"title":"Delete agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/agents/{agentId}","href":"/docs/api-reference/agents/delete-agent"},{"title":"Clone agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/agents/{agentId}/clone","href":"/docs/api-reference/agents/clone-agent"},{"title":"Get agents linked to knowledge base","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/agents/knowledge-base/list","href":"/docs/api-reference/agents/get-agents-linked-to-knowledge-base"}]},{"group":"AgentTestCases","pages":[]},{"group":"AgentToolTestResults","pages":[]},{"group":"CallResults","pages":[{"title":"Search call results","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/callresults/search","href":"/docs/api-reference/callresults/search-call-results"}]},{"group":"Calls","pages":[{"title":"Create call","description":"Schedules a new outbound voice call with an AI agent. The system assigns a unique call ID\nand calculates the schedule time based on the provided deadline and timezone.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/calls","href":"/docs/api-reference/calls/create-call"},{"title":"Register inbound call","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/calls/register","href":"/docs/api-reference/calls/register-inbound-call"},{"title":"Create bulk calls","description":"Schedules multiple outbound voice calls with an AI agent in a single request.\nEach call receives a unique ID and calculated schedule time. This endpoint is optimized\nfor batch operations and campaign management.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/calls/bulk","href":"/docs/api-reference/calls/create-bulk-calls"},{"title":"Get call","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/calls/{callId}","href":"/docs/api-reference/calls/get-call"},{"title":"Cancel call","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/calls/{callId}","href":"/docs/api-reference/calls/cancel-call"},{"title":"Get call queue","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/calls/queue/list","href":"/docs/api-reference/calls/get-call-queue"},{"title":"Get call statistics","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/calls/statistics/statuses","href":"/docs/api-reference/calls/get-call-statistics"},{"title":"Get call recording","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/calls/media/{recordId}","href":"/docs/api-reference/calls/get-call-recording"},{"title":"Get SIP traces","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/calls/{callId}/sip-traces","href":"/docs/api-reference/calls/get-sip-traces"}]},{"group":"Chats","pages":[{"title":"List chat sessions matching the supplied filters.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/chats","href":"/docs/api-reference/chats/list-chat-sessions-matching-the-supplied-filters"},{"title":"Open a new chat session.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/chats","href":"/docs/api-reference/chats/open-a-new-chat-session"},{"title":"Submit one user turn to an existing chat session.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/chats/{id}/messages","href":"/docs/api-reference/chats/submit-one-user-turn-to-an-existing-chat-session"},{"title":"Retrieve a chat session — full transcript and lifecycle status.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/chats/{id}","href":"/docs/api-reference/chats/retrieve-a-chat-session-—-full-transcript-and-lifecycle-status"},{"title":"End a chat session under the `user_end` reason.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/chats/{id}/end","href":"/docs/api-reference/chats/end-a-chat-session-under-the-`user_end`-reason"}]},{"group":"Copilot","pages":[]},{"group":"CustomerData","pages":[]},{"group":"Mcp","pages":[{"title":"Verify MCP connection","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/mcp/verify","href":"/docs/api-reference/mcp/verify-mcp-connection"}]},{"group":"Media","pages":[{"title":"List media files","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/media","href":"/docs/api-reference/media/list-media-files"},{"title":"Upload media file","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/media","href":"/docs/api-reference/media/upload-media-file"},{"title":"Get media file","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/media/{id}","href":"/docs/api-reference/media/get-media-file"},{"title":"Delete media file","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/media/{id}","href":"/docs/api-reference/media/delete-media-file"},{"title":"Update media file","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json patch /api/v1/media/{id}","href":"/docs/api-reference/media/update-media-file"},{"title":"Download media file","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/media/{id}/download","href":"/docs/api-reference/media/download-media-file"},{"title":"Get agents using media","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/media/{id}/affected-agents","href":"/docs/api-reference/media/get-agents-using-media"}]},{"group":"Misc","pages":[{"title":"Get server configuration","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc","href":"/docs/api-reference/misc/get-server-configuration"},{"title":"Get current organization","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/me","href":"/docs/api-reference/misc/get-current-organization"},{"title":"Get concurrency limits","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/concurrency","href":"/docs/api-reference/misc/get-concurrency-limits"},{"title":"Get agent template","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/agent-initial-data","href":"/docs/api-reference/misc/get-agent-template"},{"title":"List predefined background sounds","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/background-sounds","href":"/docs/api-reference/misc/list-predefined-background-sounds"},{"title":"List predefined builtin media","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/builtin-media","href":"/docs/api-reference/misc/list-predefined-builtin-media"},{"title":"List predefined built-in tools","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/builtin-tools","href":"/docs/api-reference/misc/list-predefined-built-in-tools"},{"title":"Get platform capabilities","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/capabilities","href":"/docs/api-reference/misc/get-platform-capabilities"},{"title":"Get capabilities of available models","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/misc/capabilities","href":"/docs/api-reference/misc/get-capabilities-of-available-models"}]},{"group":"OpsDashboard","pages":[]},{"group":"PronunciationDictionaries","pages":[{"title":"List pronunciation dictionaries","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/pronunciation-dictionaries","href":"/docs/api-reference/pronunciationdictionaries/list-pronunciation-dictionaries"},{"title":"Create pronunciation dictionary","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/pronunciation-dictionaries","href":"/docs/api-reference/pronunciationdictionaries/create-pronunciation-dictionary"},{"title":"Get pronunciation dictionary","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/pronunciation-dictionaries/{providerId}","href":"/docs/api-reference/pronunciationdictionaries/get-pronunciation-dictionary"},{"title":"Delete pronunciation dictionary","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/pronunciation-dictionaries/{providerId}","href":"/docs/api-reference/pronunciationdictionaries/delete-pronunciation-dictionary"},{"title":"Add pronunciation rules","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/pronunciation-dictionaries/{providerId}/add-rules","href":"/docs/api-reference/pronunciationdictionaries/add-pronunciation-rules"},{"title":"Remove pronunciation rules","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/pronunciation-dictionaries/{providerId}/remove-rules","href":"/docs/api-reference/pronunciationdictionaries/remove-pronunciation-rules"},{"title":"Get agents using pronunciation dictionary","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/pronunciation-dictionaries/{providerId}/affected-agents","href":"/docs/api-reference/pronunciationdictionaries/get-agents-using-pronunciation-dictionary"}]},{"group":"Providers","pages":[{"title":"List providers","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/providers","href":"/docs/api-reference/providers/list-providers"},{"title":"Get provider","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/providers/{id}","href":"/docs/api-reference/providers/get-provider"},{"title":"Delete provider","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/providers/{id}","href":"/docs/api-reference/providers/delete-provider"},{"title":"Verify provider","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/providers/{id}/verify","href":"/docs/api-reference/providers/verify-provider"}]},{"group":"SipAliases","pages":[]},{"group":"SipCredentials","pages":[{"title":"List SIP credentials","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-credentials","href":"/docs/api-reference/sipcredentials/list-sip-credentials"},{"title":"Create SIP credential","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/sip-credentials","href":"/docs/api-reference/sipcredentials/create-sip-credential"},{"title":"Get SIP credential","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-credentials/{id}","href":"/docs/api-reference/sipcredentials/get-sip-credential"},{"title":"Update SIP credential","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/sip-credentials/{id}","href":"/docs/api-reference/sipcredentials/update-sip-credential"},{"title":"Delete SIP credential","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/sip-credentials/{id}","href":"/docs/api-reference/sipcredentials/delete-sip-credential"},{"title":"Get agents using SIP credential","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-credentials/{id}/affected-agents","href":"/docs/api-reference/sipcredentials/get-agents-using-sip-credential"}]},{"group":"SipDomains","pages":[{"title":"List custom SIP domains","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-domains","href":"/docs/api-reference/sipdomains/list-custom-sip-domains"},{"title":"Add custom SIP domain","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/sip-domains","href":"/docs/api-reference/sipdomains/add-custom-sip-domain"},{"title":"Get custom SIP domain","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-domains/{id}","href":"/docs/api-reference/sipdomains/get-custom-sip-domain"},{"title":"Delete custom SIP domain","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/sip-domains/{id}","href":"/docs/api-reference/sipdomains/delete-custom-sip-domain"},{"title":"Update inbound routing of a custom SIP domain","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json patch /api/v1/sip-domains/{id}","href":"/docs/api-reference/sipdomains/update-inbound-routing-of-a-custom-sip-domain"},{"title":"Verify custom SIP domain","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/sip-domains/{id}/verify","href":"/docs/api-reference/sipdomains/verify-custom-sip-domain"}]},{"group":"SipPhoneNumbers","pages":[{"title":"List phone numbers","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-phone-numbers","href":"/docs/api-reference/sipphonenumbers/list-phone-numbers"},{"title":"Create phone number","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/sip-phone-numbers","href":"/docs/api-reference/sipphonenumbers/create-phone-number"},{"title":"Get phone number","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-phone-numbers/{id}","href":"/docs/api-reference/sipphonenumbers/get-phone-number"},{"title":"Update phone number","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/sip-phone-numbers/{id}","href":"/docs/api-reference/sipphonenumbers/update-phone-number"},{"title":"Delete phone number","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/sip-phone-numbers/{id}","href":"/docs/api-reference/sipphonenumbers/delete-phone-number"},{"title":"Link phone number to agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/sip-phone-numbers/{id}/agent-link","href":"/docs/api-reference/sipphonenumbers/link-phone-number-to-agent"},{"title":"Unlink phone number from agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/sip-phone-numbers/{id}/agent-link","href":"/docs/api-reference/sipphonenumbers/unlink-phone-number-from-agent"},{"title":"Get agents using phone number","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/sip-phone-numbers/{id}/affected-agents","href":"/docs/api-reference/sipphonenumbers/get-agents-using-phone-number"}]},{"group":"SipRegisterCallWebhook","pages":[]},{"group":"TextChat","pages":[{"title":"Run one stateless text-chat completion turn.","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/text-chat/completion","href":"/docs/api-reference/textchat/run-one-stateless-text-chat-completion-turn"}]},{"group":"TwilioProvider","pages":[{"title":"Get Twilio provider","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/providers/twilio/{id}","href":"/docs/api-reference/twilioprovider/get-twilio-provider"},{"title":"Update Twilio provider","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/providers/twilio/{id}","href":"/docs/api-reference/twilioprovider/update-twilio-provider"},{"title":"Create Twilio provider","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/providers/twilio","href":"/docs/api-reference/twilioprovider/create-twilio-provider"},{"title":"Update Auth Token","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json patch /api/v1/providers/twilio/{id}/auth-token","href":"/docs/api-reference/twilioprovider/update-auth-token"},{"title":"List available phone numbers","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/providers/twilio/{id}/available-numbers","href":"/docs/api-reference/twilioprovider/list-available-phone-numbers"},{"title":"Import phone numbers","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/providers/twilio/{id}/import-numbers","href":"/docs/api-reference/twilioprovider/import-phone-numbers"},{"title":"Remove phone number","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/providers/twilio/{id}/phone-numbers/{phoneNumberId}","href":"/docs/api-reference/twilioprovider/remove-phone-number"}]},{"group":"Voice","pages":[{"title":"List available voices","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/voice","href":"/docs/api-reference/voice/list-available-voices"},{"title":"Synthesize text to speech","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/voice/synthesize","href":"/docs/api-reference/voice/synthesize-text-to-speech"},{"title":"Get built-in sound audio","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/voice/builtin-media","href":"/docs/api-reference/voice/get-built-in-sound-audio"},{"title":"Clone voice from audio","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/voice/clone","href":"/docs/api-reference/voice/clone-voice-from-audio"},{"title":"Delete cloned voice","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/voice/clone/{voiceId}","href":"/docs/api-reference/voice/delete-cloned-voice"},{"title":"Update cloned voice","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json patch /api/v1/voice/clone/{voiceId}","href":"/docs/api-reference/voice/update-cloned-voice"}]},{"group":"WebhookTest","pages":[{"title":"Test webhook endpoint","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/webhooks/test","href":"/docs/api-reference/webhooktest/test-webhook-endpoint"}]},{"group":"WebIntegrations","pages":[{"title":"List web integrations","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/web-integrations","href":"/docs/api-reference/webintegrations/list-web-integrations"},{"title":"Update web integration","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/web-integrations","href":"/docs/api-reference/webintegrations/update-web-integration"},{"title":"Create web integration","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/web-integrations","href":"/docs/api-reference/webintegrations/create-web-integration"},{"title":"Get web integrations by agent","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/web-integrations/agent","href":"/docs/api-reference/webintegrations/get-web-integrations-by-agent"},{"title":"Get web integration","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/web-integrations/integration","href":"/docs/api-reference/webintegrations/get-web-integration"},{"title":"Delete web integration","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/web-integrations/{integrationId}","href":"/docs/api-reference/webintegrations/delete-web-integration"},{"title":"Create integration token","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/web-integrations/{integrationId}/tokens","href":"/docs/api-reference/webintegrations/create-integration-token"},{"title":"Delete integration token","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/web-integrations/{integrationId}/tokens/{tokenId}","href":"/docs/api-reference/webintegrations/delete-integration-token"},{"title":"Validate integration token","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/web-integrations/discover","href":"/docs/api-reference/webintegrations/validate-integration-token"}]},{"group":"WebSocket","pages":[{"title":"WebSocket endpoint for web calls","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/ws/webCall","href":"/docs/api-reference/websocket/websocket-endpoint-for-web-calls"},{"title":"Get WebSocket endpoint information","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/ws/info","href":"/docs/api-reference/websocket/get-websocket-endpoint-information"}]},{"group":"Document","pages":[{"title":"List documents in a knowledge base","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/document","href":"/docs/api-reference/document/list-documents-in-a-knowledge-base"},{"title":"Upload a document to a knowledge base","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/rag/document","href":"/docs/api-reference/document/upload-a-document-to-a-knowledge-base"},{"title":"Get document details with status","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/document/{id}","href":"/docs/api-reference/document/get-document-details-with-status"},{"title":"Update a document content in KB","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/rag/document/{id}","href":"/docs/api-reference/document/update-a-document-content-in-kb"},{"title":"Delete a document","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/rag/document/{id}","href":"/docs/api-reference/document/delete-a-document"},{"title":"Get document chunks","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/document/{id}/chunks","href":"/docs/api-reference/document/get-document-chunks"},{"title":"Get document chunk information","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/document/chunks/{chunkId}","href":"/docs/api-reference/document/get-document-chunk-information"},{"title":"Download document content","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/document/{id}/download","href":"/docs/api-reference/document/download-document-content"}]},{"group":"KnowledgeBase","pages":[{"title":"Get all knowledge","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/kb","href":"/docs/api-reference/knowledgebase/get-all-knowledge"},{"title":"Create a new knowledge base","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/rag/kb","href":"/docs/api-reference/knowledgebase/create-a-new-knowledge-base"},{"title":"Get knowledge base details with statistics","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/kb/{id}","href":"/docs/api-reference/knowledgebase/get-knowledge-base-details-with-statistics"},{"title":"Update knowledge base settings","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/rag/kb/{id}","href":"/docs/api-reference/knowledgebase/update-knowledge-base-settings"},{"title":"Delete a knowledge base and all its content","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/rag/kb/{id}","href":"/docs/api-reference/knowledgebase/delete-a-knowledge-base-and-all-its-content"}]},{"group":"KnowledgeBaseSource","pages":[{"title":"List the URL sources of a knowledge base","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/kb/{kbId}/sources","href":"/docs/api-reference/knowledgebasesource/list-the-url-sources-of-a-knowledge-base"},{"title":"Add a URL source to a knowledge base","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/rag/kb/{kbId}/sources","href":"/docs/api-reference/knowledgebasesource/add-a-url-source-to-a-knowledge-base"},{"title":"Get a URL source","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/kb/{kbId}/sources/{sourceId}","href":"/docs/api-reference/knowledgebasesource/get-a-url-source"},{"title":"Update the settings of a URL source","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/rag/kb/{kbId}/sources/{sourceId}","href":"/docs/api-reference/knowledgebasesource/update-the-settings-of-a-url-source"},{"title":"Remove a URL source","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json delete /api/v1/rag/kb/{kbId}/sources/{sourceId}","href":"/docs/api-reference/knowledgebasesource/remove-a-url-source"},{"title":"Crawl a URL source now","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/rag/kb/{kbId}/sources/{sourceId}/crawl","href":"/docs/api-reference/knowledgebasesource/crawl-a-url-source-now"},{"title":"List the pages of a URL source","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/kb/{kbId}/sources/{sourceId}/pages","href":"/docs/api-reference/knowledgebasesource/list-the-pages-of-a-url-source"},{"title":"Get the page usage of all URL sources","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/sources/usage","href":"/docs/api-reference/knowledgebasesource/get-the-page-usage-of-all-url-sources"}]},{"group":"Search","pages":[{"title":"Search within a multi knowledge bases","deprecated":null,"version":null,"openapi":"https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/rag/search","href":"/docs/api-reference/search/search-within-a-multi-knowledge-bases"}]}]}]},"basePath":"","title":"Register inbound call - Dasha BlackBox Documentation","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}