Responses are generated using AI and may contain mistakes.
Bland is getting a major upgrade. We're working on updating our docs as users transition in the coming weeks. Reach out to support@bland.ai with questions.
{ "data": { "status": "processing", "message": "SMS accepted for delivery. Check status of SMS with the message_id", "conversation_id": "convo_abc123", "message_id": "0c9d8e7f-6a5b-4c3d-9e8f-7a6b5c4d3e2f" }, "errors": null}
{ "data": null, "errors": [ { "error": "CHANNEL_DISABLED", "message": "Messages are turned off for this agent." } ]}
SMS is available on Enterprise plans and on the Agent Phone Plan. WhatsApp and iMessage are Enterprise only. Contact your Bland representative for Enterprise access.
Headers
string
required
Your API key for authentication.
string
A unique key to prevent duplicate message sends. When provided, repeated requests with the same key will return successfully but will not send an additional message or incur extra charges. Useful for safely retrying failed requests without risk of double-sending.
Body Parameters
string
required
The E.164 formatted phone number of the user receiving the message.
string
required
The E.164 formatted phone number used to send the message (must belong to the authenticated account).
string
The content of the SMS message to send. If not passed in, the message is generated from the conversation’s pathway, persona, or objective, or from the number’s prompt.
string
The goal of this conversation, for example “Book a haircut for Tuesday afternoon and confirm the price.” Replies in the conversation are generated from it instead of the number’s prompt, and so is the first message when you omit agent_message. Up to 20,000 characters.A later send to the same conversation with a new objective replaces it, and a send without one keeps it. Set new_conversation to true to start a thread without it. A persona_id or pathway_id, on the request or on the number, takes priority: those replies don’t use the objective. So does a V2 agent attached to the number.An objective that is not a string, is empty, or is longer than 20,000 characters is rejected with a 400 and error code INVALID_OBJECTIVE.
object
Optional metadata to associate with the conversation or message. Used for custom routing or analytics.
boolean
Allows you to create a new conversation, archiving the existing conversation and ignores existing sms messages.
string
UUID of a persona to use for this conversation. When provided, the persona’s configuration is applied instead of the number’s SMS config. Use persona_version to select which version to use.Cannot be used as a substitute for agent_number. The agent number must still belong to your account. The persona_id controls how the conversation is handled, not which number sends it.
The send also assigns agent_number to this persona, and the assignment stays after the send. Later texts and calls to the number run the persona. If the number was attached to a V2 agent, it no longer runs that agent. To text from an agent, attach the number to the agent and omit persona_id. See V2 agents.
string
Which version of the persona to use. Allowed values: "production" (default), "draft".
object
Per-dispatch persona overrides. Takes priority over any pathway settings on the persona version or the pathway_id field below.
Show persona_settings object
string
Override the persona’s pathway for this dispatch.
number
Specific version of the override pathway to use.
string
Specific node to start from within the override pathway.
string
ID of the pathway to use for generating the SMS response. If persona_id is provided, this is used as a pathway override within the persona context (lower priority than persona_settings).On a number attached to a V2 agent, replies run the agent, not this pathway. If this pathway has a migration split, a new conversation can run on the split’s agent instead. See V2 agents.
number
Version of the pathway to use.
string
ID of the specific node within the pathway to start from.
string
This overrides the webhook for the conversation, instead of using the webhook attached to the phone number.
object
Custom metadata to attach to the conversation. This data is returned in all webhook payloads (message and status webhooks), making it useful for correlating conversations with your internal systems.
string[]
An array of outcome IDs to run when the conversation ends. If omitted, the outcomes configured on the SMS number are used. If provided, overrides the number’s configuration. See Outcomes for details.Not applied on a conversation that runs a V2 agent: the API drops these IDs without an error. The agent’s Dispositions run instead.
string[]
An array of citation schema IDs to extract when the conversation ends. If omitted, the citation schemas configured on the SMS number are used. If provided, overrides the number’s configuration. See Citations for details.Not applied on a conversation that runs a V2 agent: the API drops these IDs without an error.
string
The channel to send the message on. Defaults to “sms”.
Allowed values: “sms”, “whatsapp”, “imessage”.For numbers provisioned for iMessage, the channel is auto-derived from the number’s configuration, so you don’t need to set this explicitly. See iMessage for details.
string
The Twilio SID of the content to send, usually in HXXXX format.
object
The variables to send with the content.
Example:
{ "1": "John", "2": "Smith", "3": "Premium Plan"}
number
Per-conversation timeout override, in seconds. When the user goes silent for this long after an agent message, the timeout flow fires (warning message and/or conversation end). Takes priority over the time_out on the number’s sms_config/whatsapp_config. Persists on the conversation, so subsequent turns use the same override until another /send or /create replaces it.
string
Per-conversation override for the message sent when the timeout fires. Takes priority over timeout_message on sms_config/whatsapp_config.
number
Per-conversation override for how long, in seconds, to wait before sending the warning message. Must be less than time_out; the request is rejected with INVALID_TIMEOUT_CONFIG otherwise. Takes priority over warning_time on sms_config/whatsapp_config.
string
Per-conversation override for the warning message sent at warning_time. Takes priority over warning_message on sms_config/whatsapp_config.
V2 agents
This endpoint has no agent_id parameter, and it ignores one if you pass it. A conversation runs a V2 agent in these cases:
The number is attached to the agent. Attach agent_number with Attach Numbers to Agent or in the dashboard (Put an agent on a phone number). Replies on the number then run the agent, even when the request includes a pathway_id.
A migration split routes the pathway. If the pathway the send would run has a migration split, a new conversation can run on the split’s agent, at its production version, with no change to your request. That pathway is pathway_id. When you omit it, it’s the pathway in the number’s config for the channel, or else the number’s voice pathway. The split doesn’t apply when the request has a persona_id, when the number has an agent or persona attached, or when the key isn’t an organization API key. Under the split’s default honor policy, a request that sets pathway_version or start_node_id stays on the pathway. A conversation that was already active keeps the pathway it started on, and a split never routes to an agent whose Messages channel is off. Splits apply to this endpoint only. They don’t apply to Send SMS Batch, Create SMS Conversation, or a conversation that your customer starts by texting the number.
A conversation is recorded as an agent conversation when it’s created. On that conversation, disposition_ids and citation_schema_ids don’t run, and the status webhook sent when it ends carries agent_id, agent_version_id, and agent_dispositions instead of citations and dispositions. See On a V2 agent conversation. A conversation that was already active when you attached the number isn’t recorded as an agent conversation, so its analysis and webhook shape stay V1. Set new_conversation to true to start a new one.If the number is attached to an agent whose Messages channel is turned off, for the agent or for this number, the request fails with 403 and error code CHANNEL_DISABLED.
Response
object
An object confirming the message was accepted for delivery.
string
"processing". The message is sent asynchronously after the response.
string
Confirmation text for the accepted send.
string
ID of the conversation that was created or resumed.
string
ID of the message, to track its delivery and status. Returned only when the request includes agent_message or content_sid.
null|array
null on success, or a list of error objects if the request failed.
{ "data": { "status": "processing", "message": "SMS accepted for delivery. Check status of SMS with the message_id", "conversation_id": "convo_abc123", "message_id": "0c9d8e7f-6a5b-4c3d-9e8f-7a6b5c4d3e2f" }, "errors": null}
{ "data": null, "errors": [ { "error": "CHANNEL_DISABLED", "message": "Messages are turned off for this agent." } ]}
{ "data": { "status": "processing", "message": "SMS accepted for delivery. Check status of SMS with the message_id", "conversation_id": "convo_abc123", "message_id": "0c9d8e7f-6a5b-4c3d-9e8f-7a6b5c4d3e2f" }, "errors": null}
{ "data": null, "errors": [ { "error": "CHANNEL_DISABLED", "message": "Messages are turned off for this agent." } ]}
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Bland","colors":{"primary":"#CA071A","light":"#FFFDF6","dark":"#151515"},"logo":{"light":"https://mintcdn.com/blandai/ccT390llWRoa5cok/logo/light.svg?fit=max\u0026auto=format\u0026n=ccT390llWRoa5cok\u0026q=85\u0026s=c9e5f30d1a8880ad00ef715c1ffa2215","dark":"https://mintcdn.com/blandai/ccT390llWRoa5cok/logo/dark.svg?fit=max\u0026auto=format\u0026n=ccT390llWRoa5cok\u0026q=85\u0026s=be3890a932c8cd55b89ac9df2d018955"},"favicon":"https://mintcdn.com/blandai/7XcPgtv7sOmwQOkQ/favicon.png?fit=max\u0026auto=format\u0026n=7XcPgtv7sOmwQOkQ\u0026q=85\u0026s=03a241cc1c1162995574df4a2166b331","background":{"color":{"light":"#FFFDF5","dark":"#151515"}},"navbar":{"links":[{"href":"https://app.bland.ai/dashboard/support","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.bland.ai"}},"footer":{"socials":{"twitter":"https://twitter.com/usebland","linkedin":"https://www.linkedin.com/company/bland-ai","discord":"https://discord.gg/QvxDz8zcKe"}},"seo":{"indexing":"all"},"banner":{"content":"Bland is getting a major upgrade. We're working on updating our docs as users transition in the coming weeks. Reach out to [support@bland.ai](mailto:support@bland.ai) with questions.","dismissible":true},"contextual":{"options":["copy","view","claude","chatgpt","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Community","icon":"discord","href":"https://discord.gg/QvxDz8zcKe"},{"anchor":"Submit a support ticket","icon":"ticket","href":"https://app.bland.ai/dashboard/support"},{"anchor":"Blog","icon":"newspaper","href":"https://www.bland.ai/blog"},{"anchor":"Enterprise inquiries","icon":"building","href":"https://www.bland.ai/book-a-demo"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"blandai","hasAudioNarration":false,"actualSubdomain":"blandai","customDomains":["docs.bland.ai"],"gitSource":{"type":"github","owner":"cintellilabs","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afe3611adae57dec40a9663","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Voice Agents","count":519},{"language":"default","tag":"API Reference","count":421},{"language":"default","tag":"Legacy","count":104},{"language":"default","tag":"Documentation","count":98},{"language":"default","tag":"Changelog","count":50},{"language":"default","tag":"Change Log","count":50},{"language":"default","tag":"TTS","count":42},{"language":"default","tag":"Evals","count":36},{"language":"default","tag":"Dispositions","count":31},{"language":"default","tag":"Triage","count":26}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx3cwhsk.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxTcwhsk.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxPcwhsk.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx_cwhsk.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx7cwhsk.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxDcwg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx3cwhsk.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxTcwhsk.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxPcwhsk.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx_cwhsk.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx7cwhsk.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxDcwg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx3cwhsk.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxTcwhsk.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxPcwhsk.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx_cwhsk.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx7cwhsk.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxDcwg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n.card h2+.prose{margin-top:0.75rem}#content-area #header .mt-2 p{font-size:1rem}:root{--splash-font-display: ui-sans-serif, -apple-system, \"Segoe UI\", system-ui, sans-serif;--splash-font-mono: 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, monospace}.splash-display{font-family:var(--splash-font-display)}.splash-mono{font-family:var(--splash-font-mono)}@keyframes splash-settle{from{opacity:0;transform:scale(0.86)}to{opacity:1;transform:none}}@keyframes splash-breathe{0%,38%{opacity:1}50%,76%{opacity:0}88%,100%{opacity:1}}@media (prefers-reduced-motion: no-preference){.splash-settle{animation:splash-settle 380ms cubic-bezier(0.22, 0.61, 0.36, 1) both;transform-origin:center}.splash-breathe{animation:splash-breathe var(--splash-breathe-dur, 19s) ease-in-out infinite;animation-delay:var(--splash-breathe-delay, 0s)}.splash-cell{transition:transform 240ms cubic-bezier(0.22, 0.61, 0.36, 1)}.splash-cell:hover{transform:scale(1.09);z-index:1}}.splash-frame-a,.splash-diffuse{display:none}.splash-ballast-inset{padding-left:1.5rem;padding-right:1.5rem}.splash-ballast-herotext{padding-top:4rem;padding-bottom:3.5rem}@media (max-width: 1023px){.splash-ballast-herotext{padding-top:calc(4rem + 96px)}}.splash-ballast-h1{font-size:40px;line-height:1.06}@media (min-width: 1152px){.splash-display{--splash-module: clamp(48px, calc((100vw - 1472px) / 12 + 6px), 72px)}.splash-frame-a{display:grid;grid-template-columns:repeat(72, var(--splash-module));grid-template-rows:repeat(8, var(--splash-module))}.splash-diffuse{display:none;grid-template-columns:repeat(72, var(--splash-module));grid-auto-rows:var(--splash-module)}.splash-ballast-inset{padding-left:max(calc(var(--splash-module) * 6), calc((100% - 1472px) / 2 + 48px));padding-right:max(1.5rem, calc((100% - 1472px) / 2 + 48px))}.splash-ballast-hero{height:calc(var(--splash-module) * 3.94 + 322px)}.splash-ballast-herotext{padding-top:calc(var(--splash-module) * 3.94);padding-bottom:0}.splash-ballast-h1{font-size:58px;line-height:62px}}body:has(.splash-display) header .backdrop-blur{backdrop-filter:none;-webkit-backdrop-filter:none}#sidebar-content{background:#FFFDF5;border-right:1px solid #1515150f;width:var(--sidebar-w)}:root{--sidebar-w: 248px}@media (min-width: 1024px){#body-content{padding-left:var(--sidebar-w)}}:root[class~=\"dark\"] #sidebar-content,.dark #sidebar-content{background:#0f0f0f;border-right-color:#ffffff12}#navigation-items{padding-left:1.25rem;padding-right:1rem;padding-top:1.5rem}#sidebar-content a{font-size:13.5px;line-height:1.35;padding-top:5px;padding-bottom:5px}#navigation-items{padding-left:0.75rem}#navigation-items [class*=\"scroll-area-fade-size\"]{padding-left:0;padding-right:0}#sidebar-content h5,#sidebar-content [class*=\"font-semibold\"]:not(a){font-size:11px;letter-spacing:0.06em;text-transform:uppercase;opacity:0.55;margin-top:1.5rem;margin-bottom:0.35rem}#navigation-items{scrollbar-width:thin;scrollbar-color:transparent transparent}#navigation-items:hover{scrollbar-color:#15151526 transparent}@media (min-width: 1024px){.splash-display{--splash-module: clamp(30px, calc((100vw - var(--sidebar-w) - 96px) / 26), 72px)}.splash-ballast-inset{padding-left:3rem;padding-right:3rem}.splash-ballast-inset.splash-ballast-herotext{padding-left:calc(var(--splash-module) * 6)}}@media (min-width: 1024px){.splash-ballast-inset [class*=\"grid-cols\"]{max-width:1180px}}@media (min-width: 1600px){.splash-display{--splash-module: clamp(30px, min(\n calc((100vw - var(--sidebar-w) - 96px) / 26),\n calc((100vw - 1540px) / 10)\n ), 72px)}.splash-ballast-inset{max-width:1276px;margin-inline:auto}.splash-ballast-inset.splash-ballast-herotext{padding-left:48px}}@media (min-width: 1024px){.splash-display{--splash-rule-gap: 64px}.splash-ballast-hero{height:auto}.splash-ballast-inset.splash-ballast-herotext{padding-bottom:var(--splash-rule-gap)}.splash-ballast-inset[class*=\"py-12\"]{padding-top:var(--splash-rule-gap)}}"}]}
{"page":{"pagePath":"api-v1/post/sms-send","slug":"/api-v1/post/sms-send","pageMetadata":{"title":"Send SMS Message","api":"POST https://api.bland.ai/v1/sms/send","description":"Send an SMS message from an agent to a user. This creates or resumes a conversation and triggers processing workflows.","href":"/api-v1/post/sms-send"},"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: \"Send an SMS message from an agent to a user. This creates or resumes a conversation and triggers processing workflows.\"\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={a:`a`,code:`code`,em:`em`,hr:`hr`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Info,ParamField,ResponseField,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(_components.p,{children:[`SMS is available on Enterprise plans and on the `,_jsx(_components.a,{href:`/platform/agent-phone-plan`,children:`Agent Phone Plan`}),`. WhatsApp and iMessage are Enterprise only. Contact your Bland representative for Enterprise access.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`authorization`,type:`string`,required:true,id:`param-authorization`,children:_jsx(_components.p,{children:`Your API key for authentication.`})}),`\n`,_jsx(ParamField,{header:`idempotency-key`,type:`string`,required:false,id:`param-idempotency-key`,children:_jsx(_components.p,{children:`A unique key to prevent duplicate message sends. When provided, repeated requests with the same key will return successfully but will not send an additional message or incur extra charges. Useful for safely retrying failed requests without risk of double-sending.`})}),`\n`,_jsx(Heading,{level:`3`,id:`body-parameters`,children:`Body Parameters`}),`\n`,_jsx(ParamField,{body:`user_number`,type:`string`,required:true,id:`param-user-number`,children:_jsx(_components.p,{children:`The E.164 formatted phone number of the user receiving the message.`})}),`\n`,_jsx(ParamField,{body:`agent_number`,type:`string`,required:true,id:`param-agent-number`,children:_jsx(_components.p,{children:`The E.164 formatted phone number used to send the message (must belong to the authenticated account).`})}),`\n`,_jsx(ParamField,{body:`agent_message`,type:`string`,id:`param-agent-message`,children:_jsxs(_components.p,{children:[`The content of the SMS message to send. If not passed in, the message is generated from the conversation’s pathway, persona, or `,_jsx(_components.code,{children:`objective`}),`, or from the number’s prompt.`]})}),`\n`,_jsxs(ParamField,{body:`objective`,type:`string`,required:false,id:`param-objective`,children:[_jsxs(_components.p,{children:[`The goal of this conversation, for example “Book a haircut for Tuesday afternoon and confirm the price.” Replies in the conversation are generated from it instead of the number’s prompt, and so is the first message when you omit `,_jsx(_components.code,{children:`agent_message`}),`. Up to 20,000 characters.`]}),_jsxs(_components.p,{children:[`A later send to the same conversation with a new `,_jsx(_components.code,{children:`objective`}),` replaces it, and a send without one keeps it. Set `,_jsx(_components.code,{children:`new_conversation`}),` to `,_jsx(_components.code,{children:`true`}),` to start a thread without it. A `,_jsx(_components.code,{children:`persona_id`}),` or `,_jsx(_components.code,{children:`pathway_id`}),`, on the request or on the number, takes priority: those replies don’t use the objective. So does a V2 agent attached to the number.`]}),_jsxs(_components.p,{children:[`An objective that is not a string, is empty, or is longer than 20,000 characters is rejected with a `,_jsx(_components.code,{children:`400`}),` and error code `,_jsx(_components.code,{children:`INVALID_OBJECTIVE`}),`.`]})]}),`\n`,_jsx(ParamField,{body:`request_data`,type:`object`,required:false,id:`param-request-data`,children:_jsx(_components.p,{children:`Optional metadata to associate with the conversation or message. Used for custom routing or analytics.`})}),`\n`,_jsx(ParamField,{body:`new_conversation`,type:`boolean`,required:false,id:`param-new-conversation`,children:_jsx(_components.p,{children:`Allows you to create a new conversation, archiving the existing conversation and ignores existing sms messages.`})}),`\n`,_jsxs(ParamField,{body:`persona_id`,type:`string`,required:false,id:`param-persona-id`,children:[_jsxs(_components.p,{children:[`UUID of a persona to use for this conversation. When provided, the persona’s configuration is applied instead of the number’s SMS config. Use `,_jsx(_components.code,{children:`persona_version`}),` to select which version to use.`]}),_jsxs(_components.p,{children:[`Cannot be used as a substitute for `,_jsx(_components.code,{children:`agent_number`}),`. The agent number must still belong to your account. The persona_id controls `,_jsx(_components.em,{children:`how`}),` the conversation is handled, not `,_jsx(_components.em,{children:`which number`}),` sends it.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`The send also assigns `,_jsx(_components.code,{children:`agent_number`}),` to this persona, and the assignment stays after the send. Later texts and calls to the number run the persona. If the number was attached to a V2 agent, it no longer runs that agent. To text from an agent, attach the number to the agent and omit `,_jsx(_components.code,{children:`persona_id`}),`. See `,_jsx(_components.a,{href:`#v2-agents`,children:`V2 agents`}),`.`]})})]}),`\n`,_jsx(ParamField,{body:`persona_version`,type:`string`,required:false,id:`param-persona-version`,children:_jsxs(_components.p,{children:[`Which version of the persona to use. Allowed values: `,_jsx(_components.code,{children:`\"production\"`}),` (default), `,_jsx(_components.code,{children:`\"draft\"`}),`.`]})}),`\n`,_jsxs(ParamField,{body:`persona_settings`,type:`object`,required:false,id:`param-persona-settings`,children:[_jsxs(_components.p,{children:[`Per-dispatch persona overrides. Takes priority over any pathway settings on the persona version or the `,_jsx(_components.code,{children:`pathway_id`}),` field below.`]}),_jsxs(Expandable,{title:`persona_settings object`,children:[_jsx(ParamField,{body:`pathway_id`,type:`string`,id:`param-pathway-id`,children:_jsx(_components.p,{children:`Override the persona’s pathway for this dispatch.`})}),_jsx(ParamField,{body:`pathway_version`,type:`number`,id:`param-pathway-version`,children:_jsx(_components.p,{children:`Specific version of the override pathway to use.`})}),_jsx(ParamField,{body:`start_node_id`,type:`string`,id:`param-start-node-id`,children:_jsx(_components.p,{children:`Specific node to start from within the override pathway.`})})]})]}),`\n`,_jsxs(ParamField,{body:`pathway_id`,type:`string`,required:false,id:`param-pathway-id-1`,children:[_jsxs(_components.p,{children:[`ID of the pathway to use for generating the SMS response. If `,_jsx(_components.code,{children:`persona_id`}),` is provided, this is used as a pathway override within the persona context (lower priority than `,_jsx(_components.code,{children:`persona_settings`}),`).`]}),_jsxs(_components.p,{children:[`On a number attached to a V2 agent, replies run the agent, not this pathway. If this pathway has a migration split, a new conversation can run on the split’s agent instead. See `,_jsx(_components.a,{href:`#v2-agents`,children:`V2 agents`}),`.`]})]}),`\n`,_jsx(ParamField,{body:`pathway_version`,type:`number`,required:false,id:`param-pathway-version-1`,children:_jsx(_components.p,{children:`Version of the pathway to use.`})}),`\n`,_jsx(ParamField,{body:`start_node_id`,type:`string`,required:false,id:`param-start-node-id-1`,children:_jsx(_components.p,{children:`ID of the specific node within the pathway to start from.`})}),`\n`,_jsx(ParamField,{body:`webhook`,type:`string`,required:false,id:`param-webhook`,children:_jsx(_components.p,{children:`This overrides the webhook for the conversation, instead of using the webhook attached to the phone number.`})}),`\n`,_jsx(ParamField,{body:`metadata`,type:`object`,required:false,id:`param-metadata`,children:_jsx(_components.p,{children:`Custom metadata to attach to the conversation. This data is returned in all webhook payloads (message and status webhooks), making it useful for correlating conversations with your internal systems.`})}),`\n`,_jsxs(ParamField,{body:`disposition_ids`,type:`string[]`,required:false,id:`param-disposition-ids`,children:[_jsxs(_components.p,{children:[`An array of outcome IDs to run when the conversation ends. If omitted, the outcomes configured on the SMS number are used. If provided, overrides the number’s configuration. See `,_jsx(_components.a,{href:`/tutorials/outcomes`,children:`Outcomes`}),` for details.`]}),_jsxs(_components.p,{children:[`Not applied on a conversation that runs a V2 agent: the API drops these IDs without an error. The agent’s `,_jsx(_components.a,{href:`/agents/dispositions#coming-from-citations-and-outcomes`,children:`Dispositions`}),` run instead.`]})]}),`\n`,_jsxs(ParamField,{body:`citation_schema_ids`,type:`string[]`,required:false,id:`param-citation-schema-ids`,children:[_jsxs(_components.p,{children:[`An array of citation schema IDs to extract when the conversation ends. If omitted, the citation schemas configured on the SMS number are used. If provided, overrides the number’s configuration. See `,_jsx(_components.a,{href:`/enterprise-features/citations`,children:`Citations`}),` for details.`]}),_jsx(_components.p,{children:`Not applied on a conversation that runs a V2 agent: the API drops these IDs without an error.`})]}),`\n`,_jsxs(ParamField,{body:`channel`,type:`string`,required:false,id:`param-channel`,children:[_jsx(_components.p,{children:`The channel to send the message on. Defaults to “sms”.\nAllowed values: “sms”, “whatsapp”, “imessage”.`}),_jsxs(_components.p,{children:[`For numbers provisioned for iMessage, the channel is auto-derived from the number’s configuration, so you don’t need to set this explicitly. See `,_jsx(_components.a,{href:`/tutorials/messaging/imessage`,children:`iMessage`}),` for details.`]})]}),`\n`,_jsx(ParamField,{body:`content_sid`,type:`string`,required:false,id:`param-content-sid`,children:_jsx(_components.p,{children:`The Twilio SID of the content to send, usually in HXXXX format.`})}),`\n`,_jsxs(ParamField,{body:`content_variables`,type:`object`,required:false,id:`param-content-variables`,children:[_jsx(_components.p,{children:`The variables to send with the content.\nExample:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"John\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Smith\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"3\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Premium Plan\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(ParamField,{body:`time_out`,type:`number`,required:false,id:`param-time-out`,children:_jsxs(_components.p,{children:[`Per-conversation timeout override, in seconds. When the user goes silent for this long after an agent message, the timeout flow fires (warning message and/or conversation end). Takes priority over the `,_jsx(_components.code,{children:`time_out`}),` on the number’s sms_config/whatsapp_config. Persists on the conversation, so subsequent turns use the same override until another `,_jsx(_components.code,{children:`/send`}),` or `,_jsx(_components.code,{children:`/create`}),` replaces it.`]})}),`\n`,_jsx(ParamField,{body:`timeout_message`,type:`string`,required:false,id:`param-timeout-message`,children:_jsxs(_components.p,{children:[`Per-conversation override for the message sent when the timeout fires. Takes priority over `,_jsx(_components.code,{children:`timeout_message`}),` on sms_config/whatsapp_config.`]})}),`\n`,_jsx(ParamField,{body:`warning_time`,type:`number`,required:false,id:`param-warning-time`,children:_jsxs(_components.p,{children:[`Per-conversation override for how long, in seconds, to wait before sending the warning message. Must be less than `,_jsx(_components.code,{children:`time_out`}),`; the request is rejected with `,_jsx(_components.code,{children:`INVALID_TIMEOUT_CONFIG`}),` otherwise. Takes priority over `,_jsx(_components.code,{children:`warning_time`}),` on sms_config/whatsapp_config.`]})}),`\n`,_jsx(ParamField,{body:`warning_message`,type:`string`,required:false,id:`param-warning-message`,children:_jsxs(_components.p,{children:[`Per-conversation override for the warning message sent at `,_jsx(_components.code,{children:`warning_time`}),`. Takes priority over `,_jsx(_components.code,{children:`warning_message`}),` on sms_config/whatsapp_config.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`v2-agents`,children:`V2 agents`}),`\n`,_jsxs(_components.p,{children:[`This endpoint has no `,_jsx(_components.code,{children:`agent_id`}),` parameter, and it ignores one if you pass it. A conversation runs a V2 agent in these cases:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The number is attached to the agent.`}),` Attach `,_jsx(_components.code,{children:`agent_number`}),` with `,_jsx(_components.a,{href:`/api-v2/post/agents-id-inbound-attach`,children:`Attach Numbers to Agent`}),` or in the dashboard (`,_jsx(_components.a,{href:`/agents/dispatch#put-an-agent-on-a-phone-number`,children:`Put an agent on a phone number`}),`). Replies on the number then run the agent, even when the request includes a `,_jsx(_components.code,{children:`pathway_id`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A migration split routes the pathway.`}),` If the pathway the send would run has a `,_jsx(_components.a,{href:`/platform/migrate-api-integrations`,children:`migration split`}),`, a new conversation can run on the split’s agent, at its production version, with no change to your request. That pathway is `,_jsx(_components.code,{children:`pathway_id`}),`. When you omit it, it’s the pathway in the number’s config for the channel, or else the number’s voice pathway. The split doesn’t apply when the request has a `,_jsx(_components.code,{children:`persona_id`}),`, when the number has an agent or persona attached, or when the key isn’t an organization API key. Under the split’s default `,_jsx(_components.code,{children:`honor`}),` policy, a request that sets `,_jsx(_components.code,{children:`pathway_version`}),` or `,_jsx(_components.code,{children:`start_node_id`}),` stays on the pathway. A conversation that was already active keeps the pathway it started on, and a split never routes to an agent whose Messages channel is off. Splits apply to this endpoint only. They don’t apply to `,_jsx(_components.a,{href:`/api-v1/post/sms-batch`,children:`Send SMS Batch`}),`, `,_jsx(_components.a,{href:`/api-v1/post/sms-create`,children:`Create SMS Conversation`}),`, or a conversation that your customer starts by texting the number.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`A conversation is recorded as an agent conversation when it’s created. On that conversation, `,_jsx(_components.code,{children:`disposition_ids`}),` and `,_jsx(_components.code,{children:`citation_schema_ids`}),` don’t run, and the status webhook sent when it ends carries `,_jsx(_components.code,{children:`agent_id`}),`, `,_jsx(_components.code,{children:`agent_version_id`}),`, and `,_jsx(_components.code,{children:`agent_dispositions`}),` instead of `,_jsx(_components.code,{children:`citations`}),` and `,_jsx(_components.code,{children:`dispositions`}),`. See `,_jsx(_components.a,{href:`/tutorials/messaging/overview#on-a-v2-agent-conversation`,children:`On a V2 agent conversation`}),`. A conversation that was already active when you attached the number isn’t recorded as an agent conversation, so its analysis and webhook shape stay V1. Set `,_jsx(_components.code,{children:`new_conversation`}),` to `,_jsx(_components.code,{children:`true`}),` to start a new one.`]}),`\n`,_jsxs(_components.p,{children:[`If the number is attached to an agent whose Messages channel is turned off, for the agent or for this number, the request fails with `,_jsx(_components.code,{children:`403`}),` and error code `,_jsx(_components.code,{children:`CHANNEL_DISABLED`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,id:`param-data`,children:_jsx(_components.p,{children:`An object confirming the message was accepted for delivery.`})}),`\n`,_jsx(ResponseField,{name:`data.status`,type:`string`,id:`param-data-status`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`\"processing\"`}),`. The message is sent asynchronously after the response.`]})}),`\n`,_jsx(ResponseField,{name:`data.message`,type:`string`,id:`param-data-message`,children:_jsx(_components.p,{children:`Confirmation text for the accepted send.`})}),`\n`,_jsx(ResponseField,{name:`data.conversation_id`,type:`string`,id:`param-data-conversation-id`,children:_jsx(_components.p,{children:`ID of the conversation that was created or resumed.`})}),`\n`,_jsx(ResponseField,{name:`data.message_id`,type:`string`,id:`param-data-message-id`,children:_jsxs(_components.p,{children:[`ID of the message, to track its delivery and status. Returned only when the request includes `,_jsx(_components.code,{children:`agent_message`}),` or `,_jsx(_components.code,{children:`content_sid`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`errors`,type:`null|array`,id:`param-errors`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`null`}),` on success, or a list of error objects if the request failed.`]})}),`\n`,`\n`,_jsx(_components.hr,{}),`\n`,_jsxs(_components.p,{children:[`Docs for agents: `,_jsx(_components.a,{href:`/llms.txt`,children:`llms.txt`})]})]})}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":{"config":{},"pageMetadata":{"title":"Send SMS Message","api":"POST https://api.bland.ai/v1/sms/send","description":"Send an SMS message from an agent to a user. This creates or resumes a conversation and triggers processing workflows.","href":"/api-v1/post/sms-send"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[374,378,"Example,ResponseFiel"],[668,683,"Example)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingM"],[19212,19784,"_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`Response`,numberOfLines:`9`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"processing\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"SMS accepted for delivery. Check status of SMS with the message_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"conversation_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"convo_abc123\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0c9d8e7f-6a5b-4c3d-9e8f-7a6b5c4d3e2f\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"errors\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`403 CHANNEL_DISABLED`,numberOfLines:`9`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"errors\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CHANNEL_DISABLED\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Messages are turned off for this agent.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsxs(_components.p,{children:[`Docs for agents: `,_jsx(_components.a,{href:`/llms.txt`,children:`llms.txt`})]})]})}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.\")}"]]},"mdxExtracts":{"tableOfContents":[{"title":"Headers","slug":"headers","depth":3,"children":[]},{"title":"Body Parameters","slug":"body-parameters","depth":3,"children":[]},{"title":"V2 agents","slug":"v2-agents","depth":3,"children":[]},{"title":"Response","slug":"response","depth":3,"children":[]}],"codeExamples":{"response":{"type":"ResponseExample","children":[{"filename":"Response","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"9\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"processing\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"SMS accepted for delivery. Check status of SMS with the message_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"conversation_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"convo_abc123\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"0c9d8e7f-6a5b-4c3d-9e8f-7a6b5c4d3e2f\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"errors\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"403 CHANNEL_DISABLED","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"9\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"errors\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"CHANNEL_DISABLED\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Messages are turned off for this agent.\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Send SMS Message","path":"/v1/sms/send","servers":[{"url":"https://api.bland.ai"}],"method":"post","request":{"security":[],"parameters":{"query":{},"header":{"authorization":{"schema":[{"type":"string","description":"Your API key for authentication.","required":true}]},"idempotency-key":{"schema":[{"type":"string","description":"A unique key to prevent duplicate message sends. When provided, repeated requests with the same key will return successfully but will not send an additional message or incur extra charges. Useful for safely retrying failed requests without risk of double-sending."}]}},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"user_number":[{"type":"string","description":"The E.164 formatted phone number of the user receiving the message.","required":true}],"agent_number":[{"type":"string","description":"The E.164 formatted phone number used to send the message (must belong to the authenticated account).","required":true}],"agent_message":[{"type":"string","description":"The content of the SMS message to send. If not passed in, the message is generated from the conversation’s pathway, persona, or `objective` , or from the number’s prompt."}],"objective":[{"type":"string","description":"The goal of this conversation, for example “Book a haircut for Tuesday afternoon and confirm the price.” Replies in the conversation are generated from it instead of the number’s prompt, and so is the first message when you omit `agent_message` . Up to 20,000 characters. A later send to the same conversation with a new `objective` replaces it, and a send without one keeps it. Set `new_conversation` to `true` to start a thread without it. A `persona_id` or `pathway_id` , on the request or on the number, takes priority: those replies don’t use the objective. So does a V2 agent attached to the number. An objective that is not a string, is empty, or is longer than 20,000 characters is rejected with a `400` and error code `INVALID_OBJECTIVE` ."}],"request_data":[{"type":"object","properties":{},"description":"Optional metadata to associate with the conversation or message. Used for custom routing or analytics."}],"new_conversation":[{"type":"boolean","description":"Allows you to create a new conversation, archiving the existing conversation and ignores existing sms messages."}],"persona_id":[{"type":"string","description":"UUID of a persona to use for this conversation. When provided, the persona’s configuration is applied instead of the number’s SMS config. Use `persona_version` to select which version to use. Cannot be used as a substitute for `agent_number` . The agent number must still belong to your account. The persona_id controls how the conversation is handled, not which number sends it."}],"persona_version":[{"type":"string","description":"Which version of the persona to use. Allowed values: `\"production\"` (default), `\"draft\"` ."}],"persona_settings":[{"type":"object","properties":{"pathway_id":[{"type":"string","description":"Override the persona’s pathway for this dispatch."}],"pathway_version":[{"type":"number","description":"Specific version of the override pathway to use."}],"start_node_id":[{"type":"string","description":"Specific node to start from within the override pathway."}]},"description":"Per-dispatch persona overrides. Takes priority over any pathway settings on the persona version or the `pathway_id` field below."}],"pathway_id":[{"type":"string","description":"ID of the pathway to use for generating the SMS response. If `persona_id` is provided, this is used as a pathway override within the persona context (lower priority than `persona_settings` ). On a number attached to a V2 agent, replies run the agent, not this pathway. If this pathway has a migration split, a new conversation can run on the split’s agent instead. See V2 agents ."}],"pathway_version":[{"type":"number","description":"Version of the pathway to use."}],"start_node_id":[{"type":"string","description":"ID of the specific node within the pathway to start from."}],"webhook":[{"type":"string","description":"This overrides the webhook for the conversation, instead of using the webhook attached to the phone number."}],"metadata":[{"type":"object","properties":{},"description":"Custom metadata to attach to the conversation. This data is returned in all webhook payloads (message and status webhooks), making it useful for correlating conversations with your internal systems."}],"disposition_ids":[{"type":"array","items":[{"type":"string"}],"description":"An array of outcome IDs to run when the conversation ends. If omitted, the outcomes configured on the SMS number are used. If provided, overrides the number’s configuration. See Outcomes for details. Not applied on a conversation that runs a V2 agent: the API drops these IDs without an error. The agent’s Dispositions run instead."}],"citation_schema_ids":[{"type":"array","items":[{"type":"string"}],"description":"An array of citation schema IDs to extract when the conversation ends. If omitted, the citation schemas configured on the SMS number are used. If provided, overrides the number’s configuration. See Citations for details. Not applied on a conversation that runs a V2 agent: the API drops these IDs without an error."}],"channel":[{"type":"string","description":"The channel to send the message on. Defaults to “sms”. Allowed values: “sms”, “whatsapp”, “imessage”. For numbers provisioned for iMessage, the channel is auto-derived from the number’s configuration, so you don’t need to set this explicitly. See iMessage for details."}],"content_sid":[{"type":"string","description":"The Twilio SID of the content to send, usually in HXXXX format."}],"content_variables":[{"type":"object","properties":{},"description":"The variables to send with the content. Example:"}],"time_out":[{"type":"number","description":"Per-conversation timeout override, in seconds. When the user goes silent for this long after an agent message, the timeout flow fires (warning message and/or conversation end). Takes priority over the `time_out` on the number’s sms_config/whatsapp_config. Persists on the conversation, so subsequent turns use the same override until another `/send` or `/create` replaces it."}],"timeout_message":[{"type":"string","description":"Per-conversation override for the message sent when the timeout fires. Takes priority over `timeout_message` on sms_config/whatsapp_config."}],"warning_time":[{"type":"number","description":"Per-conversation override for how long, in seconds, to wait before sending the warning message. Must be less than `time_out` ; the request is rejected with `INVALID_TIMEOUT_CONFIG` otherwise. Takes priority over `warning_time` on sms_config/whatsapp_config."}],"warning_message":[{"type":"string","description":"Per-conversation override for the warning message sent at `warning_time` . Takes priority over `warning_message` on sms_config/whatsapp_config."}]}}],"examples":{"example":{"value":{"user_number":"\u003cstring>","agent_number":"\u003cstring>","agent_message":"\u003cstring>","objective":"\u003cstring>","request_data":{},"new_conversation":true,"persona_id":"\u003cstring>","persona_version":"\u003cstring>","persona_settings":{"pathway_id":"\u003cstring>","pathway_version":123,"start_node_id":"\u003cstring>"},"pathway_id":"\u003cstring>","pathway_version":123,"start_node_id":"\u003cstring>","webhook":"\u003cstring>","metadata":{},"disposition_ids":["\u003cstring>"],"citation_schema_ids":["\u003cstring>"],"channel":"\u003cstring>","content_sid":"\u003cstring>","content_variables":{},"time_out":123,"timeout_message":"\u003cstring>","warning_time":123,"warning_message":"\u003cstring>"}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"data":[{"type":"object","properties":{},"description":"An object confirming the message was accepted for delivery."}],"data.status":[{"type":"string","description":"`\"processing\"` . The message is sent asynchronously after the response."}],"data.message":[{"type":"string","description":"Confirmation text for the accepted send."}],"data.conversation_id":[{"type":"string","description":"ID of the conversation that was created or resumed."}],"data.message_id":[{"type":"string","description":"ID of the message, to track its delivery and status. Returned only when the request includes `agent_message` or `content_sid` ."}],"errors":[{"type":"object","properties":{},"description":"`null` on success, or a list of error objects if the request failed."}]}}],"examples":{"example":{"value":{"data":{},"data.status":"\u003cstring>","data.message":"\u003cstring>","data.conversation_id":"\u003cstring>","data.message_id":"\u003cstring>","errors":{}}}}}}},"deprecated":false}},"jsLinks":["/_mintlify/custom/blandai/02e9da7d1fa2fc47/script.js"],"subdomain":"blandai","siteName":"Bland","title":"Send SMS Message - Bland","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-14T08:04:04.902Z","originalFileLocation":"api-v1/post/sms-send.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=\"Send an SMS message from an agent to a user. This creates or resumes a conversation and triggers processing workflows.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bland\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/blandai/L0VNlKoB1A8-QMxb/_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/blandai/L0VNlKoB1A8-QMxb/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/blandai/L0VNlKoB1A8-QMxb/_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/blandai/L0VNlKoB1A8-QMxb/_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/blandai/L0VNlKoB1A8-QMxb/_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/blandai/L0VNlKoB1A8-QMxb/_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/blandai/L0VNlKoB1A8-QMxb/_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/blandai/L0VNlKoB1A8-QMxb/_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/blandai/L0VNlKoB1A8-QMxb/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Send SMS Message - Bland\">\u003cmeta data-mint-head property=\"og:description\" content=\"Send an SMS message from an agent to a user. This creates or resumes a conversation and triggers processing workflows.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bland\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bland.ai/api-v1/post/sms-send\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://blandai.mintlify.site/_mintlify/api/og/v2?division=Messaging\u0026amp;title=Send+SMS+Message\u0026amp;description=Send+an+SMS+message+from+an+agent+to+a+user.+This+creates+or+resumes+a+conversation+and+triggers+processing+workflows.\u0026amp;theme=ebdf2c248cf170693b0cf9f5\u0026amp;signature=0abede42174fba2716e7edb880497084828e1f4d8aa4a71b520c47300d3beccd\">\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=\"Send SMS Message - Bland\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Send an SMS message from an agent to a user. This creates or resumes a conversation and triggers processing workflows.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://blandai.mintlify.site/_mintlify/api/og/v2?division=Messaging\u0026amp;title=Send+SMS+Message\u0026amp;description=Send+an+SMS+message+from+an+agent+to+a+user.+This+creates+or+resumes+a+conversation+and+triggers+processing+workflows.\u0026amp;theme=ebdf2c248cf170693b0cf9f5\u0026amp;signature=0abede42174fba2716e7edb880497084828e1f4d8aa4a71b520c47300d3beccd\">\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/blandai/L0VNlKoB1A8-QMxb/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bland\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#CA071A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bland.ai/api-v1/post/sms-send\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-v1/post/sms-send.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bland.ai/#organization\",\"name\":\"Bland\",\"url\":\"https://docs.bland.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/blandai/ccT390llWRoa5cok/logo/light.svg?fit=max\u0026auto=format\u0026n=ccT390llWRoa5cok\u0026q=85\u0026s=c9e5f30d1a8880ad00ef715c1ffa2215\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bland.ai#website\",\"name\":\"Bland\",\"url\":\"https://docs.bland.ai\",\"publisher\":{\"@id\":\"https://docs.bland.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bland.ai/api-v1/post/sms-send#webpage\",\"url\":\"https://docs.bland.ai/api-v1/post/sms-send\",\"name\":\"Send SMS Message\",\"description\":\"Send an SMS message from an agent to a user. This creates or resumes a conversation and triggers processing workflows.\",\"dateModified\":\"2026-11-14T08:04:04.902Z\",\"isPartOf\":{\"@id\":\"https://docs.bland.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bland.ai/api-v1/post/sms-send#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bland.ai/api-v1/post/sms-send#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Messaging\",\"item\":\"https://docs.bland.ai/api-v1/get/sms-numbers\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Send SMS Message\",\"item\":\"https://docs.bland.ai/api-v1/post/sms-send\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.bland.ai/api-v1/post/sms-send#apireference\",\"headline\":\"Send SMS Message\",\"name\":\"Send SMS Message\",\"description\":\"Send an SMS message from an agent to a user. This creates or resumes a conversation and triggers processing workflows.\",\"url\":\"https://docs.bland.ai/api-v1/post/sms-send\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bland.ai/api-v1/post/sms-send#webpage\"},\"dateModified\":\"2026-11-14T08:04:04.902Z\",\"publisher\":{\"@id\":\"https://docs.bland.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bland.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bland\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Bland\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-v1/post/sms-send.md","siteName":"Bland","nav":{"global":{"anchors":[{"anchor":"Community","icon":"discord","href":"https://discord.gg/QvxDz8zcKe"},{"anchor":"Submit a support ticket","icon":"ticket","href":"https://app.bland.ai/dashboard/support"},{"anchor":"Blog","icon":"newspaper","href":"https://www.bland.ai/blog"},{"anchor":"Enterprise inquiries","icon":"building","href":"https://www.bland.ai/book-a-demo"}]},"products":[{"product":"Voice Agents","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/build-your-first-agent"}]},{"tab":"API Reference","groups":[{"group":"Get Started","pages":[{"title":"Overview","href":"/api-v2/overview"}]},{"group":"Calls","pages":[{"title":"Send Call with an Agent","api":"POST https://api.bland.ai/v1/calls","href":"/api-v1/post/calls-agent"},{"title":"Send Call","api":"POST https://api.bland.ai/v1/calls","href":"/api-v1/post/calls"},{"title":"Analyze Call with AI","api":"POST https://api.bland.ai/v1/calls/{call_id}/analyze","href":"/api-v1/post/calls-id-analyze"},{"title":"Stop Active Call","api":"POST https://api.bland.ai/v1/calls/{call_id}/stop","href":"/api-v1/post/calls-id-stop"},{"title":"Listen to Active Call","api":"POST https://api.bland.ai/v1/calls/{call_id}/listen","href":"/api-v1/post/calls-id-listen"},{"title":"Get Transcript Stream URL","api":"POST https://api.bland.ai/v1/calls/{call_id}/transcript-stream/token","href":"/api-v1/post/calls-id-transcript-stream-token"},{"title":"Post-Transfer Transcript Stream (WebSocket)","href":"/api-v1/post/calls-id-transcript-stream"},{"title":"Stop All Active Calls","api":"POST https://us.api.bland.ai/v1/calls/active/stop","href":"/api-v1/post/calls-active-stop"},{"title":"Transfer Active Call","api":"POST https://api.bland.ai/v1/calls/active/transfer","href":"/api-v1/post/calls-active-transfer"},{"title":"List Calls","api":"GET https://api.bland.ai/v1/calls","href":"/api-v1/get/calls"},{"title":"List Active Calls","api":"GET https://api.bland.ai/v1/calls/active","href":"/api-v1/get/active"},{"title":"Call Details","api":"GET https://api.bland.ai/v1/calls/{call_id}","href":"/api-v1/get/calls-id"},{"title":"Event Stream","api":"GET https://api.bland.ai/v1/event_stream/{call_id}","href":"/api-v1/get/event-stream"},{"title":"Get Call Recording","api":"GET https://api.bland.ai/v1/recordings/{call_id}","href":"/api-v1/get/calls-id-recording"},{"title":"Get corrected transcripts","api":"GET https://api.bland.ai/v1/calls/{call_id}/correct","href":"/api-v1/get/calls-corrected-transcript"},{"group":"Post Call","pages":[{"title":"Get Post Call Webhook","api":"GET https://api.bland.ai/v1/postcall/webhooks/{call_id}","href":"/api-v1/get/postcall-webhooks-get"},{"title":"Create Post Call Webhook","api":"POST https://api.bland.ai/v1/postcall/webhooks/create","href":"/api-v1/post/postcall-webhooks-create"},{"title":"Resend Post Call Webhook","api":"POST https://api.bland.ai/v1/postcall/webhooks/resend","href":"/api-v1/post/postcall-webhooks-resend"}]}]},{"group":"Agents","pages":[{"title":"Create Agent","api":"POST https://api.bland.ai/v2/agents","href":"/api-v2/post/agents"},{"title":"List Agents","api":"GET https://api.bland.ai/v2/agents","href":"/api-v2/get/agents"},{"title":"Get Agent","api":"GET https://api.bland.ai/v2/agents/{agent_id}","href":"/api-v2/get/agents-id"},{"title":"Update Agent","api":"PATCH https://api.bland.ai/v2/agents/{agent_id}","href":"/api-v2/patch/agents-id"},{"title":"Delete Agent","api":"DELETE https://api.bland.ai/v2/agents/{agent_id}","href":"/api-v2/delete/agents-id"},{"group":"Phone Numbers","pages":[{"title":"Get Agent Number Binding","api":"GET https://api.bland.ai/v2/agents/{agent_id}/inbound","href":"/api-v2/get/agents-id-inbound"},{"title":"Attach Numbers to Agent","api":"POST https://api.bland.ai/v2/agents/{agent_id}/inbound/attach","href":"/api-v2/post/agents-id-inbound-attach"},{"title":"Detach Numbers from Agent","api":"POST https://api.bland.ai/v2/agents/{agent_id}/inbound/detach","href":"/api-v2/post/agents-id-inbound-detach"}]},{"group":"Agent Onboarding","pages":[{"title":"Start Agent Onboarding","api":"POST https://api.bland.ai/v1/agent/onboarding/start","href":"/api-v1/post/agent-onboarding-start"},{"title":"Poll Agent Onboarding","api":"POST https://api.bland.ai/v1/agent/onboarding/poll","href":"/api-v1/post/agent-onboarding-poll"},{"title":"Approve Agent Onboarding","api":"POST https://api.bland.ai/v1/agent/onboarding/approve","href":"/api-v1/post/agent-onboarding-approve"}]},{"group":"Agent Phone Plan","pages":[{"title":"Cancel Agent Phone Plan","api":"POST https://api.bland.ai/billing/cancel_agent_phone","href":"/api-v1/post/agent-phone-plan-cancel"},{"title":"Submit Cancellation Feedback","api":"POST https://api.bland.ai/billing/cancel_agent_phone/feedback","href":"/api-v1/post/agent-phone-plan-cancel-feedback"}]}]},{"group":"Versions","pages":[{"title":"Create Agent Version","api":"POST https://api.bland.ai/v2/agents/{agent_id}/versions","href":"/api-v2/post/agents-id-versions"},{"title":"List Agent Versions","api":"GET https://api.bland.ai/v2/agents/{agent_id}/versions","href":"/api-v2/get/agents-id-versions"},{"title":"Get Latest Agent Version","api":"GET https://api.bland.ai/v2/agents/{agent_id}/versions/latest","href":"/api-v2/get/agents-id-versions-latest"},{"title":"Get Agent Version","api":"GET https://api.bland.ai/v2/agents/{agent_id}/versions/{semver}","href":"/api-v2/get/agents-id-versions-semver"},{"title":"Get Scenario History","api":"GET https://api.bland.ai/v2/agents/{agent_id}/scenarios/{node_id}/history","href":"/api-v2/get/agents-id-scenarios-node-id-history"}]},{"group":"Identity","pages":[{"title":"Get Agent Identity","api":"GET https://api.bland.ai/v2/agents/{agent_id}/identity","href":"/api-v2/get/agents-id-identity"},{"title":"Update Agent Identity","api":"PUT https://api.bland.ai/v2/agents/{agent_id}/identity","href":"/api-v2/put/agents-id-identity"},{"title":"Upload Agent Logo","api":"POST https://api.bland.ai/v2/agents/{agent_id}/identity/logo","href":"/api-v2/post/agents-id-identity-logo"},{"title":"Download Agent Contact Card","api":"GET https://api.bland.ai/v2/agents/{agent_id}/identity/contact-card.vcf","href":"/api-v2/get/agents-id-identity-contact-card"},{"title":"Send Test Contact Card","api":"POST https://api.bland.ai/v2/agents/{agent_id}/identity/contact-card/test","href":"/api-v2/post/agents-id-identity-contact-card-test"}]},{"group":"Environments and Releases","pages":[{"title":"List Agent Environments","api":"GET https://api.bland.ai/v2/agents/{agent_id}/environments","href":"/api-v2/get/agents-id-environments"},{"title":"List Agent Deployments","api":"GET https://api.bland.ai/v2/agents/{agent_id}/deployments","href":"/api-v2/get/agents-id-deployments"},{"title":"Publish Agent to Staging","api":"POST https://api.bland.ai/v2/agents/{agent_id}/publish","href":"/api-v2/post/agents-id-publish"},{"title":"Promote Agent to Production","api":"POST https://api.bland.ai/v2/agents/{agent_id}/promote","href":"/api-v2/post/agents-id-promote"},{"title":"Roll Back Agent","api":"POST https://api.bland.ai/v2/agents/{agent_id}/rollback","href":"/api-v2/post/agents-id-rollback"}]},{"group":"Branches","pages":[{"title":"List Agent Branches","api":"GET https://api.bland.ai/v2/agents/{agent_id}/branches","href":"/api-v2/get/agents-id-branches"},{"title":"Create Agent Branch","api":"POST https://api.bland.ai/v2/agents/{agent_id}/branches","href":"/api-v2/post/agents-id-branches"},{"title":"Delete Agent Branch","api":"DELETE https://api.bland.ai/v2/agents/{agent_id}/branches/{branch_id}","href":"/api-v2/delete/agents-id-branches-branch-id"},{"title":"Preview Agent Branch Rebase","api":"POST https://api.bland.ai/v2/agents/{agent_id}/branches/{branch_id}/rebase-preview","href":"/api-v2/post/agents-id-branches-branch-id-rebase-preview"},{"title":"Rebase Agent Branch","api":"POST https://api.bland.ai/v2/agents/{agent_id}/branches/{branch_id}/rebase","href":"/api-v2/post/agents-id-branches-branch-id-rebase"},{"title":"Merge Agent Branch","api":"POST https://api.bland.ai/v2/agents/{agent_id}/branches/{branch_id}/merge","href":"/api-v2/post/agents-id-branches-branch-id-merge"}]},{"group":"Variables","pages":[{"title":"List Agent Variables","api":"GET https://api.bland.ai/v2/agents/{agent_id}/environments/{env}/variables","href":"/api-v2/get/agents-id-environments-env-variables"},{"title":"Set Agent Variable","api":"PUT https://api.bland.ai/v2/agents/{agent_id}/environments/{env}/variables/{key}","href":"/api-v2/put/agents-id-environments-env-variables-key"},{"title":"Delete Agent Variable","api":"DELETE https://api.bland.ai/v2/agents/{agent_id}/environments/{env}/variables/{key}","href":"/api-v2/delete/agents-id-environments-env-variables-key"}]},{"group":"Checks","pages":[{"title":"Get Checks","api":"GET https://api.bland.ai/v2/agents/{agent_id}/environments/{env}/checks","href":"/api-v2/get/agents-id-environments-env-checks"},{"title":"Set Checks","api":"PUT https://api.bland.ai/v2/agents/{agent_id}/environments/{env}/checks","href":"/api-v2/put/agents-id-environments-env-checks"},{"title":"Delete Checks","api":"DELETE https://api.bland.ai/v2/agents/{agent_id}/environments/{env}/checks","href":"/api-v2/delete/agents-id-environments-env-checks"},{"title":"Start Check Run","api":"POST https://api.bland.ai/v2/agents/{agent_id}/environments/{env}/check-runs","href":"/api-v2/post/agents-id-environments-env-check-runs"},{"title":"List Check Runs","api":"GET https://api.bland.ai/v2/agents/{agent_id}/check-runs","href":"/api-v2/get/agents-id-check-runs"},{"title":"Get Check Run","api":"GET https://api.bland.ai/v2/agents/{agent_id}/check-runs/{run_id}","href":"/api-v2/get/agents-id-check-runs-run-id"},{"title":"Cancel Check Run","api":"POST https://api.bland.ai/v2/agents/{agent_id}/check-runs/{run_id}/cancel","href":"/api-v2/post/agents-id-check-runs-run-id-cancel"},{"title":"Remove Check Eval","api":"DELETE https://api.bland.ai/v2/agents/{agent_id}/environments/{env}/checks/evals/{eval_agent_id}","href":"/api-v2/delete/agents-id-environments-env-checks-evals-eval-agent-id"}]},{"group":"Experiments","pages":[{"title":"Create Experiment","api":"POST https://api.bland.ai/v2/agents/{agent_id}/experiments","href":"/api-v2/post/agents-id-experiments"},{"title":"List Experiments","api":"GET https://api.bland.ai/v2/agents/{agent_id}/experiments","href":"/api-v2/get/agents-id-experiments"},{"title":"Get Experiment","api":"GET https://api.bland.ai/v2/agents/{agent_id}/experiments/{experiment_id}","href":"/api-v2/get/agents-id-experiments-experiment-id"},{"title":"Update Experiment","api":"PATCH https://api.bland.ai/v2/agents/{agent_id}/experiments/{experiment_id}","href":"/api-v2/patch/agents-id-experiments-experiment-id"},{"title":"Stop Experiment","api":"POST https://api.bland.ai/v2/agents/{agent_id}/experiments/{experiment_id}/stop","href":"/api-v2/post/agents-id-experiments-experiment-id-stop"}]},{"group":"Dispositions","pages":[{"title":"List Dispositions","api":"GET https://api.bland.ai/v2/agents/{agent_id}/dispositions","href":"/api-v2/get/agents-id-dispositions"},{"title":"Delete Disposition","api":"DELETE https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}","href":"/api-v2/delete/agents-id-dispositions-disposition-id"},{"title":"Create Disposition","api":"POST https://api.bland.ai/v2/agents/{agent_id}/dispositions","href":"/api-v2/post/agents-id-dispositions"},{"title":"Get Disposition","api":"GET https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}","href":"/api-v2/get/agents-id-dispositions-disposition-id"},{"title":"Get Disposition Draft","api":"GET https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/draft","href":"/api-v2/get/agents-id-dispositions-disposition-id-draft"},{"title":"Update Disposition Draft","api":"PATCH https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/draft","href":"/api-v2/patch/agents-id-dispositions-disposition-id-draft"},{"title":"List Disposition Versions","api":"GET https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/versions","href":"/api-v2/get/agents-id-dispositions-disposition-id-versions"},{"title":"Get Disposition Version","api":"GET https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/versions/{version_id}","href":"/api-v2/get/agents-id-dispositions-disposition-id-versions-version-id"},{"title":"Estimate Disposition Cost","api":"POST https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/estimates","href":"/api-v2/post/agents-id-dispositions-disposition-id-estimates"},{"title":"Publish Disposition","api":"POST https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/publish","href":"/api-v2/post/agents-id-dispositions-disposition-id-publish"},{"title":"Disable Disposition","api":"POST https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/disable","href":"/api-v2/post/agents-id-dispositions-disposition-id-disable"},{"title":"List Call Disposition Runs","api":"GET https://api.bland.ai/v2/agents/{agent_id}/dispositions/call-runs","href":"/api-v2/get/agents-id-dispositions-call-runs"},{"group":"Test Runs","pages":[{"title":"List Disposition Test Runs","api":"GET https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/runs","href":"/api-v2/get/agents-id-dispositions-disposition-id-runs"},{"title":"Create Disposition Test Run","api":"POST https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/runs","href":"/api-v2/post/agents-id-dispositions-disposition-id-runs"},{"title":"Get Disposition Test Run","api":"GET https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/runs/{run_id}","href":"/api-v2/get/agents-id-dispositions-disposition-id-runs-run-id"},{"title":"Get Test Run Rows","api":"GET https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/runs/{run_id}/rows","href":"/api-v2/get/agents-id-dispositions-disposition-id-runs-run-id-rows"},{"title":"Export Test Run CSV","api":"GET https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/runs/{run_id}/export.csv","href":"/api-v2/get/agents-id-dispositions-disposition-id-runs-run-id-export-csv"},{"title":"Align Disposition Test Run","api":"POST https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/runs/{run_id}/align","href":"/api-v2/post/agents-id-dispositions-disposition-id-runs-run-id-align"},{"title":"Correct Test Run Value","api":"PUT https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/runs/{run_id}/cases/{call_id}/annotations/{value_id}","href":"/api-v2/put/agents-id-dispositions-disposition-id-runs-run-id-cases-call-id-annotations-value-id"},{"title":"List Test Run Correction Revisions","api":"GET https://api.bland.ai/v2/agents/{agent_id}/dispositions/{disposition_id}/runs/{run_id}/cases/{call_id}/annotations/{value_id}","href":"/api-v2/get/agents-id-dispositions-disposition-id-runs-run-id-cases-call-id-annotations-value-id"}]},{"group":"Extractors","pages":[{"title":"List Disposition Extractors","api":"GET https://api.bland.ai/v2/agents/{agent_id}/dispositions/extractors","href":"/api-v2/get/agents-id-dispositions-extractors"},{"title":"Create Disposition Extractor","api":"POST https://api.bland.ai/v2/agents/{agent_id}/dispositions/extractors","href":"/api-v2/post/agents-id-dispositions-extractors"},{"title":"Get Disposition Extractor","api":"GET https://api.bland.ai/v2/agents/{agent_id}/dispositions/extractors/{extractor_id}","href":"/api-v2/get/agents-id-dispositions-extractors-extractor-id"},{"title":"Get Disposition Extractor Version","api":"GET https://api.bland.ai/v2/agents/{agent_id}/dispositions/extractors/{extractor_id}/versions/{version_id}","href":"/api-v2/get/agents-id-dispositions-extractors-extractor-id-versions-version-id"},{"title":"Update Disposition Extractor Draft","api":"PATCH https://api.bland.ai/v2/agents/{agent_id}/dispositions/extractors/{extractor_id}/draft","href":"/api-v2/patch/agents-id-dispositions-extractors-extractor-id-draft"},{"title":"Publish Disposition Extractor","api":"POST https://api.bland.ai/v2/agents/{agent_id}/dispositions/extractors/{extractor_id}/publish","href":"/api-v2/post/agents-id-dispositions-extractors-extractor-id-publish"}]},{"group":"Catalogs","pages":[{"title":"Get Judge Catalog","api":"GET https://api.bland.ai/v2/agents/{agent_id}/dispositions/judge-catalog","href":"/api-v2/get/agents-id-dispositions-judge-catalog"},{"title":"Get Judge Version","api":"GET https://api.bland.ai/v2/agents/{agent_id}/dispositions/judges/{judge_id}/versions/{version_id}","href":"/api-v2/get/agents-id-dispositions-judges-judge-id-versions-version-id"},{"title":"Get Variable Catalog","api":"GET https://api.bland.ai/v2/agents/{agent_id}/dispositions/variable-catalog","href":"/api-v2/get/agents-id-dispositions-variable-catalog"},{"title":"Get Model Profile Catalog","api":"GET https://api.bland.ai/v2/agents/{agent_id}/dispositions/model-profile-catalog","href":"/api-v2/get/agents-id-dispositions-model-profile-catalog"},{"title":"Get Extractor Catalog","api":"GET https://api.bland.ai/v2/agents/{agent_id}/dispositions/extractor-catalog","href":"/api-v2/get/agents-id-dispositions-extractor-catalog"}]}]},{"group":"Library","pages":[{"title":"List Library Scenarios","api":"GET https://api.bland.ai/v2/agents/library/scenarios","href":"/api-v2/get/agents-library-scenarios"},{"title":"List Scenario Folders","api":"GET https://api.bland.ai/v2/agents/library/scenario-folders","href":"/api-v2/get/agents-library-scenario-folders"},{"title":"File Scenario in Folder","api":"PUT https://api.bland.ai/v2/agents/library/scenario-folders","href":"/api-v2/put/agents-library-scenario-folders"},{"title":"List Archived Nodes","api":"GET https://api.bland.ai/v2/agents/library/archived-nodes","href":"/api-v2/get/agents-library-archived-nodes"},{"title":"Delete Archived Node","api":"DELETE https://api.bland.ai/v2/agents/library/archived-nodes/{archived_node_id}","href":"/api-v2/delete/agents-library-archived-nodes-archived-node-id"},{"title":"Archive Agent Node","api":"POST https://api.bland.ai/v2/agents/{agent_id}/archived-nodes","href":"/api-v2/post/agents-id-archived-nodes"}]},{"group":"Migration","pages":[{"title":"Migrate Pathway","api":"POST https://api.bland.ai/v2/agents/migrate","href":"/api-v2/post/agents-migrate"},{"title":"Stream Pathway Migration","api":"POST https://api.bland.ai/v2/agents/migrate/stream","href":"/api-v2/post/agents-migrate-stream"},{"title":"Migrate Persona","api":"POST https://api.bland.ai/v2/agents/migrate/persona","href":"/api-v2/post/agents-migrate-persona"},{"title":"Migrate Pathways","api":"POST https://api.bland.ai/v2/agents/migrate/pathways","href":"/api-v2/post/agents-migrate-pathways"},{"title":"Start Pathway Translation","api":"POST https://api.bland.ai/v2/agents/migrate/translations","href":"/api-v2/post/agents-migrate-translations"},{"title":"Get Pathway Translation Run","api":"GET https://api.bland.ai/v2/agents/migrate/translations/{run_id}","href":"/api-v2/get/agents-migrate-translations-run-id"},{"title":"Cancel Pathway Translation Run","api":"POST https://api.bland.ai/v2/agents/migrate/translations/{run_id}/cancellations","href":"/api-v2/post/agents-migrate-translations-run-id-cancellations"},{"group":"Migration Split","pages":[{"title":"Get Migration Split","api":"GET https://api.bland.ai/v1/convo_pathway/{pathway_id}/migration_split","href":"/api-v1/get/convo-pathway-id-migration-split"},{"title":"Set Migration Split","api":"PUT https://api.bland.ai/v1/convo_pathway/{pathway_id}/migration_split","href":"/api-v1/put/convo-pathway-id-migration-split"},{"title":"Update Migration Split Request Policy","api":"PATCH https://api.bland.ai/v1/convo_pathway/{pathway_id}/migration_split","href":"/api-v1/patch/convo-pathway-id-migration-split"},{"title":"Delete Migration Split","api":"DELETE https://api.bland.ai/v1/convo_pathway/{pathway_id}/migration_split","href":"/api-v1/delete/convo-pathway-id-migration-split"}]}]},{"group":"Knowledge Bases","pages":[{"title":"Upload File","api":"POST https://api.bland.ai/v1/knowledge/learn","href":"/api-v1/post/knowledge-learn-file"},{"title":"Upload Text","api":"POST https://api.bland.ai/v1/knowledge/learn","href":"/api-v1/post/knowledge-learn-text"},{"title":"Scrape Websites","api":"POST https://api.bland.ai/v1/knowledge/learn","href":"/api-v1/post/knowledge-learn-web"},{"title":"List Knowledge Base Items","api":"GET https://api.bland.ai/v1/knowledge","href":"/api-v1/get/knowledge"},{"title":"Get Knowledge Base Item","api":"GET https://api.bland.ai/v1/knowledge/{knowledge_base_id}","href":"/api-v1/get/knowledge-id"},{"title":"Update Knowledge Base Item","api":"PUT https://api.bland.ai/v1/knowledge/{knowledge_base_id}","href":"/api-v1/put/knowledge-id"},{"title":"Delete Knowledge Base Item","api":"DELETE https://api.bland.ai/v1/knowledge/{knowledge_base_id}","href":"/api-v1/delete/knowledge-id"},{"title":"Discover Sitemap URLs","api":"POST https://api.bland.ai/v1/knowledge/crawl","href":"/api-v1/post/knowledge-crawl"},{"title":"Chat with Knowledge Base Item","api":"POST https://api.bland.ai/v1/knowledge/chat","href":"/api-v1/post/knowledge-chat"}]},{"group":"Numbers","pages":[{"title":"Purchase Phone Number","api":"POST https://api.bland.ai/numbers/purchase","href":"/api-v1/post/inbound-purchase"},{"title":"Update Inbound Number Details","api":"POST https://api.bland.ai/v1/inbound/{phone_number}","href":"/api-v1/post/inbound-number-update"},{"title":"Update Inbound Number Label","api":"POST https://api.bland.ai/inbound/update_label","href":"/api-v1/post/inbound-update-label"},{"title":"List Numbers","api":"GET https://api.bland.ai/v1/inbound","href":"/api-v1/get/inbound"},{"title":"Number Details","api":"GET https://api.bland.ai/v1/inbound/{phone_number}","href":"/api-v1/get/inbound-number"},{"title":"Create Inbound Session","api":"POST https://api.bland.ai/v1/inbound/session","href":"/api-v1/post/inbound-session"},{"title":"Get Voice Pool","api":"GET https://api.bland.ai/v1/inbound/{phone_number}/voice-pool","href":"/api-v1/get/inbound-number-voice-pool"},{"title":"Set Voice Pool","api":"POST https://api.bland.ai/v1/inbound/{phone_number}/voice-pool","href":"/api-v1/post/inbound-number-voice-pool"}]},{"group":"Blocked Numbers","pages":[{"title":"Create Block Rules","api":"POST https://api.bland.ai/v1/blocked_numbers","href":"/api-v1/post/blocked-numbers"},{"title":"List Block Rules","api":"GET https://api.bland.ai/v1/blocked_numbers","href":"/api-v1/get/blocked-numbers"},{"title":"Get Block Rule","api":"GET https://api.bland.ai/v1/blocked_numbers/{block_id}","href":"/api-v1/get/blocked-numbers-id"},{"title":"Delete Block Rule","api":"DELETE https://api.bland.ai/v1/blocked_numbers/{block_id}","href":"/api-v1/delete/blocked-numbers-id"},{"title":"Edit Block Rule","api":"POST https://api.bland.ai/v1/blocked_numbers/{block_id}/edit","href":"/api-v1/post/blocked-numbers-id-edit"}]},{"group":"Widgets","pages":[{"title":"Create Widget","api":"POST https://api.bland.ai/v1/widget","href":"/api-v1/post/widget"},{"title":"List Widgets","api":"GET https://api.bland.ai/v1/widgets","href":"/api-v1/get/widgets"},{"title":"Get Widget by ID","api":"GET https://api.bland.ai/v1/widget/{id}","href":"/api-v1/get/widget-id"},{"title":"Update Widget","api":"PATCH https://api.bland.ai/v1/widget/{id}","href":"/api-v1/patch/widget-id"},{"title":"Get Widget Threads","api":"GET https://api.bland.ai/v1/widget/{id}/threads","href":"/api-v1/get/widget-id-threads"},{"title":"Send Live Agent Message","api":"POST https://api.bland.ai/v1/widget/{id}/threads/{thread_id}/webhook","href":"/api-v1/post/widget-thread-webhook"},{"title":"List Custom Components","api":"GET https://api.bland.ai/v1/widget/custom_components","href":"/api-v1/get/widget-custom-components"},{"title":"Create Custom Component","api":"POST https://api.bland.ai/v1/widget/custom_components","href":"/api-v1/post/widget-custom-components"},{"title":"Update Custom Component","api":"PATCH https://api.bland.ai/v1/widget/custom_components/{id}","href":"/api-v1/patch/widget-custom-components-id"},{"title":"Delete Custom Component","api":"DELETE https://api.bland.ai/v1/widget/custom_components/{id}","href":"/api-v1/delete/widget-custom-components-id"}]},{"group":"Tools","pages":[{"title":"Create Tool","api":"POST https://api.bland.ai/v2/tools","href":"/api-v2/post/tools"},{"title":"Update Tool","api":"POST https://api.bland.ai/v2/tools/{tool_id}","href":"/api-v2/post/tools-tool-id"},{"title":"List Tools","api":"GET https://api.bland.ai/v2/tools","href":"/api-v2/get/tools"},{"group":"Logs \u0026 Analytics","pages":[{"title":"Tool Execution Logs","api":"GET https://api.bland.ai/v2/tools/logs","href":"/api-v2/get/tools-logs"},{"title":"Tool Execution Stats","api":"GET https://api.bland.ai/v2/tools/logs/stats","href":"/api-v2/get/tools-logs-stats"}]}]},{"group":"Contacts","pages":[{"title":"List Contacts","api":"GET https://api.bland.ai/v1/contacts","href":"/api-v1/get/contacts"},{"title":"Find Contact","api":"POST https://api.bland.ai/v1/contacts/find","href":"/api-v1/get/contacts-find"},{"title":"Get Contact","api":"GET https://api.bland.ai/v1/contacts/{contact_id}","href":"/api-v1/get/contacts-id"},{"title":"Resolve Contact","api":"POST https://api.bland.ai/v1/contacts/resolve","href":"/api-v1/post/contacts-resolve"},{"title":"Update Contact","api":"PATCH https://api.bland.ai/v1/contacts/{contact_id}","href":"/api-v1/patch/contacts-id"},{"title":"Merge Contacts","api":"POST https://api.bland.ai/v1/contacts/merge","href":"/api-v1/post/contacts-merge"}]},{"group":"Memory","pages":[{"title":"Create Contact Memory","api":"POST https://api.bland.ai/v1/memory/contact","href":"/api-v1/post/memory-contact"},{"title":"Get Contact Memory","api":"GET https://api.bland.ai/v1/memory/contact/{memory_id}","href":"/api-v1/get/memory-contact-id"},{"title":"List Recent Messages","api":"GET https://api.bland.ai/v1/memory/contact/{memory_id}/messages","href":"/api-v1/get/memory-contact-id-messages"},{"title":"Update Conversation Summary","api":"PATCH https://api.bland.ai/v1/memory/contact/{memory_id}/summary","href":"/api-v1/patch/memory-contact-id-summary"},{"title":"Update Contact Facts","api":"PATCH https://api.bland.ai/v1/memory/contact/{memory_id}/facts","href":"/api-v1/patch/memory-contact-id-facts"},{"title":"Get Memory Context","api":"GET https://api.bland.ai/v1/memory/context","href":"/api-v1/get/memory-context"},{"title":"Get Memory Changes","api":"GET https://api.bland.ai/v1/memory/changes","href":"/api-v1/get/memory-changes"},{"title":"Reset Contact Memory","api":"POST https://api.bland.ai/v1/memory/reset","href":"/api-v1/post/memory-reset"},{"title":"Enable or Disable Memory","api":"POST https://api.bland.ai/v1/memory/enable","href":"/api-v1/post/memory-enable"},{"group":"Agent Memory Schema","pages":[{"title":"Get Agent Memory Schema","api":"GET https://api.bland.ai/v2/agents/{agent_id}/memory/schema","href":"/api-v2/get/agents-id-memory-schema"},{"title":"Infer Agent Memory Schema","api":"POST https://api.bland.ai/v2/agents/{agent_id}/memory/schema/infer","href":"/api-v2/post/agents-id-memory-schema-infer"}]}]},{"group":"Agent Testing","pages":[{"title":"Create Test Scenario","api":"POST https://api.bland.ai/v1/agent-testing/scenarios","href":"/api-v1/post/agent-testing-scenarios"},{"title":"List Test Scenarios","api":"GET https://api.bland.ai/v1/agent-testing/scenarios","href":"/api-v1/get/agent-testing-scenarios"},{"title":"Get Test Scenario","api":"GET https://api.bland.ai/v1/agent-testing/scenarios/{id}","href":"/api-v1/get/agent-testing-scenarios-id"},{"title":"Update Test Scenario","api":"PUT https://api.bland.ai/v1/agent-testing/scenarios/{id}","href":"/api-v1/put/agent-testing-scenarios-id"},{"title":"Delete Test Scenario","api":"DELETE https://api.bland.ai/v1/agent-testing/scenarios/{id}","href":"/api-v1/delete/agent-testing-scenarios-id"},{"title":"List Test Templates","api":"GET https://api.bland.ai/v1/agent-testing/templates","href":"/api-v1/get/agent-testing-templates"},{"title":"Clone Test Template","api":"POST https://api.bland.ai/v1/agent-testing/templates/{id}/clone","href":"/api-v1/post/agent-testing-templates-clone"},{"title":"Generate Scenario from Call","api":"POST https://api.bland.ai/v1/agent-testing/scenarios/generate-from-call","href":"/api-v1/post/agent-testing-scenarios-generate"},{"title":"Run Test Scenario","api":"POST https://api.bland.ai/v1/agent-testing/scenarios/{id}/run","href":"/api-v1/post/agent-testing-scenarios-run"},{"title":"Batch Run Scenarios","api":"POST https://api.bland.ai/v1/agent-testing/batch-run","href":"/api-v1/post/agent-testing-batch-run"},{"title":"List Test Runs","api":"GET https://api.bland.ai/v1/agent-testing/runs","href":"/api-v1/get/agent-testing-runs"},{"title":"Get Test Run","api":"GET https://api.bland.ai/v1/agent-testing/runs/{id}","href":"/api-v1/get/agent-testing-runs-id"},{"title":"Get Test Batch","api":"GET https://api.bland.ai/v1/agent-testing/batches/{id}","href":"/api-v1/get/agent-testing-batches-id"},{"title":"Analyze Failed Run","api":"POST https://api.bland.ai/v1/agent-testing/runs/{id}/analyze","href":"/api-v1/post/agent-testing-runs-analyze"},{"title":"Get Test Analytics","api":"GET https://api.bland.ai/v1/agent-testing/analytics/{pathwayId}","href":"/api-v1/get/agent-testing-analytics"},{"title":"Get Enhanced Analytics","api":"GET https://api.bland.ai/v1/agent-testing/analytics/{pathwayId}/enhanced","href":"/api-v1/get/agent-testing-analytics-enhanced"},{"group":"Simulation Sets","pages":[{"title":"Create Simulation Set","api":"POST https://api.bland.ai/v1/agent-testing/simulation-sets","href":"/api-v1/post/agent-testing-simulation-sets"},{"title":"Get Simulation Set","api":"GET https://api.bland.ai/v1/agent-testing/simulation-sets/{id}","href":"/api-v1/get/agent-testing-simulation-sets-id"}]}]},{"group":"Evals","pages":[{"title":"Get Evals Status","api":"GET https://api.bland.ai/v1/evals/status","href":"/api-v1/get/evals-status"},{"group":"Eval Agents","pages":[{"title":"List Eval Agents","api":"GET https://api.bland.ai/v1/evals/agents","href":"/api-v1/get/evals-agents"},{"title":"Create Eval Agent","api":"POST https://api.bland.ai/v1/evals/agents","href":"/api-v1/post/evals-agents"},{"title":"Get Eval Agent","api":"GET https://api.bland.ai/v1/evals/agents/{eval_agent_id}","href":"/api-v1/get/evals-agents-id"},{"title":"Update Eval Agent","api":"PATCH https://api.bland.ai/v1/evals/agents/{eval_agent_id}","href":"/api-v1/patch/evals-agents-id"},{"title":"Delete Eval Agent","api":"DELETE https://api.bland.ai/v1/evals/agents/{eval_agent_id}","href":"/api-v1/delete/evals-agents-id"},{"title":"Publish Eval Agent","api":"POST https://api.bland.ai/v1/evals/agents/{eval_agent_id}/publications","href":"/api-v1/post/evals-agents-id-publish"},{"group":"Versions","pages":[{"title":"List Eval Agent Versions","api":"GET https://api.bland.ai/v1/evals/agents/{eval_agent_id}/versions","href":"/api-v1/get/evals-agents-id-versions"},{"title":"Create Eval Agent Version","api":"POST https://api.bland.ai/v1/evals/agents/{eval_agent_id}/versions","href":"/api-v1/post/evals-agents-id-versions"},{"title":"Get Eval Agent Version","api":"GET https://api.bland.ai/v1/evals/agents/{eval_agent_id}/versions/{version_id}","href":"/api-v1/get/evals-agents-id-versions-id"},{"title":"Update Eval Agent Version","api":"PATCH https://api.bland.ai/v1/evals/agents/{eval_agent_id}/versions/{version_id}","href":"/api-v1/patch/evals-agents-id-versions-id"}]}]},{"group":"Experiments","pages":[{"title":"List Eval Runs","api":"GET https://api.bland.ai/v1/evals/runs","href":"/api-v1/get/evals-runs"},{"title":"Create Eval Run","api":"POST https://api.bland.ai/v1/evals/runs","href":"/api-v1/post/evals-runs"},{"title":"Estimate Eval Run","api":"POST https://api.bland.ai/v1/evals/runs/estimates","href":"/api-v1/post/evals-runs-estimates"},{"title":"Get Eval Run","api":"GET https://api.bland.ai/v1/evals/runs/{run_id}","href":"/api-v1/get/evals-runs-id"},{"title":"Cancel Eval Run","api":"POST https://api.bland.ai/v1/evals/runs/{run_id}/cancellations","href":"/api-v1/post/evals-runs-id-cancel"},{"group":"Results","pages":[{"title":"List Call Results","api":"GET https://api.bland.ai/v1/evals/runs/{run_id}/call-results","href":"/api-v1/get/evals-runs-id-call-results"},{"title":"List Agent Results","api":"GET https://api.bland.ai/v1/evals/runs/{run_id}/agent-results","href":"/api-v1/get/evals-runs-id-agent-results"},{"title":"List Agent Snapshots","api":"GET https://api.bland.ai/v1/evals/runs/{run_id}/agent-snapshots","href":"/api-v1/get/evals-runs-id-agent-snapshots"}]}]},{"group":"Workbench Setups","pages":[{"title":"List Workbench Setups","api":"GET https://api.bland.ai/v1/evals/workbench-setups","href":"/api-v1/get/evals-workbench-setups"},{"title":"Create Workbench Setup","api":"POST https://api.bland.ai/v1/evals/workbench-setups","href":"/api-v1/post/evals-workbench-setups"},{"title":"Get Workbench Setup","api":"GET https://api.bland.ai/v1/evals/workbench-setups/{setup_id}","href":"/api-v1/get/evals-workbench-setups-id"},{"title":"Update Workbench Setup","api":"PATCH https://api.bland.ai/v1/evals/workbench-setups/{setup_id}","href":"/api-v1/patch/evals-workbench-setups-id"},{"title":"Delete Workbench Setup","api":"DELETE https://api.bland.ai/v1/evals/workbench-setups/{setup_id}","href":"/api-v1/delete/evals-workbench-setups-id"},{"title":"Publish Workbench Setup","api":"POST https://api.bland.ai/v1/evals/workbench-setups/{setup_id}/publications","href":"/api-v1/post/evals-workbench-setups-id-publish"},{"group":"Versions","pages":[{"title":"List Workbench Setup Versions","api":"GET https://api.bland.ai/v1/evals/workbench-setups/{setup_id}/versions","href":"/api-v1/get/evals-workbench-setups-id-versions"},{"title":"Create Workbench Setup Version","api":"POST https://api.bland.ai/v1/evals/workbench-setups/{setup_id}/versions","href":"/api-v1/post/evals-workbench-setups-id-versions"},{"title":"Get Workbench Setup Version","api":"GET https://api.bland.ai/v1/evals/workbench-setups/{setup_id}/versions/{version_id}","href":"/api-v1/get/evals-workbench-setups-id-versions-id"},{"title":"Update Workbench Setup Version","api":"PATCH https://api.bland.ai/v1/evals/workbench-setups/{setup_id}/versions/{version_id}","href":"/api-v1/patch/evals-workbench-setups-id-versions-id"}]}]},{"group":"Templates","pages":[{"title":"List Eval Agent Templates","api":"GET https://api.bland.ai/v1/evals/agent-templates","href":"/api-v1/get/evals-agent-templates"},{"title":"Get Eval Agent Template","api":"GET https://api.bland.ai/v1/evals/agent-templates/{template_key}","href":"/api-v1/get/evals-agent-templates-key"},{"title":"List User Templates","api":"GET https://api.bland.ai/v1/evals/user-templates","href":"/api-v1/get/evals-user-templates"},{"title":"Create User Template","api":"POST https://api.bland.ai/v1/evals/user-templates","href":"/api-v1/post/evals-user-templates"},{"title":"Get User Template","api":"GET https://api.bland.ai/v1/evals/user-templates/{id}","href":"/api-v1/get/evals-user-templates-id"},{"title":"Update User Template","api":"PATCH https://api.bland.ai/v1/evals/user-templates/{id}","href":"/api-v1/patch/evals-user-templates-id"},{"title":"Delete User Template","api":"DELETE https://api.bland.ai/v1/evals/user-templates/{id}","href":"/api-v1/delete/evals-user-templates-id"}]}]},{"group":"Guard Rails","pages":[{"title":"List Guard Rails","api":"GET https://api.bland.ai/v1/guard_rails","href":"/api-v1/get/guard-rails"},{"title":"Get Guard Rail","api":"GET https://api.bland.ai/v1/guard_rails/{guard_rail_id}","href":"/api-v1/get/guard-rails-id"},{"title":"Create Guard Rail","api":"POST https://api.bland.ai/v1/guard_rails","href":"/api-v1/post/guard-rails"},{"title":"Update Guard Rail","api":"PATCH https://api.bland.ai/v1/guard_rails/{guard_rail_id}","href":"/api-v1/patch/guard-rails-id"},{"title":"Delete Guard Rail","api":"DELETE https://api.bland.ai/v1/guard_rails/{guard_rail_id}","href":"/api-v1/delete/guard-rails-id"}]},{"group":"Live Translation","pages":[{"title":"Create Translation Session","api":"POST https://api.bland.ai/v1/translation/sessions","href":"/api-v1/post/translation-sessions"},{"title":"Get Translation Session","api":"GET https://api.bland.ai/v1/translation/sessions/{session_id}","href":"/api-v1/get/translation-sessions-id"},{"title":"End Translation Session","api":"DELETE https://api.bland.ai/v1/translation/sessions/{session_id}","href":"/api-v1/delete/translation-sessions-id"}]},{"group":"Custom Twilio Accounts","pages":[{"title":"Create Encrypted Key","api":"POST https://api.bland.ai/v1/accounts","href":"/api-v1/post/accounts"},{"title":"Delete Encrypted Key","api":"POST https://api.bland.ai/v1/accounts/delete","href":"/api-v1/post/accounts-delete"},{"title":"Upload Inbound Phone Numbers","api":"POST https://api.bland.ai/v1/inbound/insert","href":"/api-v1/post/inbound-insert"},{"title":"Delete Inbound Phone Number","api":"POST https://api.bland.ai/v1/inbound/{phone_number}/delete","href":"/api-v1/post/inbound-number-delete"}]},{"group":"Batches","pages":[{"title":"Create Batch","api":"POST https://api.bland.ai/v2/batches/create","href":"/api-v2/post/batches"},{"title":"List Batches","api":"GET https://api.bland.ai/v2/batches/list","href":"/api-v2/get/batches"},{"title":"Get Batch","api":"GET https://api.bland.ai/v2/batches/{batch_id}","href":"/api-v2/get/batches-id"},{"title":"Get Batch Logs","api":"GET https://api.bland.ai/v2/batches/{batch_id}/logs","href":"/api-v2/get/batches-id-logs"},{"title":"Stop Batch","api":"POST https://api.bland.ai/v2/batches/{batch_id}/stop","href":"/api-v2/post/batches-id-stop"}]},{"group":"Prompts","pages":[{"title":"List Prompts","api":"GET https://api.bland.ai/v1/prompts","href":"/api-v1/get/prompts"},{"title":"Prompt Details","api":"GET https://api.bland.ai/v1/prompts/{prompt_id}","href":"/api-v1/get/prompts-id"},{"title":"Create Prompt","api":"POST https://api.bland.ai/v1/prompts","href":"/api-v1/post/prompts"}]},{"group":"Account","pages":[{"title":"Account Details","api":"GET https://api.bland.ai/v1/me","href":"/api-v1/get/me"}]},{"group":"API Keys","pages":[{"title":"Create API Key","api":"POST https://api.bland.ai/keys/create","href":"/api-v1/post/keys-create"},{"title":"List API Keys","api":"POST https://api.bland.ai/keys/list","href":"/api-v1/post/keys-list"},{"title":"Rename API Key","api":"PATCH https://api.bland.ai/keys/rename","href":"/api-v1/patch/keys-rename"},{"title":"Delete API Key","api":"DELETE https://api.bland.ai/keys/delete","href":"/api-v1/delete/keys-delete"},{"title":"OAuth client credentials","href":"/api-v1/oauth-client-credentials"}]},{"group":"Organizations","pages":[{"title":"Create Organization","api":"POST https://api.bland.ai/v1/orgs/create","href":"/api-v1/post/orgs"},{"title":"Delete Organization","api":"DELETE https://api.bland.ai/v1/orgs/{org_id}","href":"/api-v1/delete/orgs"},{"title":"Get Organization","api":"GET https://api.bland.ai/v1/orgs/{org_id}","href":"/api-v1/get/orgs"},{"title":"Get Organization Members","api":"GET https://api.bland.ai/v1/orgs/{org_id}/members","href":"/api-v1/get/org_members"},{"title":"Get Organization's Current Service Version","api":"GET https://api.bland.ai/v1/orgs/{org_id}/versions/{service}/current","href":"/api-v1/get/org_current_version"},{"title":"List Organization's Service Versions","api":"GET https://api.bland.ai/v1/orgs/{org_id}/versions/{service}/list","href":"/api-v1/get/org_list_versions"},{"title":"Update Organization's Service Version","api":"PATCH https://api.bland.ai/v1/orgs/{org_id}/versions/{service}","href":"/api-v1/patch/org_version"},{"title":"Update Organization Members","api":"PATCH https://api.bland.ai/v1/orgs/{org_id}/members","href":"/api-v1/patch/org_members"},{"title":"Update Organization Member Permissions","api":"PATCH https://api.bland.ai/v1/orgs/{org_id}/members/permissions","href":"/api-v1/patch/org_member_permissions"},{"title":"Update Organization Properties","api":"PATCH https://api.bland.ai/v1/orgs/{org_id}/properties","href":"/api-v1/patch/org_properties"},{"title":"Get User Organization Memberships","api":"GET https://api.bland.ai/v1/orgs/self/memberships","href":"/api-v1/get/org_list_self_memberships"},{"title":"Leave Organization","api":"DELETE https://api.bland.ai/v1/orgs/self/leave","href":"/api-v1/delete/org_leave_self_memberships_id"},{"title":"Get Organization Billing Information","api":"GET https://api.bland.ai/v1/orgs/{org_id}/billing","href":"/api-v1/get/org_billing_information"},{"title":"Get Organization Billing Refill Information","api":"GET https://api.bland.ai/v1/orgs/{org_id}/billing/refill","href":"/api-v1/get/org_billing_refill_information"},{"title":"List Audit Logs","api":"GET https://api.bland.ai/v1/audit/logs","href":"/api-v1/get/audit-logs"}]},{"group":"Messaging","pages":[{"title":"List SMS Numbers","api":"GET https://api.bland.ai/v1/sms/numbers","href":"/api-v1/get/sms-numbers"},{"title":"Update SMS Configuration","api":"POST https://api.bland.ai/v1/sms/number/update","description":"Update the SMS configuration for a phone number owned by the authenticated user.","href":"/api-v1/post/sms-update"},{"title":"Send SMS Message","api":"POST https://api.bland.ai/v1/sms/send","href":"/api-v1/post/sms-send"},{"title":"Send SMS Batch","api":"POST https://api.bland.ai/v1/sms/batch","description":"Send SMS messages to a large list of recipients from a pre-uploaded CSV file. Processing is handled asynchronously via a background workflow.","href":"/api-v1/post/sms-batch"},{"title":"Create SMS Conversation","api":"POST https://api.bland.ai/v1/sms/create","href":"/api-v1/post/sms-create"},{"title":"List Conversations","api":"GET https://api.bland.ai/v1/sms/conversations","href":"/api-v1/get/sms-conversations"},{"title":"Get Conversation by ID","api":"GET https://api.bland.ai/v1/sms/conversations/{id}","href":"/api-v1/get/sms-conversations-id"},{"title":"Update SMS Conversation","api":"PATCH https://api.bland.ai/v1/sms/conversations/{conversation_id}","href":"/api-v1/patch/sms-conversations-id"},{"title":"Hand Off Conversation to a Human","api":"POST https://api.bland.ai/v1/sms/conversations/{conversation_id}/handoff","href":"/api-v1/post/sms-conversations-handoff"},{"title":"Send Message on Conversation","api":"POST https://api.bland.ai/v1/sms/conversations/{conversation_id}/messages","href":"/api-v1/post/sms-conversations-messages"},{"title":"Resume Conversation","api":"POST https://api.bland.ai/v1/sms/conversations/{conversation_id}/resume","href":"/api-v1/post/sms-conversations-resume"},{"title":"End Conversation","api":"POST https://api.bland.ai/v1/sms/conversations/{conversation_id}/end","href":"/api-v1/post/sms-conversations-end"},{"title":"Delete Messages from Conversation","api":"DELETE https://api.bland.ai/v1/sms/conversations/{id}/messages","href":"/api-v1/delete/sms-conversations-message"},{"title":"Delete Conversation","api":"DELETE https://api.bland.ai/v1/sms/conversations/{id}","href":"/api-v1/delete/sms-conversations"},{"title":"Get Post Conversation Webhook","api":"GET https://api.bland.ai/v1/sms/conversations/{conversationId}/webhook","href":"/api-v1/get/sms-conversations-webhook"},{"title":"SMS Conversation Analysis","api":"POST https://api.bland.ai/v1/sms/analyze","href":"/api-v1/post/sms-analyze"}]},{"group":"SIP Trunks","pages":[{"title":"Get SIP Config","api":"GET https://api.bland.ai/v1/sip","href":"/api-v1/get/sip-config"},{"title":"List SIP Numbers","api":"GET https://api.bland.ai/v1/sip/numbers","href":"/api-v1/get/sip-numbers"},{"title":"Attach SIP Configuration","api":"POST https://api.bland.ai/v1/sip/attach","href":"/api-v1/post/sip-attach"},{"title":"Update SIP Direction","api":"POST https://api.bland.ai/v1/sip/update","href":"/api-v1/post/sip-update"},{"title":"Detach SIP Configuration","api":"POST https://api.bland.ai/v1/sip/detach","href":"/api-v1/post/sip-detach"},{"title":"Parse SIP Destination","api":"POST https://api.bland.ai/v1/sip/parse-destination","href":"/api-v1/post/sip-parse-destination"},{"title":"Discover SIP Endpoint","api":"POST https://api.bland.ai/v1/sip/discover","href":"/api-v1/post/sip-discover"},{"title":"Get Discovery Status","api":"GET https://api.bland.ai/v1/sip/discover/status","href":"/api-v1/get/sip-discover-status"},{"title":"Send SIP Test Call","api":"POST https://api.bland.ai/v1/sip/test-call","href":"/api-v1/post/sip-test-call"},{"title":"Get Test Call Status","api":"GET https://api.bland.ai/v1/sip/test-call/status","href":"/api-v1/get/sip-test-call-status"},{"title":"Get Firewall IPs","api":"GET https://api.bland.ai/v1/sip/firewall-ips","href":"/api-v1/get/sip-firewall-ips"},{"title":"Get Outbound Setup","api":"GET https://api.bland.ai/v1/sip/outbound-setup","href":"/api-v1/get/sip-outbound-setup"},{"title":"Generate SIP Password","api":"GET https://api.bland.ai/v1/sip/generate-password","href":"/api-v1/get/sip-generate-password"},{"title":"Get Trunk Health","api":"GET https://api.bland.ai/v1/sip/status","href":"/api-v1/get/sip-status"},{"title":"Get SIP Call Logs","api":"GET https://api.bland.ai/v1/sip/calls","href":"/api-v1/get/sip-calls"},{"title":"Update Advanced Config","api":"PATCH https://api.bland.ai/v1/sip/config","href":"/api-v1/patch/sip-config"},{"group":"Number Porting","pages":[{"title":"Check Number Portability","api":"GET https://api.bland.ai/v1/sip/port/check","href":"/api-v1/get/sip-port-check"},{"title":"Upload Port Document","api":"POST https://api.bland.ai/v1/sip/port/document","href":"/api-v1/post/sip-port-document"},{"title":"Initiate Port Request","api":"POST https://api.bland.ai/v1/sip/port/initiate","href":"/api-v1/post/sip-port-initiate"},{"title":"List Port Requests","api":"GET https://api.bland.ai/v1/sip/port","href":"/api-v1/get/sip-port-requests"},{"title":"Cancel Port Request","api":"DELETE https://api.bland.ai/v1/sip/port/{id}","href":"/api-v1/delete/sip-port-cancel"}]}]},{"group":"Custom Dialing Pools","pages":[{"title":"Get Custom Dialing Pool","api":"GET https://us.api.bland.ai/v1/custom-dialing-pools/{pool_id}","href":"/api-v1/get/custom-dialing-pool"},{"title":"List Custom Dialing Pools","api":"GET https://us.api.bland.ai/v1/custom-dialing-pools","href":"/api-v1/get/custom-dialing-pools"},{"title":"Create Custom Dialing Pool","api":"POST https://us.api.bland.ai/v1/custom-dialing-pools","href":"/api-v1/post/custom-dialing-pools"},{"title":"Update Custom Dialing Pool","api":"POST https://us.api.bland.ai/v1/custom-dialing-pools/{pool_id}/update","href":"/api-v1/post/custom-dialing-pool-update"}]},{"group":"Triage","pages":[{"group":"Issues","pages":[{"title":"Create Issue","api":"POST https://api.bland.ai/v1/triage/issues","href":"/api-v1/post/triage-issues"},{"title":"List Issues","api":"GET https://api.bland.ai/v1/triage/issues","href":"/api-v1/get/triage-issues"},{"title":"Get Issue","api":"GET https://api.bland.ai/v1/triage/issues/{id}","href":"/api-v1/get/triage-issues-id"},{"title":"Update Issue","api":"PATCH https://api.bland.ai/v1/triage/issues/{id}","href":"/api-v1/patch/triage-issues-id"},{"title":"Delete Issue","api":"DELETE https://api.bland.ai/v1/triage/issues/{id}","href":"/api-v1/delete/triage-issues-id"}]},{"group":"Resources","pages":[{"title":"Attach Resource","api":"POST https://api.bland.ai/v1/triage/issues/{id}/resources","href":"/api-v1/post/triage-issues-id-resources"},{"title":"List Resources","api":"GET https://api.bland.ai/v1/triage/issues/{id}/resources","href":"/api-v1/get/triage-issues-id-resources"},{"title":"Remove Resource","api":"DELETE https://api.bland.ai/v1/triage/issues/{id}/resources/{resource_link_id}","href":"/api-v1/delete/triage-issues-id-resources-resource-link-id"},{"title":"Attach Call","api":"PUT https://api.bland.ai/v1/triage/issues/{id}/calls/{call_id}","href":"/api-v1/put/triage-issues-id-calls-call-id"},{"title":"Detach Call","api":"DELETE https://api.bland.ai/v1/triage/issues/{id}/calls/{call_id}","href":"/api-v1/delete/triage-issues-id-calls-call-id"},{"title":"Get Affected Context","api":"GET https://api.bland.ai/v1/triage/issues/{id}/affected","href":"/api-v1/get/triage-issues-id-affected"}]},{"group":"Flags","pages":[{"title":"Add Flag","api":"POST https://api.bland.ai/v1/triage/issues/{id}/flags","href":"/api-v1/post/triage-issues-id-flags"},{"title":"List Flags","api":"GET https://api.bland.ai/v1/triage/issues/{id}/flags","href":"/api-v1/get/triage-issues-id-flags"},{"title":"Remove Flag","api":"DELETE https://api.bland.ai/v1/triage/issues/{id}/flags/{flag_id}","href":"/api-v1/delete/triage-issues-id-flags-flag-id"},{"title":"List Flag Types","api":"GET https://api.bland.ai/v1/triage/flag-types","href":"/api-v1/get/triage-flag-types"}]},{"group":"Activity \u0026 Comments","pages":[{"title":"List Activity","api":"GET https://api.bland.ai/v1/triage/issues/{id}/activity","href":"/api-v1/get/triage-issues-id-activity"},{"title":"Add Comment","api":"POST https://api.bland.ai/v1/triage/issues/{id}/comments","href":"/api-v1/post/triage-issues-id-comments"},{"title":"Mark Issue Viewed","api":"PUT https://api.bland.ai/v1/triage/issues/{id}/view","href":"/api-v1/put/triage-issues-id-view"}]},{"group":"Categories","pages":[{"title":"List Categories","api":"GET https://api.bland.ai/v1/triage/categories","href":"/api-v1/get/triage-categories"},{"title":"Create Category","api":"POST https://api.bland.ai/v1/triage/categories","href":"/api-v1/post/triage-categories"}]},{"group":"Relations","pages":[{"title":"Link Related Issue","api":"POST https://api.bland.ai/v1/triage/issues/{id}/relations","href":"/api-v1/post/triage-issues-id-relations"},{"title":"List Relations","api":"GET https://api.bland.ai/v1/triage/issues/{id}/relations","href":"/api-v1/get/triage-issues-id-relations"},{"title":"Remove Relation","api":"DELETE https://api.bland.ai/v1/triage/issues/{id}/relations/{relation_id}","href":"/api-v1/delete/triage-issues-id-relations-relation-id"}]},{"group":"Norm Sessions","pages":[{"title":"List Agents","api":"GET https://api.bland.ai/v1/triage/agents","href":"/api-v1/get/triage-agents"},{"title":"Create Agent Session","api":"POST https://api.bland.ai/v1/triage/issues/{id}/agent-sessions","href":"/api-v1/post/triage-issues-id-agent-sessions"},{"title":"Prompt Norm","api":"POST https://api.bland.ai/v1/triage/issues/{id}/agent-sessions/{session_id}/prompts","href":"/api-v1/post/triage-issues-id-agent-sessions-session-id-prompts"}]}]},{"group":"Legacy","pages":[{"group":"Conversational Pathways","pages":[{"title":"Get All Pathways Information","api":"GET https://api.bland.ai/v1/pathway","href":"/api-v1/get/all_pathway"},{"title":"Get Single Pathway Information","api":"GET https://api.bland.ai/v1/pathway/{pathway_id}","href":"/api-v1/get/pathway"},{"title":"Get Pathway Session Token","api":"GET https://api.bland.ai/v1/pathway/session","href":"/api-v1/get/pathway-session"},{"title":"Get Pathway Call Events","api":"GET https://api.bland.ai/v1/pathway_calls/{call_id}","href":"/api-v1/get/pathway_calls"},{"title":"Create Pathway","api":"POST https://api.bland.ai/v1/pathway/create","href":"/api-v1/post/pathways"},{"title":"Update Pathway","api":"POST https://api.bland.ai/v1/pathway/{pathway_id}","href":"/api-v1/post/update_pathways"},{"title":"Delete Pathway","api":"DELETE https://api.bland.ai/v1/pathway/{pathway_id}","href":"/api-v1/post/delete_pathway"},{"title":"Generate Pathway","api":"POST https://api.bland.ai/v1/pathway/generate","href":"/api-v1/post/pathway-generate"},{"title":"Get Pathway Generation Status","api":"GET https://api.bland.ai/v1/pathway/generate/status/{job_id}","href":"/api-v1/get/pathway-generate-status-job-id"},{"group":"Pathway Chat","pages":[{"title":"Create Pathway Chat","api":"POST https://us.api.bland.ai/v1/pathway/chat/create","href":"/api-v1/post/pathway-chat-create"},{"title":"Pathway Chat","api":"POST https://us.api.bland.ai/v1/pathway/chat/{id}","href":"/api-v1/post/pathway-chat"},{"title":"Pathway Chat","api":"GET https://us.api.bland.ai/v1/pathway/chat/{id}","href":"/api-v1/get/pathway-chat"}]},{"group":"Pathway Versions","pages":[{"title":"Get Pathway Versions","api":"GET https://api.bland.ai/v1/pathway/{pathway_id}/versions","href":"/api-v1/get/pathway_versions"},{"title":"Get Specific Pathway Version","api":"GET https://api.bland.ai/v1/pathway/{pathway_id}/version/{version_id}","href":"/api-v1/get/pathway_version"},{"title":"Promote Pathway Version","api":"POST https://api.bland.ai/v1/pathway/{pathway_id}/publish","href":"/api-v1/post/pathway-promote"},{"title":"Create Pathway Version","api":"POST https://api.bland.ai/v1/pathway/{pathway_id}/version","href":"/api-v1/post/create_pathway_version"},{"title":"Update Pathway Version","api":"POST https://api.bland.ai/v1/pathway/{pathway_id}/version/{version_number}","href":"/api-v1/post/update-pathway-version"},{"title":"Delete Pathway Version","api":"DELETE https://api.bland.ai/v1/pathway/{pathway_id}/version/{version_id}","href":"/api-v1/delete/pathway_version"}]},{"group":"Pathway Folders","pages":[{"title":"Get All Folders","api":"GET https://us.api.bland.ai/v1/pathway/folders","href":"/api-v1/get/pathway_folders"},{"title":"Get Pathways in Folder","api":"GET https://us.api.bland.ai/v1/pathway/folders/{folder_id}/pathways","href":"/api-v1/get/folder_pathways"},{"title":"Create Folder","api":"POST https://us.api.bland.ai/v1/pathway/folders","href":"/api-v1/post/create_pathway_folder"},{"title":"Delete Folder","api":"DELETE https://us.api.bland.ai/v1/pathway/folders/{folder_id}","href":"/api-v1/delete/pathway_folder"},{"title":"Update Folder","api":"PATCH https://us.api.bland.ai/v1/pathway/folders/{folder_id}","href":"/api-v1/post/update_pathway_folder"},{"title":"Move Pathway","api":"POST https://us.api.bland.ai/v1/pathway/folders/move","href":"/api-v1/post/move-pathway-folder"}]}]},{"group":"Node Tests","pages":[{"title":"Get Node Test Run","api":"GET https://api.bland.ai/v1/node_tests/run/:id","href":"/api-v1/get/node_test_run"},{"title":"Invoke Node Test Run","api":"POST https://api.bland.ai/v1/node_tests/invoke","href":"/api-v1/post/node_test_invoke"}]},{"group":"Web Agents","pages":[{"title":"Create a Web Agent","api":"POST https://api.bland.ai/v1/agents","href":"/api-v1/post/agents"},{"title":"Update Web Agent Settings","api":"POST https://api.bland.ai/v1/agents/{agent_id}","href":"/api-v1/post/agents-id"},{"title":"Authorize a Web Agent Call","api":"POST https://api.bland.ai/v1/agents/{agent_id}/authorize","href":"/api-v1/post/agents-id-authorize"},{"title":"Delete Web Agent","api":"POST https://api.bland.ai/v1/agents/{agent_id}/delete","href":"/api-v1/post/agents-id-delete"},{"title":"List Web Agents","api":"GET https://api.bland.ai/v1/agents","href":"/api-v1/get/agents"}]},{"group":"Personas","pages":[{"title":"List Personas","api":"GET https://api.bland.ai/v1/personas","href":"/api-v1/get/personas"},{"title":"Get Persona","api":"GET https://api.bland.ai/v1/personas/{persona_id}","href":"/api-v1/get/personas-id"},{"title":"Create Persona","api":"POST https://api.bland.ai/v1/personas","href":"/api-v1/post/personas"},{"title":"Update Persona","api":"PATCH https://api.bland.ai/v1/personas/{persona_id}","href":"/api-v1/patch/personas-id"},{"title":"Delete Persona","api":"DELETE https://api.bland.ai/v1/personas/{persona_id}","href":"/api-v1/delete/personas-id"},{"group":"Phone Numbers","pages":[{"title":"Attach Phone Numbers to Persona","api":"POST https://api.bland.ai/v1/personas/{persona_id}/inbound/attach","href":"/api-v1/post/personas-id-inbound-attach"},{"title":"Detach Phone Numbers from Persona","api":"POST https://api.bland.ai/v1/personas/{persona_id}/inbound/detach","href":"/api-v1/post/personas-id-inbound-detach"},{"title":"Update Persona Number Settings","api":"PATCH https://api.bland.ai/v1/personas/{persona_id}/inbound/{phone_number}/settings","href":"/api-v1/patch/personas-id-inbound-phone-settings"}]},{"group":"Versions","pages":[{"title":"List Persona Versions","api":"GET https://api.bland.ai/v1/personas/{persona_id}/versions","href":"/api-v1/get/personas-id-versions"},{"title":"Promote Persona Version","api":"POST https://api.bland.ai/v1/personas/{persona_id}/versions/promote","href":"/api-v1/post/personas-id-versions-promote"},{"title":"Get Specific Persona Version","api":"GET https://api.bland.ai/v1/personas/{persona_id}/versions/{version_id}","href":"/api-v1/get/personas-id-versions-version-id"}]}]},{"group":"Citation Schemas","pages":[{"title":"List Citation Schemas","api":"GET https://api.bland.ai/v1/citation_schemas/list","href":"/api-v1/get/citation-schemas-list"},{"title":"Get Citation Schema","api":"GET https://api.bland.ai/v1/citation_schemas/","href":"/api-v1/get/citation-schemas-id"},{"title":"Create Citation Schema","api":"POST https://api.bland.ai/v1/citation_schemas/","href":"/api-v1/post/citation-schemas"},{"title":"Update Citation Schema","api":"PATCH https://api.bland.ai/v1/citation_schemas/","href":"/api-v1/patch/citation-schemas"},{"title":"Backfill Citation Schema","api":"POST https://api.bland.ai/v1/citation_schemas/backfill","href":"/api-v1/post/citation-schemas-backfill"}]},{"group":"Outcomes","pages":[{"title":"List Outcomes","api":"GET https://api.bland.ai/v1/dispositions","href":"/api-v1/get/dispositions"},{"title":"Create Outcome","api":"POST https://api.bland.ai/v1/dispositions","href":"/api-v1/post/dispositions"},{"title":"Get Outcome","api":"GET https://api.bland.ai/v1/dispositions/{id}","href":"/api-v1/get/dispositions-id"},{"title":"Update Outcome","api":"PATCH https://api.bland.ai/v1/dispositions/{id}","href":"/api-v1/patch/dispositions-id"},{"title":"Delete Outcome","api":"DELETE https://api.bland.ai/v1/dispositions/{id}","href":"/api-v1/delete/dispositions-id"},{"group":"Runs","pages":[{"title":"Run Outcome","api":"POST https://api.bland.ai/v1/dispositions/{id}/run","href":"/api-v1/post/dispositions-id-run"},{"title":"List Outcome Runs","api":"GET https://api.bland.ai/v1/dispositions/{id}/run","href":"/api-v1/get/dispositions-id-run"},{"title":"Get Outcome Run","api":"GET https://api.bland.ai/v1/dispositions/{id}/run/{run_id}","href":"/api-v1/get/dispositions-id-run-run-id"}]}]},{"group":"Alarms","pages":[{"title":"List Alarms","api":"GET https://api.bland.ai/v1/alarms","href":"/api-v1/get/alarms"},{"title":"Create Alarm","api":"POST https://api.bland.ai/v1/alarms","href":"/api-v1/post/alarms"},{"title":"List Alarm Events","api":"GET https://api.bland.ai/v1/alarms/history","href":"/api-v1/get/alarms-history"},{"title":"Get Alarm","api":"GET https://api.bland.ai/v1/alarms/{id}","href":"/api-v1/get/alarms-id"},{"title":"Update Alarm","api":"PATCH https://api.bland.ai/v1/alarms/{id}","href":"/api-v1/patch/alarms-id"},{"title":"Delete Alarm","api":"DELETE https://api.bland.ai/v1/alarms/{id}","href":"/api-v1/delete/alarms-id"},{"title":"Toggle Alarm","api":"POST https://api.bland.ai/v1/alarms/{id}/toggle","href":"/api-v1/post/alarms-id-toggle"},{"title":"Trigger Alarm Evaluation","api":"POST https://api.bland.ai/v1/alarms/{id}/trigger","href":"/api-v1/post/alarms-id-trigger"},{"title":"Test Alarm Notifications","api":"POST https://api.bland.ai/v1/alarms/{id}/notify","href":"/api-v1/post/alarms-id-notify"}]},{"group":"Custom Tools","pages":[{"title":"Create a Custom Tool","api":"POST https://api.bland.ai/v1/tools","href":"/api-v1/post/tools"},{"title":"Update Custom Tool","api":"POST https://api.bland.ai/v1/tools/{tool_id}","href":"/api-v1/post/tools-tool-id"},{"title":"Delete Custom Tool","api":"DELETE https://api.bland.ai/v1/tools/{tool_id}","href":"/api-v1/delete/tools-tool-id"},{"title":"List Custom Tools","api":"GET https://api.bland.ai/v1/tools","href":"/api-v1/get/tools"},{"title":"Custom Tool Details","api":"GET https://api.bland.ai/v1/tools/{tool_id}","href":"/api-v1/get/tools-tool-id"}]},{"group":"Memory Store","pages":[{"title":"List All Memories","api":"GET https://api.bland.ai/v1/memory","href":"/api-v1/get/memory"},{"title":"Get Memory Details","api":"GET https://api.bland.ai/v1/memory/{memory_id}","href":"/api-v1/get/memory-memory-id"},{"title":"Create Memory","api":"POST https://api.bland.ai/v1/memory/create","href":"/api-v1/post/memory-create"},{"title":"Update Memory","api":"POST https://api.bland.ai/v1/memory/{memory_id}/update","href":"/api-v1/post/memory-memory-id-update"},{"title":"Delete Memory","api":"POST https://api.bland.ai/v1/memory/{memory_id}/delete","href":"/api-v1/post/memory-memory-id-delete"},{"group":"User Management","pages":[{"title":"Get User Memory Details","api":"POST https://api.bland.ai/v1/memory/{memory_id}/user","href":"/api-v1/post/memory-memory-id-user"},{"title":"Search User Calls in Memory","api":"POST https://api.bland.ai/v1/memory/{memory_id}/user/search","href":"/api-v1/post/memory-memory-id-user-search"},{"title":"Add User to Memory","api":"POST https://api.bland.ai/v1/memory/{memory_id}/add-user","href":"/api-v1/post/memory-memory-id-add-user"},{"title":"Update User Memory Data","api":"POST https://api.bland.ai/v1/memory/{memory_id}/user/update","href":"/api-v1/post/memory-memory-id-user-update"},{"title":"Remove User from Memory","api":"POST https://api.bland.ai/v1/memory/{memory_id}/user/delete","href":"/api-v1/post/memory-memory-id-user-delete"}]},{"group":"Call Management","pages":[{"title":"Add Call to Memory","api":"POST https://api.bland.ai/v1/memory/{memory_id}/add-call","href":"/api-v1/post/memory-memory-id-add-call"},{"title":"Remove Call from Memory","api":"POST https://api.bland.ai/v1/memory/{memory_id}/call/{call_id}/delete","href":"/api-v1/post/memory-memory-id-call-call-id-delete"}]}]},{"group":"Vector Knowledge Bases","pages":[{"title":"Create a Knowledge Base Item","api":"POST https://api.bland.ai/v1/knowledgebases","href":"/api-v1/post/vectors"},{"title":"Upload Media","api":"POST https://api.bland.ai/v1/knowledgebases/upload-media","href":"/api-v1/post/upload-media"},{"title":"Upload Text","api":"POST https://api.bland.ai/v1/knowledgebases/upload","href":"/api-v1/post/upload-text"},{"title":"Update Knowledge Base Item","api":"PATCH https://api.bland.ai/v1/knowledgebases/{vector_id}","href":"/api-v1/patch/vectors-id"},{"title":"List Knowledge Base Items","api":"GET https://api.bland.ai/v1/knowledgebases","href":"/api-v1/get/vectors"},{"title":"List Knowledge Base Item Details","api":"GET https://api.bland.ai/v1/knowledgebases/{vector_id}","href":"/api-v1/get/vectors-id"},{"title":"Delete Knowledge Base Item","api":"DELETE https://api.bland.ai/v1/knowledgebases/{vector_id}","href":"/api-v1/delete/vectors-id"}]}]}]}]},{"product":"TTS","pages":[{"title":"TTS","href":"/tts/welcome"}]},{"product":"Changelog","pages":[{"title":"Changelog","href":"/changelog/08_03_2026"}]}]},"basePath":"","title":"Send SMS Message - Bland","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["10e4515597","c2aa737661","b0f84f53ff","2b790eda92"],"chunks":["BannerMarkdown-BOAJk9BH.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","Page-CVJ-f_k1.js","CodeSnippet-D_HwgQO_.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","getApiPlaygroundDisplay-CmCoerhe.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js"]}