{ "message": "Agent version deleted successfully"}
Deletes a version and every save under its name. It’s no longer listed, readable or callable, and its name becomes free to use again.Executions that ran on the version keep their transcripts, recordings and data.
Delete returns 409 while the version can’t be deleted yet:
It’s live.Make another version live first, then delete it. Message: The live version can't be deleted. Make another version live first.
It’s in the split of an A/B batch that hasn’t finished. Stop the batch or let it finish first. Message: This version is in an A/B test on a batch that hasn't finished. Stop or finish that batch first.
A workflow call that has been accepted but hasn’t connected yet is waiting on a save of it, for example one held until calling hours. Take the version out of the workflow’s A/B test and let those calls connect first. Message: This version has workflow calls waiting to be placed. Take it out of the workflow and let those calls connect first.
Authorizations
Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
{ "message": "Agent version deleted successfully"}
{"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.4248","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/agent/v2/versions/delete","slug":"/api-reference/agent/v2/versions/delete","pageMetadata":{"title":"Delete agent version API","sidebarTitle":"Delete version","description":"Delete a Bolna voice agent version that isn't live. Past calls on it keep their data.","openapi":"DELETE /v2/agent/{agent_id}/versions/{agent_version_id}","last_reviewed":"2026-11-14","href":"/api-reference/agent/v2/versions/delete"},"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: \"Delete a Bolna voice agent version that isn’t live. Past calls on it keep their data.\"\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`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Warning}=_components;if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Deletes a version and every save under its name. It’s no longer listed, readable or callable, and its name becomes free to use again.`}),`\n`,_jsx(_components.p,{children:`Executions that ran on the version keep their transcripts, recordings and data.`}),`\n`,_jsxs(Warning,{children:[_jsxs(_components.p,{children:[`Delete returns `,_jsx(_components.code,{children:`409`}),` while the version can’t be deleted yet:`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`It’s live.`}),` `,_jsx(_components.a,{href:`/api-reference/agent/v2/versions/set_current`,children:`Make another version live`}),` first, then delete it. Message: `,_jsx(_components.code,{children:`The live version can't be deleted. Make another version live first.`})]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`It’s in the split of an `,_jsx(_components.a,{href:`/agents/ab-testing#split-a-batch`,children:`A/B batch`}),` that hasn’t finished.`]}),` Stop the batch or let it finish first. Message: `,_jsx(_components.code,{children:`This version is in an A/B test on a batch that hasn't finished. Stop or finish that batch first.`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A workflow call that has been accepted but hasn’t connected yet is waiting on a save of it`}),`, for example one held until calling hours. Take the version out of the workflow’s `,_jsx(_components.a,{href:`/workflows/ab-testing#deleting-a-version-in-a-test`,children:`A/B test`}),` and let those calls connect first. Message: `,_jsx(_components.code,{children:`This version has workflow calls waiting to be placed. Take it out of the workflow and let those calls connect first.`})]}),`\n`]})]})]})}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":"Delete agent version API","sidebarTitle":"Delete version","description":"Delete a Bolna voice agent version that isn't live. Past calls on it keep their data.","openapi":"DELETE /v2/agent/{agent_id}/versions/{agent_version_id}","last_reviewed":"2026-11-14","href":"/api-reference/agent/v2/versions/delete"}}},"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":"Delete a Bolna voice agent version that isn't live. Past calls on it keep their data.","parameters":["932426d1-eb5d-4595-9b0d-a85918a2bb74","a5ca1c81-364e-475a-b0a1-9513bc25be9a"],"responses":{"200":"38c3499f-a03f-4b62-8ff0-f684c15d3570","404":"07c8a3f0-5fea-4107-b125-dfeb43708385","409":"583bac92-ce13-473a-9803-a914aedf94e4"},"method":"delete","type":"path","servers":["29c81783-4641-4f42-ad5d-aa453caf6131"],"security":["0c29262b-7203-4b55-9118-4f345a51c1d5"],"path":"/v2/agent/{agent_id}/versions/{agent_version_id}","baseUrlOptions":["https://api.bolna.ai"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"932426d1-eb5d-4595-9b0d-a85918a2bb74":{"in":"path","name":"agent_id","required":true,"description":"The agent's `id`","schema":{"type":"string","format":"uuid","isRequired":true,"description":"The agent's `id`","uniqueKey":"","typeLabel":"string\u003cuuid>"}},"a5ca1c81-364e-475a-b0a1-9513bc25be9a":{"in":"path","name":"agent_version_id","required":true,"description":"The version's `id`, from [List agent versions](/api-reference/agent/v2/versions/list)","schema":{"type":"string","format":"uuid","isRequired":true,"description":"The version's `id`, from [List agent versions](/api-reference/agent/v2/versions/list)","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"38c3499f-a03f-4b62-8ff0-f684c15d3570":{"description":"Version deleted","content":{"application/json":{"example":{"message":"Agent version deleted successfully"},"examples":{"Example":{"title":"Example","value":{"message":"Agent version deleted successfully"}}},"exampleType":"examples"}},"exampleType":"examples"},"07c8a3f0-5fea-4107-b125-dfeb43708385":{"description":"Agent or version not found","content":{"application/json":{"example":{"message":"Agent version not found"},"examples":{"Example":{"title":"Example","value":{"message":"Agent version not found"}}},"exampleType":"examples"}},"exampleType":"examples"},"583bac92-ce13-473a-9803-a914aedf94e4":{"description":"The version is live, is in the A/B split of a batch that hasn't finished, or has workflow calls waiting to connect","content":{"application/json":{"examples":{"live":{"title":"live","summary":"The version is live","value":{"message":"The live version can't be deleted. Make another version live first."}},"batch":{"title":"batch","summary":"The version is in an unfinished A/B batch","value":{"message":"This version is in an A/B test on a batch that hasn't finished. Stop or finish that batch first."}},"workflow":{"title":"workflow","summary":"Workflow calls are waiting on the version","value":{"message":"This version has workflow calls waiting to be placed. Take it out of the workflow and let those calls connect first."}}},"exampleType":"examples"}},"exampleType":"examples"}},"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":"Delete agent version API - Bolna Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T08:13:17.804Z","originalFileLocation":"api-reference/agent/v2/versions/delete.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=\"Delete a Bolna voice agent version that isn\u0026#x27;t live. Past calls on it keep their data.\">\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=\"Delete agent version API - Bolna Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Delete a Bolna voice agent version that isn\u0026#x27;t live. Past calls on it keep their data.\">\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/agent/v2/versions/delete\">\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=Agent+versions\u0026amp;title=Delete+agent+version+API\u0026amp;description=Delete+a+Bolna+voice+agent+version+that+isn%27t+live.+Past+calls+on+it+keep+their+data.\u0026amp;theme=f2dcce2f7fc3b944c1c433e4\u0026amp;signature=9014f68b3fa6df2186a3171a79e89333c87d140ea834dbff7635cf943937a50f\">\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=\"Delete agent version API - Bolna Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Delete a Bolna voice agent version that isn\u0026#x27;t live. Past calls on it keep their data.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bolna-54a2d4fe.mintlify.site/docs/_mintlify/api/og/v2?division=Agent+versions\u0026amp;title=Delete+agent+version+API\u0026amp;description=Delete+a+Bolna+voice+agent+version+that+isn%27t+live.+Past+calls+on+it+keep+their+data.\u0026amp;theme=f2dcce2f7fc3b944c1c433e4\u0026amp;signature=9014f68b3fa6df2186a3171a79e89333c87d140ea834dbff7635cf943937a50f\">\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/agent/v2/versions/delete\">\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/agent/v2/versions/delete.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/agent/v2/versions/delete#webpage\",\"url\":\"https://www.bolna.ai/docs/api-reference/agent/v2/versions/delete\",\"name\":\"Delete agent version API\",\"description\":\"Delete a Bolna voice agent version that isn't live. Past calls on it keep their data.\",\"dateModified\":\"2026-11-16T08:13:17.804Z\",\"isPartOf\":{\"@id\":\"https://www.bolna.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.bolna.ai/docs/api-reference/agent/v2/versions/delete#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.bolna.ai/docs/api-reference/agent/v2/versions/delete#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Voice agents\",\"item\":\"https://www.bolna.ai/docs/api-reference/agent/v2/get\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agent versions\",\"item\":\"https://www.bolna.ai/docs/api-reference/agent/v2/versions/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Delete agent version API\",\"item\":\"https://www.bolna.ai/docs/api-reference/agent/v2/versions/delete\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.bolna.ai/docs/api-reference/agent/v2/versions/delete#apireference\",\"headline\":\"Delete agent version API\",\"name\":\"Delete agent version API\",\"description\":\"Delete a Bolna voice agent version that isn't live. Past calls on it keep their data.\",\"url\":\"https://www.bolna.ai/docs/api-reference/agent/v2/versions/delete\",\"mainEntityOfPage\":{\"@id\":\"https://www.bolna.ai/docs/api-reference/agent/v2/versions/delete#webpage\"},\"dateModified\":\"2026-11-16T08:13:17.804Z\",\"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/agent/v2/versions/delete.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","description":"Make a Bolna voice agent version live, so every new call uses it, or roll back to an earlier version.","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","description":"Create, schedule, stop and track batches of Bolna voice AI calls with the Batch APIs, or upload a CSV under Deploy → Batches in the dashboard.","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","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","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":"Delete agent version API - Bolna Docs","deploymentId":"dpl_C8nwD4Qo785i7PBDK32YZuKGR9Lm","buildId":"dpl_C8nwD4Qo785i7PBDK32YZuKGR9Lm","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-BHpAblIa.js","snippetPresets-C-QjF0k_.js","utils-Dz5URj_u.js","style-to-object-BY3JEAdk.js","utils-Da_yhPn5.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CIIxiDBb.js","conditional-requirements-CFM0id0Q.js","cloneDeep-k_8athT8.js","_Uint8Array-3TACpfVy.js","isObject-FP1Yky1u.js","Page-Dq2tE-AS.js","CodeSnippet-DzxI2vN3.js","DynamicMarkdown-3piqoEk_.js","SectionHeading-BfyA8rV0.js","icon-Dz7YG_yb.js","ApiExamples-BwENSgQX.js","usePlaygroundInputsStore-Bwm_Juam.js","shallow-DiWjILlR.js","isEqual-D8db76Nf.js","CodeSnippets-DkFc-r7T.js","getApiPlaygroundDisplay-Co0Ej2uF.js","MethodPill-D7hco0-Q.js","getPastedJson-DYtIXN3i.js","DuplicateIcon-CWgJhuEu.js","axios-CsQoIw0U.js","Markdown-Bj6sjipA.js","AssistantPageLink-vuoZnuCk.js","dist-Bb1ZYRob.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}