{ "message": "release cancelled, number restored to active status", "status": "active", "currency": "INR", "refund_amount": 700}
Cancels a pending number release during the 24-hour cooldown and restores the number to active.
Cancelling a pending release refunds the full release fee to your account balance. The response reports the refund in refund_amount and currency.
POST https://api.vobiz.ai/api/v1/account/{account_id}/numbers/{e164}/cancel-release
You can cancel only while the number is in pending_release. After the 24-hour cooldown ends, this endpoint returns 400 and recovery requires manual intervention.
Authentication
The API playground uses the same authentication fields as the other Vobiz API pages:
X-Auth-ID - Your account Auth ID.
X-Auth-Token - Your account Auth Token.
The endpoint also accepts HTTP Basic authentication in direct requests. Use your Auth ID as the username and your Auth Token as the password, as shown in the cURL example below.
Do not send the Auth Token as Authorization: Bearer {auth_token}. Bearer authentication is for JWT access tokens and returns 401 Invalid token when used with an account Auth Token.
Path parameters
Parameter
Required
Description
account_id
Yes
Your account Auth ID, such as MA_XXXXXX.
e164
Yes
The phone number in E.164 format. URL-encode + as %2B, such as %2B919876543210.
Request
curl -X POST \ "https://api.vobiz.ai/api/v1/account/{account_id}/numbers/%2B919876543210/cancel-release" \ -u "{account_id}:{auth_token}"
The release was cancelled and the number was restored to active. The response includes the refunded amount and currency.
400
The number is not in pending_release, so there is nothing to cancel.
401
Authentication failed. Verify the authentication method and credentials.
403
The number does not belong to this account.
404
The number was not found.
Release cancelled and refunded
Response - 200 OK
{ "currency": "INR", "message": "release cancelled, number restored to active status", "refund_amount": 700, "status": "active"}
Number restored but refund failed
The number is active even when the refund fails. Contact Vobiz Support with the number and account details.
Response - 200 OK
{ "message": "release cancelled, number restored to active status", "status": "active", "refund_status": "failed", "refund_error": "could not process refund, please contact support"}
{ "message": "release cancelled, number restored to active status", "status": "active", "currency": "INR", "refund_amount": 700}
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Vobiz","colors":{"primary":"#E83C00","light":"#E86A00","dark":"#c93400"},"logo":{"light":"https://mintcdn.com/vobizai/cPP2drhQ7lKsmogc/logo/light.svg?fit=max\u0026auto=format\u0026n=cPP2drhQ7lKsmogc\u0026q=85\u0026s=8e1f6273f626f638f46d6df526d4775c","dark":"https://mintcdn.com/vobizai/cPP2drhQ7lKsmogc/logo/dark.svg?fit=max\u0026auto=format\u0026n=cPP2drhQ7lKsmogc\u0026q=85\u0026s=57b37e5694f01e6933c9ec02a871250a","href":"https://www.vobiz.ai/docs/introduction"},"favicon":"https://mintcdn.com/vobizai/BDRzOqCvIsC8CJvN/favicon.svg?fit=max\u0026auto=format\u0026n=BDRzOqCvIsC8CJvN\u0026q=85\u0026s=b38182f12bc6b0e3a5df2a8ae1474f83","api":{"openapi":["openapi.yaml","openapi-sms.yaml","openapi-whatsapp.yaml"],"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript"],"prefill":true},"mdx":{"auth":{"method":"key","name":"X-Auth-Token"},"server":"https://api.vobiz.ai"}},"appearance":{"default":"dark"},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"mailto:support@vobiz.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://console.vobiz.ai"}},"footer":{"socials":{"x":"https://x.com/Vobiz_Ai","github":"https://github.com/vobiz-ai","linkedin":"https://linkedin.com/company/vobizai"}},"seo":{"metatags":{"canonical":"https://www.vobiz.ai/docs","og:site_name":"Vobiz Docs","og:type":"website","og:locale":"en_US","twitter:card":"summary_large_image","twitter:site":"@Vobiz_Ai","twitter:creator":"@Vobiz_Ai","theme-color":"#E83C00","color-scheme":"dark light","author":"Vobiz","publisher":"Vobiz","copyright":"Copyright 2025 Vobiz","reply-to":"support@vobiz.ai","robots":"index, follow","format-detection":"telephone=no","referrer":"origin-when-cross-origin","rating":"general","language":"en","category":"Technology","coverage":"Worldwide","distribution":"global","target":"all"},"indexing":"all"},"integrations":{"ga4":{"measurementId":"G-YD6M3FF3P4"}},"contextual":{"options":["copy","view","assistant","chatgpt","claude","perplexity","mcp","add-mcp","cursor","vscode"],"display":"header"},"thumbnails":{"appearance":"dark"},"markdown":{"schema":true},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"API Status","icon":"signal","href":"https://status.vobiz.ai"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"vobizai","hasAudioNarration":false,"actualSubdomain":"vobizai","customDomains":["www.vobiz.ai"],"gitSource":{"type":"github","owner":"vobiz-ai","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6ae8948acb9fa025302af88e"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6b032c1a76d46e4caec39fa0","clientVersion":"0.0.4271","searchFilterCounts":[{"language":"default","tag":"API Reference","count":443},{"language":"default","tag":"Voice \u0026 XML","count":142},{"language":"default","tag":"Documentation","count":103},{"language":"default","tag":"SMS \u0026 RCS","count":102},{"language":"default","tag":"Integrations","count":83},{"language":"default","tag":"Blogs","count":82},{"language":"default","tag":"Articles","count":80},{"language":"default","tag":"Examples \u0026 Tutorials","count":60},{"language":"default","tag":"Regular APIs","count":45},{"language":"default","tag":"SIP Trunking","count":36}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@vobiz.ai","showHelpButton":true}},"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":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"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":false},"customCss":[{"filePath":"custom.css","href":"/docs/_mintlify/custom/vobizai/c4c76a1b5bc930af/custom.css"}]}
{"page":{"pagePath":"account-phone-number/cancel-release","slug":"/account-phone-number/cancel-release","pageMetadata":{"openapi":"POST /api/v1/account/{account_id}/numbers/{e164}/cancel-release","title":"Cancel a Number Release","sidebarTitle":"Cancel Release","description":"Cancel a pending phone number release during the 24-hour cooldown and restore the number to active.","keywords":["cancel number release","pending release","restore phone number","release cooldown","refund release fee","Vobiz number API"],"href":"/account-phone-number/cancel-release"},"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: \"Cancel a pending phone number release during the 24-hour cooldown and restore the number to active.\"\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`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Info,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Cancels a pending number release during the 24-hour cooldown and restores the number to `,_jsx(_components.code,{children:`active`}),`.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Cancelling a pending release refunds the full release fee to your account balance. The response reports the refund in `,_jsx(_components.code,{children:`refund_amount`}),` and `,_jsx(_components.code,{children:`currency`}),`.`]})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`POST`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` https://api.vobiz.ai/api/v1/account/{account_id}/numbers/{e164}/cancel-release`})]}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`You can cancel only while the number is in `,_jsx(_components.code,{children:`pending_release`}),`. After the 24-hour cooldown ends, this endpoint returns `,_jsx(_components.code,{children:`400`}),` and recovery requires manual intervention.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`authentication`,children:`Authentication`}),`\n`,_jsx(_components.p,{children:`The API playground uses the same authentication fields as the other Vobiz API pages:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`X-Auth-ID`}),` - Your account Auth ID.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`X-Auth-Token`}),` - Your account Auth Token.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`The endpoint also accepts HTTP Basic authentication in direct requests. Use your Auth ID as the username and your Auth Token as the password, as shown in the cURL example below.`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Do not send the Auth Token as `,_jsx(_components.code,{children:`Authorization: Bearer {auth_token}`}),`. Bearer authentication is for JWT access tokens and returns `,_jsx(_components.code,{children:`401 Invalid token`}),` when used with an account Auth Token.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`path-parameters`,children:`Path parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`account_id`})}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`Your account Auth ID, such as `,_jsx(_components.code,{children:`MA_XXXXXX`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`e164`})}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`The phone number in E.164 format. URL-encode `,_jsx(_components.code,{children:`+`}),` as `,_jsx(_components.code,{children:`%2B`}),`, such as `,_jsx(_components.code,{children:`%2B919876543210`}),`.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`request`,children:`Request`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Basic authentication`,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.vobiz.ai/api/v1/account/{account_id}/numbers/%2B919876543210/cancel-release\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -u`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"{account_id}:{auth_token}\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`X-Auth headers`,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.vobiz.ai/api/v1/account/{account_id}/numbers/%2B919876543210/cancel-release\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Auth-ID: {account_id}\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Auth-Token: {auth_token}\"`})]}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`behavior`,children:`Behavior`}),`\n`,_jsxs(_components.p,{children:[`When the number belongs to your account and is still in `,_jsx(_components.code,{children:`pending_release`}),`, Vobiz:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Verifies that your account owns the number.`}),`\n`,_jsxs(_components.li,{children:[`Changes its status from `,_jsx(_components.code,{children:`pending_release`}),` to `,_jsx(_components.code,{children:`active`}),` and clears the cooldown timer.`]}),`\n`,_jsx(_components.li,{children:`Refunds the release fee to your account balance.`}),`\n`,_jsxs(_components.li,{children:[`Returns `,_jsx(_components.code,{children:`200 OK`}),`.`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The original release already detached the trunk and voice application. Cancellation does not re-attach them. `,_jsx(_components.a,{href:`/trunks/assign-number`,children:`Assign the number to a trunk`}),` or `,_jsx(_components.a,{href:`/applications/attach-number`,children:`attach it to an application`}),` before routing calls again.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`responses`,children:`Responses`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`200`})}),_jsxs(_components.td,{children:[`The release was cancelled and the number was restored to `,_jsx(_components.code,{children:`active`}),`. The response includes the refunded amount and currency.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsxs(_components.td,{children:[`The number is not in `,_jsx(_components.code,{children:`pending_release`}),`, so there is nothing to cancel.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:`Authentication failed. Verify the authentication method and credentials.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsx(_components.td,{children:`The number does not belong to this account.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:`The number was not found.`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`release-cancelled-and-refunded`,children:`Release cancelled and refunded`}),`\n`,_jsx(CodeBlock,{filename:`Response - 200 OK`,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"INR\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"release cancelled, number restored to active status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"refund_amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`700`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"active\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`number-restored-but-refund-failed`,children:`Number restored but refund failed`}),`\n`,_jsxs(_components.p,{children:[`The number is active even when the refund fails. Contact `,_jsx(_components.a,{href:`https://www.vobiz.ai/contact-us/`,children:`Vobiz Support`}),` with the number and account details.`]}),`\n`,_jsx(CodeBlock,{filename:`Response - 200 OK`,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"release cancelled, number restored to active status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"active\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"refund_status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"failed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"refund_error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"could not process refund, please contact support\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`error-examples`,children:`Error examples`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`400 Not Pending Release`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"number is not pending release\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`401 Invalid Token`,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`401`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Invalid token\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`403 Access Denied`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"access denied\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`404 Number Not Found`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"number not found\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\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":{"config":{},"pageMetadata":{"openapi":"POST /api/v1/account/{account_id}/numbers/{e164}/cancel-release","title":"Cancel a Number Release","sidebarTitle":"Cancel Release","description":"Cancel a pending phone number release during the 24-hour cooldown and restore the number to active.","keywords":["cancel number release","pending release","restore phone number","release cooldown","refund release fee","Vobiz number API"],"href":"/account-phone-number/cancel-release"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Authentication","slug":"authentication","depth":2,"children":[]},{"title":"Path parameters","slug":"path-parameters","depth":2,"children":[]},{"title":"Request","slug":"request","depth":2,"children":[]},{"title":"Behavior","slug":"behavior","depth":2,"children":[]},{"title":"Responses","slug":"responses","depth":2,"children":[{"title":"Release cancelled and refunded","slug":"release-cancelled-and-refunded","depth":3,"children":[]},{"title":"Number restored but refund failed","slug":"number-restored-but-refund-failed","depth":3,"children":[]},{"title":"Error examples","slug":"error-examples","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/vobizai/478834ae2c200a0e/blog-schema.js","/docs/_mintlify/custom/vobizai/13b0cd7ec6e39877/anchor-link-text.js"],"openApiReferenceData":{"operation":{"operationId":"cancel-number-release","summary":"Cancel a number release","description":"Cancel a pending phone number release during the 24-hour cooldown and restore the number to active.","tags":["Phone Numbers"],"security":["44756a60-9bb9-4349-91a6-2f5594d56dd2"],"parameters":["ac1bf0e8-4f48-4f8f-9016-436b7dd69ac4","999fd27d-abf0-44b4-83bd-50054acf59c3"],"responses":{"200":"3f1adfee-e320-4058-9eaa-09dd9aa02d1f","400":"f66a8c8c-1d85-492f-a13e-c615dd98a88a","401":"afe29ced-9ccf-48a2-b975-4941bf6b2cc6","403":"85654407-9429-4fdb-ab82-81ff358ebbe6","404":"59a4ce02-b37c-463b-a6f1-f12b7bc345a9"},"method":"post","type":"path","servers":["63df1293-34a2-4314-96e6-4cfcad0f4404"],"path":"/api/v1/account/{account_id}/numbers/{e164}/cancel-release","baseUrlOptions":["https://api.vobiz.ai"],"title":"Cancel a number release","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[]},"dependencies":{"parameters":{"ac1bf0e8-4f48-4f8f-9016-436b7dd69ac4":{"name":"account_id","in":"path","required":true,"description":"Your account Auth ID.","schema":{"type":"string","example":"MA_XXXXXX","isRequired":true,"description":"Your account Auth ID.","uniqueKey":"","typeLabel":"string"}},"999fd27d-abf0-44b4-83bd-50054acf59c3":{"name":"e164","in":"path","required":true,"description":"The URL-encoded phone number in E.164 format. Encode `+` as `%2B`.","schema":{"type":"string","example":"%2B919876543210","isRequired":true,"description":"The URL-encoded phone number in E.164 format. Encode `+` as `%2B`.","uniqueKey":"","typeLabel":"string"}}},"responses":{"3f1adfee-e320-4058-9eaa-09dd9aa02d1f":{"description":"Release cancelled and number restored to active","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status":{"type":"string","enum":["active"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"currency":{"type":"string","uniqueKey":"currency","typeLabel":"string"},"refund_amount":{"type":"number","uniqueKey":"refund_amount","typeLabel":"number"},"refund_status":{"type":"string","enum":["success","failed"],"uniqueKey":"refund_status","typeLabel":"enum\u003cstring>"},"refund_error":{"type":"string","description":"Present when the refund could not be processed.","uniqueKey":"refund_error","typeLabel":"string"}},"required":["message","status"],"uniqueKey":"","typeLabel":"object"},"examples":{"refunded":{"title":"refunded","summary":"Number restored and fee refunded","value":{"message":"release cancelled, number restored to active status","status":"active","currency":"INR","refund_amount":700}},"refundFailed":{"title":"refundFailed","summary":"Number restored but refund failed","value":{"message":"release cancelled, number restored to active status","status":"active","refund_status":"failed","refund_error":"could not process refund, please contact support"}}},"exampleType":"examples"}},"exampleType":"examples"},"f66a8c8c-1d85-492f-a13e-c615dd98a88a":{"description":"The number is not pending release","content":{"application/json":{"example":{"error":"number is not pending release"},"examples":{"Example":{"title":"Example","value":{"error":"number is not pending release"}}},"exampleType":"examples"}},"exampleType":"examples"},"afe29ced-9ccf-48a2-b975-4941bf6b2cc6":{"description":"Authentication failed","content":{"application/json":{"example":{"error":{"code":401,"message":"Invalid token"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":401,"message":"Invalid token"}}}},"exampleType":"examples"}},"exampleType":"examples"},"85654407-9429-4fdb-ab82-81ff358ebbe6":{"description":"The number does not belong to this account","content":{"application/json":{"example":{"error":"access denied"},"examples":{"Example":{"title":"Example","value":{"error":"access denied"}}},"exampleType":"examples"}},"exampleType":"examples"},"59a4ce02-b37c-463b-a6f1-f12b7bc345a9":{"description":"Number not found","content":{"application/json":{"example":{"error":"number not found"},"examples":{"Example":{"title":"Example","value":{"error":"number not found"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"44756a60-9bb9-4349-91a6-2f5594d56dd2":{"AuthID":{"type":"apiKey","in":"header","name":"X-Auth-ID","description":"Your Vobiz account Auth ID","scopes":[],"schemeName":"AuthID"},"AuthToken":{"type":"apiKey","in":"header","name":"X-Auth-Token","description":"Your Vobiz account Auth Token","scopes":[],"schemeName":"AuthToken"}}},"servers":{"63df1293-34a2-4314-96e6-4cfcad0f4404":{"url":"https://api.vobiz.ai","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Auth-ID","description":"Your Vobiz account Auth ID","scopes":[],"schemeName":"AuthID"},"schema":{"title":"X-Auth-ID","type":"string","description":"Your Vobiz account Auth ID","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"AuthID","name":"X-Auth-ID"},{"scheme":{"type":"apiKey","in":"header","name":"X-Auth-Token","description":"Your Vobiz account Auth Token","scopes":[],"schemeName":"AuthToken"},"schema":{"title":"X-Auth-Token","type":"string","description":"Your Vobiz account Auth Token","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"AuthToken","name":"X-Auth-Token"}],"title":"AuthID \u0026 AuthToken"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"vobizai","siteName":"Vobiz","title":"Cancel a Number Release - Vobiz","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T20:13:57.298Z","originalFileLocation":"account-phone-number/cancel-release.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=\"dark\"}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=\"Cancel a pending phone number release during the 24-hour cooldown and restore the number to active.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Vobiz\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_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/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/vobizai/oc0LWA8xGPKGY1Z5/_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/vobizai/oc0LWA8xGPKGY1Z5/_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/vobizai/oc0LWA8xGPKGY1Z5/_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/vobizai/oc0LWA8xGPKGY1Z5/_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/vobizai/oc0LWA8xGPKGY1Z5/_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/vobizai/oc0LWA8xGPKGY1Z5/_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/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Cancel a Number Release - Vobiz\">\u003cmeta data-mint-head property=\"og:description\" content=\"Cancel a pending phone number release during the 24-hour cooldown and restore the number to active.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Vobiz Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.vobiz.ai/docs/account-phone-number/cancel-release\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://vobizai.mintlify.site/docs/_mintlify/api/og/v2?division=Phone+Numbers\u0026amp;title=Cancel+a+Number+Release\u0026amp;description=Cancel+a+pending+phone+number+release+during+the+24-hour+cooldown+and+restore+the+number+to+active.\u0026amp;theme=d9cfb5a257c4db351c1c1eeb\u0026amp;signature=9bda64e26a71b06168d101a9625126663e961d5d92d7c505478a05cd6d977341\">\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=\"Cancel a Number Release - Vobiz\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Cancel a pending phone number release during the 24-hour cooldown and restore the number to active.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://vobizai.mintlify.site/docs/_mintlify/api/og/v2?division=Phone+Numbers\u0026amp;title=Cancel+a+Number+Release\u0026amp;description=Cancel+a+pending+phone+number+release+during+the+24-hour+cooldown+and+restore+the+number+to+active.\u0026amp;theme=d9cfb5a257c4db351c1c1eeb\u0026amp;signature=9bda64e26a71b06168d101a9625126663e961d5d92d7c505478a05cd6d977341\">\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/vobizai/oc0LWA8xGPKGY1Z5/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Vobiz\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#E83C00\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"twitter:creator\" content=\"@Vobiz_Ai\">\u003cmeta data-mint-head name=\"theme-color\" content=\"#E83C00\">\u003cmeta data-mint-head name=\"color-scheme\" content=\"dark light\">\u003cmeta data-mint-head name=\"author\" content=\"Vobiz\">\u003cmeta data-mint-head name=\"publisher\" content=\"Vobiz\">\u003cmeta data-mint-head name=\"copyright\" content=\"Copyright 2025 Vobiz\">\u003cmeta data-mint-head name=\"reply-to\" content=\"support@vobiz.ai\">\u003cmeta data-mint-head name=\"format-detection\" content=\"telephone=no\">\u003cmeta data-mint-head name=\"referrer\" content=\"origin-when-cross-origin\">\u003cmeta data-mint-head name=\"rating\" content=\"general\">\u003cmeta data-mint-head name=\"language\" content=\"en\">\u003cmeta data-mint-head name=\"category\" content=\"Technology\">\u003cmeta data-mint-head name=\"coverage\" content=\"Worldwide\">\u003cmeta data-mint-head name=\"distribution\" content=\"global\">\u003cmeta data-mint-head name=\"target\" content=\"all\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.vobiz.ai/docs/account-phone-number/cancel-release\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/account-phone-number/cancel-release.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.vobiz.ai/#organization\",\"name\":\"Vobiz\",\"url\":\"https://www.vobiz.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/vobizai/cPP2drhQ7lKsmogc/logo/light.svg?fit=max\u0026auto=format\u0026n=cPP2drhQ7lKsmogc\u0026q=85\u0026s=8e1f6273f626f638f46d6df526d4775c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.vobiz.ai/docs#website\",\"name\":\"Vobiz\",\"url\":\"https://www.vobiz.ai/docs\",\"publisher\":{\"@id\":\"https://www.vobiz.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.vobiz.ai/docs/account-phone-number/cancel-release#webpage\",\"url\":\"https://www.vobiz.ai/docs/account-phone-number/cancel-release\",\"name\":\"Cancel a Number Release\",\"description\":\"Cancel a pending phone number release during the 24-hour cooldown and restore the number to active.\",\"dateModified\":\"2026-11-18T20:13:57.298Z\",\"isPartOf\":{\"@id\":\"https://www.vobiz.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.vobiz.ai/docs/account-phone-number/cancel-release#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.vobiz.ai/docs/account-phone-number/cancel-release#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Phone Numbers\",\"item\":\"https://www.vobiz.ai/docs/account-phone-number\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Cancel a Number Release\",\"item\":\"https://www.vobiz.ai/docs/account-phone-number/cancel-release\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.vobiz.ai/docs/account-phone-number/cancel-release#apireference\",\"headline\":\"Cancel a Number Release\",\"name\":\"Cancel a Number Release\",\"description\":\"Cancel a pending phone number release during the 24-hour cooldown and restore the number to active.\",\"url\":\"https://www.vobiz.ai/docs/account-phone-number/cancel-release\",\"mainEntityOfPage\":{\"@id\":\"https://www.vobiz.ai/docs/account-phone-number/cancel-release#webpage\"},\"dateModified\":\"2026-11-18T20:13:57.298Z\",\"keywords\":\"cancel number release, pending release, restore phone number, release cooldown, refund release fee, Vobiz number API\",\"publisher\":{\"@id\":\"https://www.vobiz.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://www.vobiz.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Vobiz\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Vobiz\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/account-phone-number/cancel-release.md","siteName":"Vobiz","nav":{"global":{"anchors":[{"anchor":"API Status","icon":"signal","href":"https://status.vobiz.ai"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","anchors":[{"anchor":"Regular APIs","icon":"database","groups":[{"group":"Account","boost":3,"icon":"circle-user","root":{"title":"Vobiz Account API: Balance \u0026 Concurrency","sidebarTitle":"Account","href":"/account"},"pages":[{"title":"The Account Object","href":"/account/account-object"},{"openapi":"GET /api/v1/auth/me","title":"Retrieve Account Details","href":"/account/retrieve-account"},{"openapi":"GET /api/v1/Account/{auth_id}/balance/{currency}","title":"Balance","href":"/account/balance"},{"openapi":"GET /api/v1/Account/{auth_id}/transactions","title":"Transactions","href":"/account/transactions"},{"openapi":"GET /api/v1/Account/{auth_id}/concurrency","title":"Get Account Concurrency — Live Call Capacity","sidebarTitle":"Concurrency","href":"/account/concurrency"},{"openapi":"GET /api/v1/accounts/{auth_id}/channel-pricing-preview","title":"Preview CPS and concurrency pricing","sidebarTitle":"Preview capacity pricing","href":"/account/channel-pricing-preview"},{"openapi":"POST /api/v1/accounts/{auth_id}/channel-subscriptions","title":"Purchase CPS or concurrency capacity","sidebarTitle":"Purchase capacity","href":"/account/channel-subscriptions"},{"title":"NDNC Webhook","sidebarTitle":"NDNC Webhook","href":"/account/ndnc-webhook"}]},{"group":"Sub-Accounts","icon":"sitemap","root":{"title":"Vobiz Sub-Accounts API: Multi-Tenant Accounts","sidebarTitle":"Sub-Accounts","href":"/sub-accounts"},"pages":[{"title":"Sub-Account Onboarding Flow","sidebarTitle":"Onboarding Flow","href":"/sub-accounts/onboarding-flow"},{"title":"The Subaccount Object","sidebarTitle":"Subaccount Object","href":"/sub-accounts/subaccount-object"},{"openapi":"POST /api/v1/accounts/{auth_id}/sub-accounts/","title":"Create a Subaccount","sidebarTitle":"Create Subaccount","href":"/sub-accounts/create-subaccount"},{"openapi":"GET /api/v1/accounts/{auth_id}/sub-accounts/{sub_auth_id}","title":"Retrieve a Subaccount","sidebarTitle":"Retrieve Subaccount","href":"/sub-accounts/retrieve-subaccount"},{"openapi":"PUT /api/v1/accounts/{auth_id}/sub-accounts/{sub_auth_id}","title":"Update a Subaccount","sidebarTitle":"Update Subaccount","href":"/sub-accounts/update-subaccount"},{"openapi":"DELETE /api/v1/accounts/{auth_id}/sub-accounts/{sub_auth_id}","title":"Delete a Subaccount","sidebarTitle":"Delete Subaccount","href":"/sub-accounts/delete-subaccount"},{"openapi":"GET /api/v1/accounts/{auth_id}/sub-accounts/","title":"List All Subaccounts","sidebarTitle":"List Subaccounts","href":"/sub-accounts/list-all-subaccounts"},{"openapi":"POST /api/v1/account/{auth_id}/numbers/{e164}/assign-subaccount","title":"Assign DID to Sub-Account","sidebarTitle":"Assign to Sub-Account","href":"/account-phone-number/assign-subaccount"},{"openapi":"DELETE /api/v1/account/{auth_id}/numbers/{e164}/assign-subaccount","title":"Unassign DID (15-Day Cool-Off)","sidebarTitle":"Unassign from Sub-Account","href":"/account-phone-number/unassign-subaccount"},{"group":"KYC","icon":"id-card","pages":[{"title":"Sub-Account KYC","sidebarTitle":"Overview","href":"/sub-accounts/kyc/overview"},{"openapi":"GET /api/v1/sub-accounts/{sub_auth_id}/kyc/status","title":"Get KYC Status","sidebarTitle":"KYC Status","href":"/sub-accounts/kyc/kyc-status"},{"openapi":"POST /api/v1/sub-accounts/{sub_auth_id}/kyc-sessions","title":"Initialize KYC","sidebarTitle":"Initialize KYC","href":"/sub-accounts/kyc/kyc-session"},{"title":"KYC Email Flow with Webhook","sidebarTitle":"Email Flow \u0026 Webhook","href":"/sub-accounts/kyc/email-flow-webhook"},{"title":"KYC Redirect Flow with Webhook","sidebarTitle":"Redirect Flow \u0026 Webhook","href":"/sub-accounts/kyc/redirect-flow-webhook"},{"title":"KYC Test Mode","sidebarTitle":"Test Mode","href":"/sub-accounts/kyc/test-mode"}]}]},{"group":"Phone Numbers","icon":"phone","root":{"title":"Vobiz Phone Numbers API: Buy \u0026 Manage DIDs","sidebarTitle":"Phone Numbers","href":"/account-phone-number"},"pages":[{"title":"The PhoneNumber Object","sidebarTitle":"PhoneNumber Object","href":"/account-phone-number/account-phone-number-object"},{"openapi":"GET /api/v1/Account/{auth_id}/numbers","title":"List Account Phone Numbers","href":"/account-phone-number/list-account-phone-numbers"},{"title":"List Inventory Numbers","sidebarTitle":"List Inventory","openapi":"GET /api/v1/Account/{auth_id}/inventory/numbers","href":"/account-phone-number/list-inventory-numbers"},{"title":"Purchase from Inventory","sidebarTitle":"Purchase Number","openapi":"POST /api/v1/Account/{auth_id}/numbers/purchase-from-inventory","href":"/account-phone-number/purchase-from-inventory"},{"openapi":"DELETE /api/v1/Account/{auth_id}/numbers/{e164}","title":"Release a Phone Number","description":"Release a Vobiz phone number for an account-specific fee, with a 24-hour cancellation window or an immediate-release option.","href":"/account-phone-number/unrent-number"},{"openapi":"POST /api/v1/account/{account_id}/numbers/{e164}/cancel-release","title":"Cancel a Number Release","sidebarTitle":"Cancel Release","href":"/account-phone-number/cancel-release"},{"openapi":"GET /api/v1/account/{auth_id}/numbers/{e164}/health","title":"Get Number Health Dashboard","sidebarTitle":"Number Health","description":"Retrieve the health of a Vobiz number - status, spam flag, and call metrics such as answer rate and minutes, with a daily time series of snapshots.","href":"/account-phone-number/get-number-health"}]},{"group":"Recordings","icon":"circle-dot","root":{"title":"Vobiz Recordings API: Call \u0026 Conference Recordings","sidebarTitle":"Recording","href":"/recording"},"pages":[{"title":"The Recording Object","href":"/recording/recording-object"},{"openapi":"GET /api/v1/Account/{auth_id}/Recording/{recording_id}/","title":"Retrieve a Recording","href":"/recording/retrieve-recording"},{"openapi":"GET /api/v1/Account/{auth_id}/Recording/","title":"List All Recordings","href":"/recording/list-all-recordings"},{"title":"Download a Recording","href":"/recording/download-recording"},{"openapi":"POST /api/v1/Account/{auth_id}/export/recording/","title":"Export Historical Recordings","sidebarTitle":"Export Recordings","href":"/recording/export-historical-recordings"}]},{"group":"Call Detail Records","icon":"list-ul","root":{"title":"Vobiz Call Detail Records (CDR) API","sidebarTitle":"Call Detail Records","href":"/cdr"},"pages":[{"title":"List CDRs","openapi":"GET /api/v1/Account/{auth_id}/cdr","href":"/cdr/list-cdrs"},{"title":"Get Single CDR","openapi":"GET /api/v1/Account/{auth_id}/cdr/{call_id}","href":"/cdr/get-cdr"},{"title":"Search CDRs","openapi":"GET /api/v1/Account/{auth_id}/cdr/search","href":"/cdr/search-cdrs"},{"title":"Recent CDRs","openapi":"GET /api/v1/Account/{auth_id}/cdr/recent","href":"/cdr/recent-cdrs"},{"title":"Export CDRs as CSV","openapi":"GET /api/v1/Account/{auth_id}/cdr/export","href":"/cdr/export-cdrs"}]}]},{"anchor":"SIP Trunking","icon":"network-wired","pages":[{"title":"SIP Trunking","href":"/trunks"}]},{"anchor":"Voice \u0026 XML","icon":"microphone","pages":[{"title":"Voice \u0026 XML","href":"/applications"}]},{"anchor":"SMS \u0026 RCS","icon":"comment-sms","pages":[{"title":"SMS \u0026 RCS","href":"/sms/overview"}]},{"anchor":"WhatsApp","icon":"comment-dots","pages":[{"title":"WhatsApp","href":"/whatsapp/getting-started/introduction"}]},{"anchor":"Partner API","icon":"handshake","pages":[{"title":"Partner API","href":"/partner"}]}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations"}]},{"tab":"Examples \u0026 Tutorials","pages":[{"title":"Examples \u0026 Tutorials","href":"/guides/ai-voice-agent"}]},{"tab":"Blogs","pages":[{"title":"Blogs","href":"/blogs"}]}]},"basePath":"","title":"Cancel a Number Release - Vobiz","deploymentId":"dpl_B1qJC7o4Nbc1BrDLB8Y5TDHq3c2t","buildId":"dpl_B1qJC7o4Nbc1BrDLB8Y5TDHq3c2t","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CUHhyXy2.js","snippetPresets-CLZ6zHrE.js","utils-YgZO0660.js","style-to-object-BY3JEAdk.js","utils-BfGpunL-.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-nXeJG4mW.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CfiGwWS2.js","_Uint8Array-DMwpGz7v.js","isObject-FP1Yky1u.js","Page-wRPqmnTs.js","CodeSnippet-CD0M-PIN.js","DynamicMarkdown-B4E-vXj3.js","SectionHeading-Cd1Hebqh.js","icon-CopWpdT0.js","ApiExamples-ClwIRLsI.js","usePlaygroundInputsStore-D3zE52Kn.js","shallow-D4RQzCAp.js","isEqual-Ba6nq9eA.js","CodeSnippets-DK9iv102.js","getApiPlaygroundDisplay-MZpK72mj.js","MethodPill-DHN7T7vW.js","getPastedJson-BuLRhr5B.js","Check2Icon-DTvkZOnk.js","axios-CsQoIw0U.js","Markdown-BZDfk3ee.js","AssistantPageLink-CXXpl6Pb.js","dist-D0qiytnz.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}