expected_revision is a compare-and-set token. A fresh workflow’s draft is at revision 0, each save returns the next revision, and publishing resets the new draft to 0. If your value is stale the save fails with 409 revision_conflict carrying current_revision — re-read the draft and retry.
Draft saves accept any well-formed JSON object up to 512 KB. Graph rules (reachability, cycles, node configs) are checked by Validate and enforced at Publish. See Nodes and Conditions and variables for the definition schema.
Authorizations
Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
workflow_id
string<uuid>
required
The unique id of the workflow
Body
application/json
expected_revision
integer
required
The revision you last read. A fresh workflow's draft starts at 0, and publish resets the new draft to 0. A stale value returns 409 revision_conflict carrying current_revision.
Required range: x >= 0
definition
object
required
The workflow graph. nodes is a flat list of node envelopes — {id, type, name, config, cases} — where type is one of start, agent, extraction, api, callback, time, retry, aisensy_whatsapp or end. Each node's cases array routes to the next node via condition expressions (time nodes use a single to instead, end nodes have neither). See Nodes and Conditions and variables for the full schema, and the Node Types API for every config parameter with defaults and bounds.
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Bolna Docs","description":"Quickly build and deploy conversational Voice AI agents","colors":{"primary":"#0073FF","light":"#64AAFF","dark":"#111111"},"logo":{"light":"https://mintcdn.com/bolna-54a2d4fe/VALWWMf7cQUV4GqY/logo/bolna-full-black.svg?fit=max\u0026auto=format\u0026n=VALWWMf7cQUV4GqY\u0026q=85\u0026s=9ad059134ba7338f4da43293d005f1e5","dark":"https://mintcdn.com/bolna-54a2d4fe/VALWWMf7cQUV4GqY/logo/bolna-full-white.svg?fit=max\u0026auto=format\u0026n=VALWWMf7cQUV4GqY\u0026q=85\u0026s=11287fcf7fd00922b6ea065d4247fe83","href":"https://www.bolna.ai/docs"},"favicon":{"light":"https://mintcdn.com/bolna-54a2d4fe/8f2PS3DzbOQMg6a5/favicon-bolna.svg?fit=max\u0026auto=format\u0026n=8f2PS3DzbOQMg6a5\u0026q=85\u0026s=65bdfd76b54fe55c7ea7edae0efb50e9","dark":"https://mintcdn.com/bolna-54a2d4fe/I_65jyMVzaUKonyY/favicon-bolna-white.svg?fit=max\u0026auto=format\u0026n=I_65jyMVzaUKonyY\u0026q=85\u0026s=afa80c7dbb9e76d1a9272c2f716b6aa6"},"api":{"openapi":"api-reference/openapi.yml"},"background":{"decoration":"gradient","color":{"light":"#FFFFFF","dark":"#111111"}},"navbar":{"links":[{"icon":"globe","href":"https://status.bolna.ai","label":"Status"},{"icon":"slack","href":"https://www.bolna.ai/join-slack","label":"Ask us on Slack"},{"icon":"gauge","href":"https://platform.bolna.ai/sign-up","label":"Platform"}]},"footer":{"socials":{"website":"https://platform.bolna.ai","github":"https://github.com/bolna-ai/bolna","slack":"https://www.bolna.ai/join-slack","linkedin":"https://www.linkedin.com/company/bolna-ai","youtube":"https://www.youtube.com/@BolnaVoiceAI","instagram":"https://www.instagram.com/bolna_dev"}},"seo":{"metatags":{"og:type":"website","og:site_name":"Bolna AI Documentation","canonical":"https://www.bolna.ai/docs"},"organization":{"id":"https://www.bolna.ai/#organization","name":"Bolna AI","legalName":"Whismurwave Inc.","url":"https://www.bolna.ai","logo":"https://www.bolna.ai/logos/logo-black.png","sameAs":["https://www.linkedin.com/company/bolna-ai/","https://www.ycombinator.com/companies/bolna-ai","https://github.com/bolna-ai","https://x.com/bolna_dev","https://www.youtube.com/@BolnaVoiceAI"]}},"fonts":{"family":"Anek Latin"},"styling":{"codeblocks":"system","latex":false},"integrations":{"ga4":{"measurementId":"G-BJ5QXHE52P"},"gtm":{"tagId":"GTM-53BBWG2J"}},"contextual":{"options":["copy","view","chatgpt","claude","add-mcp","cursor","vscode"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bolna-54a2d4fe","hasAudioNarration":false,"actualSubdomain":"bolna-54a2d4fe","customDomains":["www.bolna.ai"],"gitSource":{"type":"github","owner":"bolna-ai","repo":"docs","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afbe6cdbe968fe83b2889b4","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Voice Agents","count":158},{"language":"default","tag":"API Reference","count":144},{"language":"default","tag":"Build","count":77},{"language":"default","tag":"Deploy","count":60},{"language":"default","tag":"Integrations","count":60},{"language":"default","tag":"Workflows","count":59},{"language":"default","tag":"Voice agents","count":48},{"language":"default","tag":"AI models","count":42},{"language":"default","tag":"Developers","count":41},{"language":"default","tag":"Telephony","count":36}]},"assistantConfig":{"deflection":{"enabled":true,"email":"support@bolna.ai"}},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":":root{--bolna-black: #111111;--bolna-grey-05: #262626;--bolna-grey-04: #5b5c5c;--bolna-grey-02: #d0d0d0;--bolna-grey-01: #f2f2f2;--bolna-blue: #0073ff;--bolna-radius-button: 12px;--bolna-radius-card: 16px}#banner{background-color:var(--bolna-black)!important}img[src*=\"bolna-full-\"]{height:26px!important;width:auto!important;max-height:unset!important;max-width:unset!important}.update-container{flex-direction:column!important;align-items:stretch!important}.update-container>div:first-child{position:static!important;width:auto!important;margin-bottom:0.5rem}#content-container,#content-container :is(p,li,td,th,dd,dt,span,div){hyphens:none!important;-webkit-hyphens:none!important}#content-container code:not(pre code){word-break:normal!important;overflow-wrap:break-word!important}:is(h1,h2,h3,#page-title){letter-spacing:-0.02em}:root{font-size-adjust:0.546}:is(code,pre,kbd,samp){font-size-adjust:none}.card{border-radius:var(--bolna-radius-card)!important}.card:hover{border-color:var(--bolna-black)!important}html.dark .card:hover{border-color:#ffffff!important}"}]}
{"page":{"pagePath":"api-reference/workflows/save-draft","slug":"/api-reference/workflows/save-draft","pageMetadata":{"title":"Save workflow draft API","sidebarTitle":"Save draft","description":"Save the draft definition using an optimistic-concurrency revision token, so concurrent editors never silently overwrite each other.","openapi":"PUT /workflows/{workflow_id}/draft","last_reviewed":"2026-08-22","href":"/api-reference/workflows/save-draft"},"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: \"Save the draft definition using an optimistic-concurrency revision token, so concurrent editors never silently overwrite each other.\"\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`,p:`p`,..._provideComponents(),...props.components},{Info,Note}=_components;if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`expected_revision`}),` is a compare-and-set token. A fresh workflow’s draft is at revision `,_jsx(_components.code,{children:`0`}),`, each save returns the next revision, and publishing resets the new draft to `,_jsx(_components.code,{children:`0`}),`. If your value is stale the save fails with `,_jsx(_components.code,{children:`409 revision_conflict`}),` carrying `,_jsx(_components.code,{children:`current_revision`}),` — re-read the draft and retry.`]})}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Draft saves accept any well-formed JSON object up to 512 KB. Graph rules (reachability, cycles, node configs) are checked by `,_jsx(_components.a,{href:`/api-reference/workflows/validate`,children:`Validate`}),` and enforced at `,_jsx(_components.a,{href:`/api-reference/workflows/publish`,children:`Publish`}),`. See `,_jsx(_components.a,{href:`/workflows/nodes`,children:`Nodes`}),` and `,_jsx(_components.a,{href:`/workflows/conditions-and-variables`,children:`Conditions and variables`}),` for the definition schema.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Save workflow draft API","sidebarTitle":"Save draft","description":"Save the draft definition using an optimistic-concurrency revision token, so concurrent editors never silently overwrite each other.","openapi":"PUT /workflows/{workflow_id}/draft","last_reviewed":"2026-08-22","href":"/api-reference/workflows/save-draft"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/bolna-54a2d4fe/73314f84f6e30c14/custom.js","/docs/_mintlify/custom/bolna-54a2d4fe/786be19ebac8ab86/faq-schema.js"],"openApiReferenceData":{"operation":{"description":"Save the draft definition using an optimistic-concurrency revision token, so concurrent editors never silently overwrite each other.","parameters":["f6673e61-df4f-43ee-8cc2-724e091d2fa4"],"requestBody":"ea56775f-9a42-4382-a624-84ccdcab70c0","responses":{"200":"8d8648c0-fafa-4ddf-af51-19015807db1b","404":"d866096b-58b7-4a35-aeae-257ed5e6aa71","409":"e5367553-bf07-4fa2-a891-d539d7f6b9ab","413":"5243c825-591a-4fc0-af59-441906b051ae","422":"3d8d6299-f9c4-494c-b3bd-957c6d6f600b"},"method":"put","type":"path","servers":["29c81783-4641-4f42-ad5d-aa453caf6131"],"security":["0c29262b-7203-4b55-9118-4f345a51c1d5"],"path":"/workflows/{workflow_id}/draft","baseUrlOptions":["https://api.bolna.ai"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"f6673e61-df4f-43ee-8cc2-724e091d2fa4":{"in":"path","name":"workflow_id","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"description":"The unique `id` of the workflow","uniqueKey":"","typeLabel":"string\u003cuuid>"},"description":"The unique `id` of the workflow"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["definition","expected_revision"],"properties":{"expected_revision":{"type":"integer","minimum":0,"description":"The revision you last read. A fresh workflow's draft starts at `0`, and publish resets the new draft to `0`. A stale value returns `409 revision_conflict` carrying `current_revision`.","isRequired":true,"uniqueKey":"expected_revision","typeLabel":"integer"},"definition":{"type":"object","description":"The workflow graph. `nodes` is a flat list of node envelopes — `{id, type, name, config, cases}` — where `type` is one of `start`, `agent`, `extraction`, `api`, `callback`, `time`, `retry`, `aisensy_whatsapp` or `end`. Each node's `cases` array routes to the next node via condition expressions (`time` nodes use a single `to` instead, `end` nodes have neither). See [Nodes](/workflows/nodes) and [Conditions and variables](/workflows/conditions-and-variables) for the full schema, and the [Node Types API](/api-reference/workflows/node-types) for every config parameter with defaults and bounds.\n","required":["entry_node_id","on_no_match","nodes"],"properties":{"entry_node_id":{"type":"string","description":"The `id` of the workflow's single `start` node.","example":"n_start","isRequired":true,"uniqueKey":"definition.entry_node_id","typeLabel":"string"},"on_no_match":{"type":"string","description":"Workflow-wide fallback — the node an execution moves to when none of a node's cases match and the node declares no `on_no_match` of its own. Usually an `end` node.","example":"n_end_unhandled","isRequired":true,"uniqueKey":"definition.on_no_match","typeLabel":"string"},"nodes":{"type":"array","maxItems":200,"description":"The node envelopes making up the graph.","items":{"type":"object","uniqueKey":"definition.nodes.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"definition.nodes","typeLabel":"object[]"}},"example":{"entry_node_id":"n_start","on_no_match":"n_end_unhandled","nodes":[{"id":"n_start","type":"start","config":{"trigger":{"kind":"manual"}},"cases":[{"when":{"always":true},"then":{"to":"n_call1"}}]},{"id":"n_call1","type":"agent","name":"Qualify","config":{"agent_id":"123e4567-e89b-12d3-a456-426655440000","timeout_s":3600},"cases":[{"when":{"cmp":"==","left":{"var":"call.status"},"right":{"const":"completed"}},"then":{"to":"n_end_done"}}]},{"id":"n_end_done","type":"end","config":{"label":"reached","outcome":"success"}},{"id":"n_end_unhandled","type":"end","config":{"label":"unhandled","outcome":"failure"}}]},"isRequired":true,"uniqueKey":"definition","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"expected_revision":1,"definition":{"entry_node_id":"n_start","on_no_match":"n_end_unhandled","nodes":[{"id":"n_start","type":"start","config":{"trigger":{"kind":"manual"}},"cases":[{"when":{"always":true},"then":{"to":"n_call1"}}]},{"id":"n_call1","type":"agent","name":"Qualify","config":{"agent_id":"123e4567-e89b-12d3-a456-426655440000","timeout_s":3600},"cases":[{"when":{"cmp":"==","left":{"var":"call.status"},"right":{"const":"completed"}},"then":{"to":"n_end_done"}}]},{"id":"n_end_done","type":"end","config":{"label":"reached","outcome":"success"}},{"id":"n_end_unhandled","type":"end","config":{"label":"unhandled","outcome":"failure"}}]}}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"8d8648c0-fafa-4ddf-af51-19015807db1b":{"description":"Draft saved","content":{"application/json":{"schema":{"type":"object","properties":{"revision":{"type":"integer","description":"The new draft revision. Send it as `expected_revision` on the next save.","isRequired":true,"uniqueKey":"revision","typeLabel":"integer"}},"required":["revision"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"revision":123}}},"exampleType":"generated"}},"exampleType":"generated"},"d866096b-58b7-4a35-aeae-257ed5e6aa71":{"description":"Workflow not found","content":{"application/json":{"schema":{"type":"object","description":"Error envelope returned by every workflow endpoint. `detail.code` is a stable machine-readable code; extra keys (such as `current_revision` on `revision_conflict`, `execution_id` on `duplicate_run`, or `issues` on `invalid_definition`) ride alongside it.","required":["detail"],"properties":{"detail":{"type":"object","additionalProperties":true,"required":["code","message"],"properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"revision_conflict","isRequired":true,"uniqueKey":"detail.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation.","isRequired":true,"uniqueKey":"detail.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"detail","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":{"code":"revision_conflict","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"e5367553-bf07-4fa2-a891-d539d7f6b9ab":{"description":"`revision_conflict` — `expected_revision` is stale. The response carries `current_revision`.","content":{"application/json":{"schema":{"type":"object","description":"Error envelope returned by every workflow endpoint. `detail.code` is a stable machine-readable code; extra keys (such as `current_revision` on `revision_conflict`, `execution_id` on `duplicate_run`, or `issues` on `invalid_definition`) ride alongside it.","required":["detail"],"properties":{"detail":{"type":"object","additionalProperties":true,"required":["code","message"],"properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"revision_conflict","isRequired":true,"uniqueKey":"detail.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation.","isRequired":true,"uniqueKey":"detail.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"detail","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":{"code":"revision_conflict","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"5243c825-591a-4fc0-af59-441906b051ae":{"description":"Definition exceeds 512 KB","content":{"application/json":{"schema":{"type":"object","description":"Error envelope returned by every workflow endpoint. `detail.code` is a stable machine-readable code; extra keys (such as `current_revision` on `revision_conflict`, `execution_id` on `duplicate_run`, or `issues` on `invalid_definition`) ride alongside it.","required":["detail"],"properties":{"detail":{"type":"object","additionalProperties":true,"required":["code","message"],"properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"revision_conflict","isRequired":true,"uniqueKey":"detail.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation.","isRequired":true,"uniqueKey":"detail.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"detail","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":{"code":"revision_conflict","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"3d8d6299-f9c4-494c-b3bd-957c6d6f600b":{"description":"Malformed JSON body","content":{"application/json":{"schema":{"type":"object","description":"Error envelope returned by every workflow endpoint. `detail.code` is a stable machine-readable code; extra keys (such as `current_revision` on `revision_conflict`, `execution_id` on `duplicate_run`, or `issues` on `invalid_definition`) ride alongside it.","required":["detail"],"properties":{"detail":{"type":"object","additionalProperties":true,"required":["code","message"],"properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"revision_conflict","isRequired":true,"uniqueKey":"detail.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation.","isRequired":true,"uniqueKey":"detail.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"detail","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":{"code":"revision_conflict","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"0c29262b-7203-4b55-9118-4f345a51c1d5":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"29c81783-4641-4f42-ad5d-aa453caf6131":{"url":"https://api.bolna.ai","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.yml"},"subdomain":"bolna-54a2d4fe","siteName":"Bolna Docs","title":"Save workflow draft API - Bolna Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-05T06:49:35.561Z","originalFileLocation":"api-reference/workflows/save-draft.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=\"Save the draft definition using an optimistic-concurrency revision token, so concurrent editors never silently overwrite each other.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bolna Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/bolna-54a2d4fe/cQLQhIXNsgk9iuEx/_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=\"/docs/mintlify-assets/_mintlify/favicons/bolna-54a2d4fe/cQLQhIXNsgk9iuEx/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/bolna-54a2d4fe/cQLQhIXNsgk9iuEx/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/bolna-54a2d4fe/cQLQhIXNsgk9iuEx/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/bolna-54a2d4fe/cQLQhIXNsgk9iuEx/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/bolna-54a2d4fe/cQLQhIXNsgk9iuEx/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/bolna-54a2d4fe/cQLQhIXNsgk9iuEx/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/bolna-54a2d4fe/cQLQhIXNsgk9iuEx/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/bolna-54a2d4fe/cQLQhIXNsgk9iuEx/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Save workflow draft API - Bolna Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Save the draft definition using an optimistic-concurrency revision token, so concurrent editors never silently overwrite each other.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bolna AI Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.bolna.ai/docs/api-reference/workflows/save-draft\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bolna-54a2d4fe.mintlify.site/docs/_mintlify/api/og/v2?division=Workflows\u0026amp;title=Save+workflow+draft+API\u0026amp;description=Save+the+draft+definition+using+an+optimistic-concurrency+revision+token%2C+so+concurrent+editors+never+silently+overwrite+each+other.\u0026amp;theme=f2dcce2f7fc3b944c1c433e4\u0026amp;signature=090731b248b30fc1ce40ba988704b1e35e4815f25f2ade2337458b555382b048\">\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=\"Save workflow draft API - Bolna Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Save the draft definition using an optimistic-concurrency revision token, so concurrent editors never silently overwrite each other.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bolna-54a2d4fe.mintlify.site/docs/_mintlify/api/og/v2?division=Workflows\u0026amp;title=Save+workflow+draft+API\u0026amp;description=Save+the+draft+definition+using+an+optimistic-concurrency+revision+token%2C+so+concurrent+editors+never+silently+overwrite+each+other.\u0026amp;theme=f2dcce2f7fc3b944c1c433e4\u0026amp;signature=090731b248b30fc1ce40ba988704b1e35e4815f25f2ade2337458b555382b048\">\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=\"/docs/mintlify-assets/_mintlify/favicons/bolna-54a2d4fe/cQLQhIXNsgk9iuEx/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bolna Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0073FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.bolna.ai/docs/api-reference/workflows/save-draft\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/workflows/save-draft.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.bolna.ai/#organization\",\"name\":\"Bolna AI\",\"legalName\":\"Whismurwave Inc.\",\"url\":\"https://www.bolna.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://www.bolna.ai/logos/logo-black.png\"},\"sameAs\":[\"https://www.linkedin.com/company/bolna-ai/\",\"https://www.ycombinator.com/companies/bolna-ai\",\"https://github.com/bolna-ai\",\"https://x.com/bolna_dev\",\"https://www.youtube.com/@BolnaVoiceAI\"]},{\"@type\":\"WebSite\",\"@id\":\"https://www.bolna.ai/docs#website\",\"name\":\"Bolna Docs\",\"url\":\"https://www.bolna.ai/docs\",\"publisher\":{\"@id\":\"https://www.bolna.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.bolna.ai/docs/api-reference/workflows/save-draft#webpage\",\"url\":\"https://www.bolna.ai/docs/api-reference/workflows/save-draft\",\"name\":\"Save workflow draft API\",\"description\":\"Save the draft definition using an optimistic-concurrency revision token, so concurrent editors never silently overwrite each other.\",\"dateModified\":\"2026-10-05T06:49:35.561Z\",\"isPartOf\":{\"@id\":\"https://www.bolna.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.bolna.ai/docs/api-reference/workflows/save-draft#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.bolna.ai/docs/api-reference/workflows/save-draft#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Workflows\",\"item\":\"https://www.bolna.ai/docs/api-reference/workflows/create\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Workflows\",\"item\":\"https://www.bolna.ai/docs/api-reference/workflows/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Save workflow draft API\",\"item\":\"https://www.bolna.ai/docs/api-reference/workflows/save-draft\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.bolna.ai/docs/api-reference/workflows/save-draft#apireference\",\"headline\":\"Save workflow draft API\",\"name\":\"Save workflow draft API\",\"description\":\"Save the draft definition using an optimistic-concurrency revision token, so concurrent editors never silently overwrite each other.\",\"url\":\"https://www.bolna.ai/docs/api-reference/workflows/save-draft\",\"mainEntityOfPage\":{\"@id\":\"https://www.bolna.ai/docs/api-reference/workflows/save-draft#webpage\"},\"dateModified\":\"2026-10-05T06:49:35.561Z\",\"publisher\":{\"@id\":\"https://www.bolna.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://www.bolna.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bolna Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Bolna AI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/workflows/save-draft.md","siteName":"Bolna Docs","nav":{"global":null,"tabs":[{"tab":"Overview","icon":"book","pages":[{"title":"Overview","href":""}]},{"tab":"Voice Agents","icon":"waveform-lines","pages":[{"title":"Voice Agents","href":"/agents/overview"}]},{"tab":"Integrations","icon":"plug","pages":[{"title":"Integrations","href":"/integrations"}]},{"tab":"API Reference","icon":"terminal","groups":[{"group":"Get started","icon":"play","pages":[{"title":"Bolna API documentation","sidebarTitle":"API overview","icon":"code","iconType":"solid","href":"/api-reference/introduction"},{"title":"API authentication","icon":"key","href":"/api-reference/authentication"},{"title":"Pagination for Bolna APIs","sidebarTitle":"Pagination","icon":"ellipsis","iconType":"solid","href":"/api-reference/pagination"},{"title":"Rate limiting for Bolna APIs","sidebarTitle":"Rate limits","icon":"gauge-max","iconType":"solid","href":"/api-reference/rate-limiting"},{"title":"Errors \u0026 status codes","sidebarTitle":"API errors","icon":"triangle-exclamation","href":"/api-reference/errors"},{"title":"Limits \u0026 quotas","sidebarTitle":"Account limits","icon":"gauge","href":"/api-reference/limits"}]},{"group":"Voice agents","icon":"robot","pages":[{"group":"Agents","icon":"robot","root":{"title":"Bolna voice AI agent APIs overview","sidebarTitle":"Overview","icon":"book-open","href":"/api-reference/agent/v2/overview"},"expanded":false,"pages":[{"title":"Retrieve voice AI agent details API","sidebarTitle":"Get agent","openapi":"GET /v2/agent/{agent_id}","href":"/api-reference/agent/v2/get"},{"title":"Create voice AI agent API","sidebarTitle":"Create agent","openapi":"POST /v2/agent","href":"/api-reference/agent/v2/create"},{"title":"Update voice AI agent API","sidebarTitle":"Update agent","openapi":"PUT /v2/agent/{agent_id}","href":"/api-reference/agent/v2/update"},{"title":"Patch update to voice AI agent API","sidebarTitle":"Patch update agent","openapi":"PATCH /v2/agent/{agent_id}","href":"/api-reference/agent/v2/patch_update"},{"title":"Get pronunciation status API","sidebarTitle":"Get pronunciation status","openapi":"GET /v2/agent/{agent_id}/pronunciation-dictionary-status","href":"/api-reference/agent/v2/get_pronunciation_status"},{"title":"List all voice AI agents API","sidebarTitle":"List agents","openapi":"GET /v2/agent/all","href":"/api-reference/agent/v2/get_all"},{"title":"Retrieve voice AI agent execution API","sidebarTitle":"Get agent execution","openapi":"GET /agent/{agent_id}/execution/{execution_id}","href":"/api-reference/agent/v2/get_agent_execution"},{"title":"Delete voice AI agent API","sidebarTitle":"Delete agent","openapi":"DELETE /v2/agent/{agent_id}","href":"/api-reference/agent/v2/delete"},{"title":"Stop agent queued calls API","sidebarTitle":"Stop agent calls","openapi":"POST /v2/agent/{agent_id}/stop","href":"/api-reference/agent/v2/stop"}]},{"group":"Calls","icon":"phone","root":{"title":"Calling APIs overview","sidebarTitle":"Overview","icon":"book-open","href":"/api-reference/calls/overview"},"expanded":false,"pages":[{"title":"Make voice AI call API","sidebarTitle":"Make phone call","openapi":"POST /call","href":"/api-reference/calls/make"},{"title":"Stop a previously initiated voice AI call API","sidebarTitle":"Stop phone call","openapi":"POST /call/{execution_id}/stop","href":"/api-reference/calls/stop_call"}]},{"group":"Executions","icon":"list","root":{"title":"Executions APIs overview","sidebarTitle":"Overview","icon":"book-open","href":"/api-reference/executions/overview"},"expanded":false,"pages":[{"title":"Retrieve voice AI execution API","sidebarTitle":"Get execution","openapi":"GET /executions/{execution_id}","href":"/api-reference/executions/get_execution"},{"title":"Retrieve voice AI execution raw logs API","sidebarTitle":"Get raw logs","openapi":"GET /executions/{execution_id}/log","href":"/api-reference/executions/get_execution_raw_logs"},{"title":"Retrieve voice AI execution debug bundle API","sidebarTitle":"Get debug bundle","openapi":"GET /executions/{execution_id}/debug","href":"/api-reference/executions/get_execution_debug"},{"title":"Get batch executions API","sidebarTitle":"Get batch executions","openapi":"GET /batches/{batch_id}/executions","href":"/api-reference/executions/get_batch_executions"},{"title":"Get all voice AI agent executions API","sidebarTitle":"Get agent executions","openapi":"GET /v2/agent/{agent_id}/executions","href":"/api-reference/executions/get_executions"}]},{"group":"Agent versions","icon":"code-branch","root":{"title":"Agent versions APIs overview","sidebarTitle":"Overview","icon":"book-open","href":"/api-reference/agent/v2/versions/overview"},"expanded":false,"pages":[{"title":"List agent versions API","sidebarTitle":"List versions","openapi":"GET /v2/agent/{agent_id}/versions","href":"/api-reference/agent/v2/versions/list"},{"title":"Get agent version API","sidebarTitle":"Get version","openapi":"GET /v2/agent/{agent_id}/versions/{agent_version_id}","href":"/api-reference/agent/v2/versions/get"},{"title":"Save agent as a new version API","sidebarTitle":"Save as new version","openapi":"POST /v2/agent/{agent_id}/versions","href":"/api-reference/agent/v2/versions/create"},{"title":"Update agent version API","sidebarTitle":"Update version","openapi":"PUT /v2/agent/{agent_id}/versions/{agent_version_id}","href":"/api-reference/agent/v2/versions/update"},{"title":"Rename agent version API","sidebarTitle":"Rename version","openapi":"PATCH /v2/agent/{agent_id}/versions/{agent_version_id}","href":"/api-reference/agent/v2/versions/patch"},{"title":"Make agent version live API","sidebarTitle":"Make version live","openapi":"POST /v2/agent/{agent_id}/versions/{agent_version_id}/set_current","href":"/api-reference/agent/v2/versions/set_current"},{"title":"Delete agent version API","sidebarTitle":"Delete version","openapi":"DELETE /v2/agent/{agent_id}/versions/{agent_version_id}","href":"/api-reference/agent/v2/versions/delete"}]},{"group":"Batches","icon":"layer-group","root":{"title":"Batch APIs overview","sidebarTitle":"Overview","icon":"book-open","href":"/api-reference/batches/overview"},"expanded":false,"pages":[{"title":"Create batch API","sidebarTitle":"Create batch","openapi":"POST /batches","href":"/api-reference/batches/create"},{"title":"Schedule batch API","sidebarTitle":"Schedule batch","openapi":"POST /batches/{batch_id}/schedule","href":"/api-reference/batches/schedule"},{"title":"Get batch API","sidebarTitle":"Get batch","openapi":"GET /batches/{batch_id}","href":"/api-reference/batches/get_batch"},{"title":"List all batches API","sidebarTitle":"List all batches","openapi":"GET /batches/{agent_id}/all","href":"/api-reference/batches/get_batches"},{"title":"List batch executions API","sidebarTitle":"Batch executions","openapi":"GET /batches/{batch_id}/executions","href":"/api-reference/batches/executions"},{"title":"List batch executions API (v2)","sidebarTitle":"Batch executions (v2)","openapi":"GET /v2/batches/{batch_id}/executions","href":"/api-reference/batches/executions_v2"},{"title":"Stop batch API","sidebarTitle":"Stop batch","openapi":"POST /batches/{batch_id}/stop","href":"/api-reference/batches/stop"},{"title":"Delete batch API","sidebarTitle":"Delete a batch","openapi":"DELETE /batches/{batch_id}","href":"/api-reference/batches/delete"}]},{"group":"Knowledge bases","icon":"book","root":{"title":"Knowledge bases overview","sidebarTitle":"Knowledge bases","icon":"book-open","href":"/api-reference/knowledgebase/overview"},"expanded":false,"pages":[{"title":"Create knowledge base API","sidebarTitle":"Create knowledge base","openapi":"POST /knowledgebase","href":"/api-reference/knowledgebase/create"},{"title":"Get knowledge base API","sidebarTitle":"Get knowledge base","openapi":"GET /knowledgebase/{rag_id}","href":"/api-reference/knowledgebase/get_knowledgebase"},{"title":"List all knowledge bases API","sidebarTitle":"List knowledge bases","openapi":"GET /knowledgebase/all","href":"/api-reference/knowledgebase/get_knowledgebases"},{"title":"Delete knowledge base API","sidebarTitle":"Delete knowledge base","openapi":"DELETE /knowledgebase/{rag_id}","href":"/api-reference/knowledgebase/delete"}]},{"group":"Voices","icon":"microphone-lines","root":{"title":"Voice APIs overview","sidebarTitle":"Overview","icon":"microphone-lines","iconType":"solid","href":"/api-reference/voice/overview"},"expanded":false,"pages":[{"title":"List TTS providers and models","sidebarTitle":"List providers","openapi":"GET /api/v1/voice-config/tts","href":"/api-reference/voice/get_providers"},{"title":"List voices","sidebarTitle":"List voices","openapi":"GET /api/v1/voice-config/tts/voices","href":"/api-reference/voice/get_all"}]},{"group":"Dispositions","icon":"tags","root":{"title":"Dispositions API overview","sidebarTitle":"Overview","icon":"book-open","href":"/api-reference/dispositions/overview"},"expanded":false,"pages":[{"title":"List dispositions API","sidebarTitle":"List dispositions","openapi":"GET /dispositions/","href":"/api-reference/dispositions/list"},{"title":"Get disposition API","sidebarTitle":"Get disposition","openapi":"GET /dispositions/{disposition_id}","href":"/api-reference/dispositions/get"},{"title":"Create disposition API","sidebarTitle":"Create disposition","openapi":"POST /dispositions/","href":"/api-reference/dispositions/create"},{"title":"Bulk create dispositions API","sidebarTitle":"Bulk create","openapi":"POST /dispositions/bulk","href":"/api-reference/dispositions/bulk-create"},{"title":"Update disposition API","sidebarTitle":"Update disposition","openapi":"PUT /dispositions/{disposition_id}","href":"/api-reference/dispositions/update"},{"title":"Delete disposition API","sidebarTitle":"Delete disposition","openapi":"DELETE /dispositions/{disposition_id}","href":"/api-reference/dispositions/delete"},{"title":"Test dispositions API","sidebarTitle":"Test dispositions","openapi":"POST /v2/agent/{agent_id}/dispositions/test","href":"/api-reference/dispositions/test"}]},{"group":"Extraction categories","icon":"filter","root":{"title":"Extraction categories API overview","sidebarTitle":"Overview","icon":"book-open","href":"/api-reference/extraction-categories/overview"},"expanded":false,"pages":[{"title":"List extraction categories API","sidebarTitle":"List categories","openapi":"GET /agent/{agent_id}/extraction-categories","href":"/api-reference/extraction-categories/list"},{"title":"Create extraction category API","sidebarTitle":"Create category","openapi":"POST /agent/{agent_id}/extraction-categories","href":"/api-reference/extraction-categories/create"},{"title":"Update extraction category API","sidebarTitle":"Update category","openapi":"PATCH /extraction-categories/{category_id}","href":"/api-reference/extraction-categories/update"},{"title":"Delete extraction category API","sidebarTitle":"Delete category","openapi":"DELETE /extraction-categories/{category_id}","href":"/api-reference/extraction-categories/delete"}]}]},{"group":"Telephony","icon":"tower-cell","pages":[{"group":"Phone numbers","icon":"hashtag","root":{"title":"Phone numbers APIs overview","sidebarTitle":"Overview","icon":"book-open","href":"/api-reference/phone-numbers/overview"},"expanded":false,"pages":[{"title":"Search phone numbers API ","sidebarTitle":"Search phone numbers","openapi":"GET /phone-numbers/search","href":"/api-reference/phone-numbers/search"},{"title":"Buy phone numbers API ","sidebarTitle":"Buy phone numbers","openapi":"POST /phone-numbers/buy","href":"/api-reference/phone-numbers/buy"},{"title":"List phone numbers API ","sidebarTitle":"List phone numbers","openapi":"GET /phone-numbers/all","href":"/api-reference/phone-numbers/get_all"},{"title":"Move phone number API","sidebarTitle":"Move phone number","openapi":"POST /phone-numbers/move","href":"/api-reference/phone-numbers/move"},{"title":"Delete phone numbers API ","sidebarTitle":"Delete phone numbers","openapi":"DELETE /phone-numbers/{phone_number_id}","href":"/api-reference/phone-numbers/delete"}]},{"group":"Compliance","icon":"file-certificate","root":{"title":"Compliance APIs overview","sidebarTitle":"Overview","icon":"book-open","href":"/api-reference/compliance/overview"},"expanded":false,"pages":[{"title":"List compliance applications API","sidebarTitle":"List applications","openapi":"GET /compliance/list","href":"/api-reference/compliance/list"},{"title":"Create compliance application API","sidebarTitle":"Create application","openapi":"POST /compliance/create","href":"/api-reference/compliance/create"},{"title":"Get compliance application API","sidebarTitle":"Get application","openapi":"GET /compliance/{compliance_id}","href":"/api-reference/compliance/get"},{"title":"Delete compliance application API","sidebarTitle":"Delete application","openapi":"DELETE /compliance/{compliance_id}","href":"/api-reference/compliance/delete"}]},{"group":"Inbound","icon":"phone-arrow-down-left","root":{"title":"Inbound Bolna voice AI agent APIs overview","sidebarTitle":"Overview","icon":"book-open","href":"/api-reference/inbound/overview"},"expanded":false,"pages":[{"title":"Set inbound agent API","sidebarTitle":"Set inbound agent","openapi":"POST /inbound/setup","href":"/api-reference/inbound/agent"},{"title":"Remove inbound agent API","sidebarTitle":"Unlink inbound agent","openapi":"POST /inbound/unlink","href":"/api-reference/inbound/unlink"}]},{"group":"SIP trunks","icon":"network-wired","root":{"title":"SIP trunks API overview","sidebarTitle":"Overview","icon":"book-open","href":"/api-reference/trunks/overview"},"expanded":false,"pages":[{"title":"List SIP trunks API","sidebarTitle":"List trunks","openapi":"GET /trunk/trunks","href":"/api-reference/trunks/list"},{"title":"Create SIP trunk API","sidebarTitle":"Create trunk","openapi":"POST /trunk/trunks","href":"/api-reference/trunks/create"},{"title":"Get SIP trunk API","sidebarTitle":"Get trunk","openapi":"GET /trunk/trunks/{trunk_id}","href":"/api-reference/trunks/get"},{"title":"Update SIP trunk API","sidebarTitle":"Update trunk","openapi":"PATCH /trunk/trunks/{trunk_id}","href":"/api-reference/trunks/update"},{"title":"Delete SIP trunk API","sidebarTitle":"Delete trunk","openapi":"DELETE /trunk/trunks/{trunk_id}","href":"/api-reference/trunks/delete"},{"title":"Add gateway to SIP trunk API","sidebarTitle":"Add gateway","openapi":"POST /trunk/trunks/{trunk_id}/gateways","href":"/api-reference/trunks/add_gateway"},{"title":"Remove gateway from SIP trunk API","sidebarTitle":"Remove gateway","openapi":"DELETE /trunk/trunks/{trunk_id}/gateways/{gateway_id}","href":"/api-reference/trunks/remove_gateway"},{"title":"Add carrier IP to SIP trunk API","sidebarTitle":"Add carrier IP","openapi":"POST /trunk/trunks/{trunk_id}/ip-acls","href":"/api-reference/trunks/add_carrier_ip"},{"title":"Remove carrier IP from SIP trunk API","sidebarTitle":"Remove carrier IP","openapi":"DELETE /trunk/trunks/{trunk_id}/ip-acls/{acl_id}","href":"/api-reference/trunks/remove_carrier_ip"},{"title":"Add number to SIP trunk API","sidebarTitle":"Add number","openapi":"POST /trunk/trunks/{trunk_id}/numbers","href":"/api-reference/trunks/add_number"},{"title":"Remove number from SIP trunk API","sidebarTitle":"Remove number","openapi":"DELETE /trunk/trunks/{trunk_id}/numbers/{number_id}","href":"/api-reference/trunks/remove_number"},{"title":"Assign agent to SIP trunk number API","sidebarTitle":"Assign agent","openapi":"PATCH /trunk/numbers/{number_id}","href":"/api-reference/trunks/assign_agent"},{"title":"List SIP trunk calls API","sidebarTitle":"List calls","openapi":"GET /trunk/trunks/{trunk_id}/calls","href":"/api-reference/trunks/list_calls"},{"title":"Get SIP trunk connection details API","sidebarTitle":"Connection details","openapi":"GET /trunk/pop","href":"/api-reference/trunks/connection_details"}]},{"group":"SIP trunks (legacy)","icon":"box-archive","root":{"title":"SIP trunk API reference","sidebarTitle":"Overview","icon":"book-open","href":"/api-reference/sip-trunks/overview"},"expanded":false,"pages":[{"title":"Create SIP trunk","sidebarTitle":"Create trunk","openapi":"POST /sip-trunks/trunks","href":"/api-reference/sip-trunks/create"},{"title":"List SIP trunks","sidebarTitle":"List trunks","openapi":"GET /sip-trunks/trunks","href":"/api-reference/sip-trunks/get_all"},{"title":"Get SIP trunk","sidebarTitle":"Get trunk","openapi":"GET /sip-trunks/trunks/{trunk_id}","href":"/api-reference/sip-trunks/get"},{"title":"Update SIP trunk","sidebarTitle":"Update trunk","openapi":"PATCH /sip-trunks/trunks/{trunk_id}","href":"/api-reference/sip-trunks/update"},{"title":"Delete SIP trunk","sidebarTitle":"Delete trunk","openapi":"DELETE /sip-trunks/trunks/{trunk_id}","href":"/api-reference/sip-trunks/delete"},{"title":"Add phone number to trunk","sidebarTitle":"Add number","openapi":"POST /sip-trunks/trunks/{trunk_id}/numbers","href":"/api-reference/sip-trunks/add_number"},{"title":"List phone numbers on trunk","sidebarTitle":"List numbers","openapi":"GET /sip-trunks/trunks/{trunk_id}/numbers","href":"/api-reference/sip-trunks/list_numbers"},{"title":"Remove phone number from trunk","sidebarTitle":"Remove number","openapi":"DELETE /sip-trunks/trunks/{trunk_id}/numbers/{phone_number_id}","href":"/api-reference/sip-trunks/remove_number"}]},{"group":"Violations","icon":"ban","root":{"title":"Violations APIs overview","sidebarTitle":"Overview","icon":"book-open","href":"/api-reference/violations/overview"},"expanded":false,"pages":[{"title":"List violations API","sidebarTitle":"List violations","openapi":"GET /violations/list","href":"/api-reference/violations/list"},{"title":"Submit violation API","sidebarTitle":"Submit violation","openapi":"POST /violations/submit","href":"/api-reference/violations/submit"}]}]},{"group":"Workflows","icon":"diagram-project","pages":[{"group":"Workflows","icon":"diagram-project","root":{"title":"Workflow APIs overview","sidebarTitle":"Overview","icon":"book-open","href":"/api-reference/workflows/overview"},"expanded":false,"pages":[{"title":"Create workflow API","sidebarTitle":"Create workflow","openapi":"POST /workflows","href":"/api-reference/workflows/create"},{"title":"List workflows API","sidebarTitle":"List workflows","openapi":"GET /workflows","href":"/api-reference/workflows/list"},{"title":"Get workflow API","sidebarTitle":"Get workflow","openapi":"GET /workflows/{workflow_id}","href":"/api-reference/workflows/get"},{"title":"Update workflow API","sidebarTitle":"Update workflow","openapi":"PATCH /workflows/{workflow_id}","href":"/api-reference/workflows/update"},{"title":"Delete workflow API","sidebarTitle":"Delete workflow","openapi":"DELETE /workflows/{workflow_id}","href":"/api-reference/workflows/delete"},{"title":"Get workflow draft API","sidebarTitle":"Get draft","description":"Read a workflow's stored draft definition and its current revision, the compare-and-set token you pass back when saving the draft.","openapi":"GET /workflows/{workflow_id}/draft","href":"/api-reference/workflows/get-draft"},{"title":"Save workflow draft API","sidebarTitle":"Save draft","openapi":"PUT /workflows/{workflow_id}/draft","href":"/api-reference/workflows/save-draft"},{"title":"Validate workflow API","sidebarTitle":"Validate draft","description":"Check the saved draft against every graph and node rule without mutating anything. Errors block publish; warnings do not.","openapi":"POST /workflows/{workflow_id}/validate","href":"/api-reference/workflows/validate"},{"title":"Publish workflow API","sidebarTitle":"Publish","openapi":"POST /workflows/{workflow_id}/publish","href":"/api-reference/workflows/publish"},{"title":"Get workflow version API","sidebarTitle":"Get published version","openapi":"GET /workflows/{workflow_id}/versions/{version}","href":"/api-reference/workflows/get-version"},{"title":"Run workflow API","sidebarTitle":"Run one contact","openapi":"POST /workflows/{workflow_id}/run","href":"/api-reference/workflows/run"},{"title":"Test workflow webhook API","sidebarTitle":"Test webhook","openapi":"POST /workflows/{workflow_id}/webhook:test","href":"/api-reference/workflow-webhooks/test"},{"title":"Get callback URL API","sidebarTitle":"Get callback URL","openapi":"GET /workflows/{workflow_id}/nodes/{node_id}/callback","href":"/api-reference/workflows/get-callback"},{"title":"Rotate callback URL API","sidebarTitle":"Rotate callback URL","openapi":"POST /workflows/{workflow_id}/nodes/{node_id}/callback:rotate","href":"/api-reference/workflows/rotate-callback"},{"title":"Get last callback API","sidebarTitle":"Get last callback","openapi":"GET /workflows/{workflow_id}/nodes/{node_id}/callback:last","href":"/api-reference/workflows/get-last-callback"},{"title":"Workflow node types API","sidebarTitle":"Node-type catalog","openapi":"GET /workflow-node-types","href":"/api-reference/workflows/node-types"}]},{"group":"Campaigns","icon":"bullhorn","root":{"title":"Workflow campaign APIs overview","sidebarTitle":"Overview","icon":"book-open","href":"/api-reference/workflow-campaigns/overview"},"expanded":false,"pages":[{"title":"Create workflow campaign API","sidebarTitle":"Create campaign","openapi":"POST /workflow-campaigns","href":"/api-reference/workflow-campaigns/create"},{"title":"List workflow campaigns API","sidebarTitle":"List campaigns","openapi":"GET /workflow-campaigns","href":"/api-reference/workflow-campaigns/list"},{"title":"Get workflow campaign API","sidebarTitle":"Get campaign","openapi":"GET /workflow-campaigns/{campaign_id}","href":"/api-reference/workflow-campaigns/get"},{"title":"Upload campaign entries API","sidebarTitle":"Upload entries","openapi":"POST /workflow-campaigns/{campaign_id}/entries","href":"/api-reference/workflow-campaigns/upload-entries"},{"title":"List campaign entries API","sidebarTitle":"List entries","openapi":"GET /workflow-campaigns/{campaign_id}/entries","href":"/api-reference/workflow-campaigns/list-entries"},{"title":"Campaign entries template API","sidebarTitle":"CSV template","openapi":"GET /workflow-campaigns/{campaign_id}/entries/template","href":"/api-reference/workflow-campaigns/entries-template"},{"title":"Start workflow campaign API","sidebarTitle":"Start campaign","openapi":"POST /workflow-campaigns/{campaign_id}:start","href":"/api-reference/workflow-campaigns/start"},{"title":"Pause workflow campaign API","sidebarTitle":"Pause campaign","openapi":"POST /workflow-campaigns/{campaign_id}:pause","href":"/api-reference/workflow-campaigns/pause"},{"title":"Resume workflow campaign API","sidebarTitle":"Resume campaign","openapi":"POST /workflow-campaigns/{campaign_id}:resume","href":"/api-reference/workflow-campaigns/resume"},{"title":"Abort workflow campaign API","sidebarTitle":"Abort campaign","openapi":"POST /workflow-campaigns/{campaign_id}:abort","href":"/api-reference/workflow-campaigns/abort"},{"title":"List campaign executions API","sidebarTitle":"List executions","openapi":"GET /workflow-campaigns/{campaign_id}/executions","href":"/api-reference/workflow-campaigns/list-executions"},{"title":"Workflow campaign report API","sidebarTitle":"Campaign report","openapi":"GET /workflow-campaigns/{campaign_id}/report","href":"/api-reference/workflow-campaigns/report"},{"title":"Workflow campaign A/B tests API","sidebarTitle":"Campaign A/B tests","openapi":"GET /workflow-campaigns/{campaign_id}/ab-tests","href":"/api-reference/workflow-campaigns/ab-tests"},{"title":"Delete workflow campaign API","sidebarTitle":"Delete campaign","openapi":"DELETE /workflow-campaigns/{campaign_id}","href":"/api-reference/workflow-campaigns/delete"}]},{"group":"Executions","icon":"list","root":{"title":"Workflow execution APIs overview","sidebarTitle":"Overview","icon":"book-open","href":"/api-reference/workflow-executions/overview"},"expanded":false,"pages":[{"title":"Get workflow execution API","sidebarTitle":"Get execution","openapi":"GET /workflow-executions/{execution_id}","href":"/api-reference/workflow-executions/get"},{"title":"Cancel workflow execution API","sidebarTitle":"Cancel execution","openapi":"POST /workflow-executions/{execution_id}:cancel","href":"/api-reference/workflow-executions/cancel"},{"title":"Resend execution webhook API","sidebarTitle":"Resend webhook","openapi":"POST /workflow-executions/{execution_id}/webhook:resend","href":"/api-reference/workflow-webhooks/resend"}]}]},{"group":"Account","icon":"user-gear","pages":[{"group":"User","icon":"user","root":{"title":"User APIs overview","sidebarTitle":"User APIs overview","icon":"book-open","href":"/api-reference/user/overview"},"expanded":false,"pages":[{"title":"User information","sidebarTitle":"Get user details","openapi":"GET /user/me","href":"/api-reference/user/info"},{"title":"Add a new custom LLM model","sidebarTitle":"Add a custom model","openapi":"POST /user/model/custom","href":"/api-reference/user/add_model"},{"title":"List your custom LLM models","sidebarTitle":"List custom models","openapi":"GET /user/model/custom","href":"/api-reference/user/list_custom_models"},{"title":"Delete a custom LLM model","sidebarTitle":"Delete custom model","openapi":"DELETE /user/model/custom/{model_id}","href":"/api-reference/user/delete_model"},{"title":"Add a custom TTS voice","sidebarTitle":"Add a custom TTS","openapi":"POST /user/tts/custom","href":"/api-reference/user/add_custom_tts"},{"title":"List your custom TTS voices","sidebarTitle":"List custom TTS","openapi":"GET /user/tts/custom","href":"/api-reference/user/list_custom_tts"},{"title":"Delete a custom TTS voice","sidebarTitle":"Delete custom TTS","openapi":"DELETE /user/tts/custom/{custom_tts_id}","href":"/api-reference/user/delete_custom_tts"}]},{"group":"Providers","icon":"plug","root":{"title":"Providers APIs overview","sidebarTitle":"Overview","icon":"book-open","href":"/api-reference/providers/overview"},"expanded":false,"pages":[{"title":"Add a new provider API","sidebarTitle":"Add a new provider","openapi":"POST /providers","href":"/api-reference/providers/add"},{"title":"List providers API ","sidebarTitle":"List providers","openapi":"GET /providers","href":"/api-reference/providers/get"},{"title":"Remove a provider API","sidebarTitle":"Remove a provider","openapi":"DELETE /providers/{provider_key_name}","href":"/api-reference/providers/remove"}]},{"group":"Sub-accounts","icon":"sitemap","root":{"title":"Sub accounts APIs overview","sidebarTitle":"Overview","icon":"book-open","href":"/api-reference/sub-accounts/overview"},"expanded":false,"pages":[{"title":"Create a new sub-account API","sidebarTitle":"Create sub-account","openapi":"POST /sub-accounts/create","href":"/api-reference/sub-accounts/create"},{"title":"List all sub-accounts API","sidebarTitle":"List sub-accounts","openapi":"GET /sub-accounts/all","href":"/api-reference/sub-accounts/get_all"},{"title":"Patch update a sub-account","sidebarTitle":"Patch sub-account","openapi":"PATCH /sub-accounts/{sub_account_id}","href":"/api-reference/sub-accounts/patch_update"},{"title":"Track sub-account usage API","sidebarTitle":"Sub-account usage","openapi":"GET /sub-accounts/{sub_account_id}/usage","href":"/api-reference/sub-accounts/usage"},{"title":"Get all sub-accounts usage API","sidebarTitle":"All sub-account usage","openapi":"GET /sub-accounts/all/usage","href":"/api-reference/sub-accounts/all_usage"},{"title":"Deleting a sub-account","sidebarTitle":"Delete sub-account","openapi":"DELETE /sub-accounts/{sub_account_id}","href":"/api-reference/sub-accounts/delete"}]}]},{"group":"Legacy","icon":"box-archive","pages":[{"group":"Agent v1","icon":"box-archive","root":{"title":"Bolna voice AI agent APIs overview (deprecated)","sidebarTitle":"Overview","icon":"book-open","href":"/api-reference/agent/overview"},"expanded":false,"pages":[{"title":"Create voice AI agent API (deprecated)","sidebarTitle":"Create agent","openapi":"POST /agent","href":"/api-reference/agent/create"},{"title":"Retrieve voice AI agent details API (deprecated)","sidebarTitle":"Get agent","openapi":"GET /agent/{agent_id}","href":"/api-reference/agent/get"},{"title":"Update voice AI agent API (deprecated)","sidebarTitle":"Update agent","openapi":"PUT /agent/{agent_id}","href":"/api-reference/agent/update"},{"title":"Patch update to voice AI agent API (deprecated)","sidebarTitle":"Patch update agent","openapi":"PATCH /agent/{agent_id}","href":"/api-reference/agent/patch_update"},{"title":"List all voice AI agents API (deprecated)","sidebarTitle":"List agents","openapi":"GET /agent/all","href":"/api-reference/agent/get_all"},{"title":"Get all agent executions API (v1, deprecated)","sidebarTitle":"Get all executions","openapi":"GET /agent/{agent_id}/executions","href":"/api-reference/agent/get_all_agent_executions"}]}]}]},{"tab":"Developers","icon":"toolbox","pages":[{"title":"Developers","href":"/developer-resources/overview"}]},{"tab":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/changelog/november-2026"}]}]},"basePath":"","title":"Save workflow draft API - Bolna Docs","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-Ku9dSkH0.js","snippetPresets-Cjez4eet.js","utils-BqNa-fnS.js","style-to-object-BY3JEAdk.js","utils-DiE92JCe.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-Bi0DpqVf.js","conditional-requirements-CFM0id0Q.js","cloneDeep-C6xnxscF.js","_Uint8Array-B7g0OYAt.js","isObject-FP1Yky1u.js","Page--B9YZ09u.js","CodeSnippet-CTZvgJfu.js","DynamicMarkdown-CsgNpZb1.js","SectionHeading-C3K437Dy.js","icon-DlxjjqnB.js","ApiExamples-Bf8Ecb5t.js","usePlaygroundInputsStore-BA942cq6.js","shallow-D0sePNkF.js","isEqual-CnnQO8sL.js","CodeSnippets-BTANoy1T.js","getApiPlaygroundDisplay-BK2o1XYu.js","MethodPill-Cr7Ib9nN.js","getPastedJson-DXo3wtHt.js","Check2Icon-ChEI-f_B.js","axios-CsQoIw0U.js","Markdown-CH4mv0N8.js","AssistantPageLink-BHjmqccN.js","dist-DYCPzQwJ.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}