Create the short-lived authorization blob used by the mobile SDK to clear a
device’s local pairing state and stored device token. This operation is
non-destructive: it does not erase recordings and is not a factory reset.
Authentication
Requires an API key with devices:write scope. Call this
endpoint from your backend, never directly from a mobile app.
Prerequisites
The device was bound with pk_d.
The app is connected over BLE and has subscribed to the current auth nonce.
For nonce-bound firmware, send that nonce as nonce_d.
Current device auth nonce as 16 bytes encoded as 32 lowercase hexadecimal
characters. Required by current nonce-bound firmware; omission exists only
for legacy compatibility.
Pass grant_blob to the SDK deprovision operation immediately. Only after the
device confirms success should your backend call
POST /devices/{id}/unbind.
For a factory reset, use POST /devices/{id}/reset
and acknowledge the exact command after the physical wipe. Do not substitute
deprovision plus unbind for factory reset.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Bota","colors":{"primary":"#689e51","light":"#7fb366","dark":"#5a8a45"},"logo":{"light":"https://mintcdn.com/bota/PChzEAzCXQwb8s15/logo-light.png?fit=max\u0026auto=format\u0026n=PChzEAzCXQwb8s15\u0026q=85\u0026s=132aca137c9c13164cfb2177c485b332","dark":"https://mintcdn.com/bota/PChzEAzCXQwb8s15/logo-dark.png?fit=max\u0026auto=format\u0026n=PChzEAzCXQwb8s15\u0026q=85\u0026s=bfeebcf4cd4f48759c9bef1e3b17077c"},"favicon":"https://mintcdn.com/bota/PChzEAzCXQwb8s15/favicon.png?fit=max\u0026auto=format\u0026n=PChzEAzCXQwb8s15\u0026q=85\u0026s=1a3199fb19a29b90568ca60e353dafaa","api":{"playground":{"display":"interactive"},"mdx":{"auth":{"method":"bearer"},"server":"https://api.bota.dev/v1"}},"navbar":{"links":[{"href":"/support","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://platform.bota.dev"}},"footer":{"socials":{"github":"https://github.com/bota-dev"},"links":[{"items":[{"label":"Privacy Policy","href":"https://bota.dev/privacy"},{"label":"Terms of Service","href":"https://bota.dev/terms"}]}]},"styling":{"latex":true},"navigation":{"global":{},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bota","hasAudioNarration":false,"actualSubdomain":"bota","customDomains":["docs.bota.dev"],"gitSource":{"type":"github","owner":"bota-dev","repo":"docs","deployBranch":"prod","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{},"buildId":"6ae539cd48e33a304b727b4d","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":69},{"language":"default","tag":"Guides","count":24},{"language":"default","tag":"Overview","count":14},{"language":"default","tag":"Devices","count":14},{"language":"default","tag":"API Basics","count":13},{"language":"default","tag":"End Users","count":9},{"language":"default","tag":"Features","count":9},{"language":"default","tag":"Firmware","count":8},{"language":"default","tag":"Getting Started","count":7},{"language":"default","tag":"AI Ask","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":false},"customCss":[]}
{"page":{"pagePath":"api-reference/devices/deprovision-grant","slug":"/api-reference/devices/deprovision-grant","pageMetadata":{"title":"Create Deprovision Grant","api":"POST /devices/{id}/deprovision-grant","description":"Create a nonce-bound BLE grant for clearing device pairing state","href":"/api-reference/devices/deprovision-grant"},"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: \"Create a nonce-bound BLE grant for clearing device pairing state\"\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`,ul:`ul`,..._provideComponents(),...props.components},{Heading,ParamField,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Create the short-lived authorization blob used by the mobile SDK to clear a\ndevice’s local pairing state and stored device token. This operation is\nnon-destructive: it does not erase recordings and is not a factory reset.`}),`\n`,_jsx(Heading,{level:`2`,id:`authentication`,children:`Authentication`}),`\n`,_jsxs(_components.p,{children:[`Requires an `,_jsx(_components.a,{href:`/authentication`,children:`API key`}),` with `,_jsx(_components.code,{children:`devices:write`}),` scope. Call this\nendpoint from your backend, never directly from a mobile app.`]}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`The device was bound with `,_jsx(_components.code,{children:`pk_d`}),`.`]}),`\n`,_jsx(_components.li,{children:`The app is connected over BLE and has subscribed to the current auth nonce.`}),`\n`,_jsxs(_components.li,{children:[`For nonce-bound firmware, send that nonce as `,_jsx(_components.code,{children:`nonce_d`}),`.`]}),`\n`]}),`\n`,`\n`,_jsx(Heading,{level:`2`,id:`request-body`,children:`Request Body`}),`\n`,_jsx(ParamField,{body:`nonce_d`,type:`string`,id:`param-nonce-d`,children:_jsx(_components.p,{children:`Current device auth nonce as 16 bytes encoded as 32 lowercase hexadecimal\ncharacters. Required by current nonce-bound firmware; omission exists only\nfor legacy compatibility.`})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,`\n`,_jsxs(_components.p,{children:[`Pass `,_jsx(_components.code,{children:`grant_blob`}),` to the SDK deprovision operation immediately. Only after the\ndevice confirms success should your backend call\n`,_jsx(_components.a,{href:`/api-reference/devices/unbind`,children:_jsx(_components.code,{children:`POST /devices/{id}/unbind`})}),`.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`For a factory reset, use `,_jsx(_components.a,{href:`/api-reference/devices/reset`,children:_jsx(_components.code,{children:`POST /devices/{id}/reset`})}),`\nand acknowledge the exact command after the physical wipe. Do not substitute\ndeprovision plus unbind for factory reset.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create Deprovision Grant","api":"POST /devices/{id}/deprovision-grant","description":"Create a nonce-bound BLE grant for clearing device pairing state","href":"/api-reference/devices/deprovision-grant"}}},"mdxSourceWithNoJs":{"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`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,ParamField,RequestExample,ResponseExample,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Create the short-lived authorization blob used by the mobile SDK to clear a\ndevice’s local pairing state and stored device token. This operation is\nnon-destructive: it does not erase recordings and is not a factory reset.`}),`\n`,_jsx(Heading,{level:`2`,id:`authentication`,children:`Authentication`}),`\n`,_jsxs(_components.p,{children:[`Requires an `,_jsx(_components.a,{href:`/authentication`,children:`API key`}),` with `,_jsx(_components.code,{children:`devices:write`}),` scope. Call this\nendpoint from your backend, never directly from a mobile app.`]}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`The device was bound with `,_jsx(_components.code,{children:`pk_d`}),`.`]}),`\n`,_jsx(_components.li,{children:`The app is connected over BLE and has subscribed to the current auth nonce.`}),`\n`,_jsxs(_components.li,{children:[`For nonce-bound firmware, send that nonce as `,_jsx(_components.code,{children:`nonce_d`}),`.`]}),`\n`]}),`\n`,_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`cURL`,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:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.bota.dev/v1/devices/dev_abc123/deprovision-grant`}),_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:` \"Authorization: Bearer sk_test_...\"`}),_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:` \"Content-Type: application/json\"`}),_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:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{\"nonce_d\":\"0123456789abcdef0123456789abcdef\"}'`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node.js`,numberOfLines:`12`,language:`javascript`,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:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`12`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.bota.dev/v1/devices/dev_abc123/deprovision-grant'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'POST'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` Authorization:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\" `Bearer \"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`process`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`env`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`BOTA_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'application/json'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`nonce_d:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` deviceNonce`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }),`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` grant`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`request-body`,children:`Request Body`}),`\n`,_jsx(ParamField,{body:`nonce_d`,type:`string`,id:`param-nonce-d`,children:_jsx(_components.p,{children:`Current device auth nonce as 16 bytes encoded as 32 lowercase hexadecimal\ncharacters. Required by current nonce-bound firmware; omission exists only\nfor legacy compatibility.`})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:`201`,numberOfLines:`4`,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:`4`,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:` \"grant_blob\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"AQIDBA...\"`}),_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:` \"expires_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-08-19T06:15:00.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})}),`\n`,_jsxs(_components.p,{children:[`Pass `,_jsx(_components.code,{children:`grant_blob`}),` to the SDK deprovision operation immediately. Only after the\ndevice confirms success should your backend call\n`,_jsx(_components.a,{href:`/api-reference/devices/unbind`,children:_jsx(_components.code,{children:`POST /devices/{id}/unbind`})}),`.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`For a factory reset, use `,_jsx(_components.a,{href:`/api-reference/devices/reset`,children:_jsx(_components.code,{children:`POST /devices/{id}/reset`})}),`\nand acknowledge the exact command after the physical wipe. Do not substitute\ndeprovision plus unbind for factory reset.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create Deprovision Grant","api":"POST /devices/{id}/deprovision-grant","description":"Create a nonce-bound BLE grant for clearing device pairing state","href":"/api-reference/devices/deprovision-grant"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Authentication","slug":"authentication","depth":2,"children":[]},{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[]},{"title":"Request Body","slug":"request-body","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"4\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -X\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> https://api.bota.dev/v1/devices/dev_abc123/deprovision-grant\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Authorization: Bearer sk_test_...\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Content-Type: application/json\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -d\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '{\"nonce_d\":\"0123456789abcdef0123456789abcdef\"}'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Node.js","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"javascript\">\u003ccode language=\"javascript\" numberOfLines=\"12\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> response\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\"> fetch\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'https://api.bota.dev/v1/devices/dev_abc123/deprovision-grant'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> method:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'POST'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> headers:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> Authorization:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> `Bearer \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">${\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">process\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">env\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\">BOTA_API_KEY\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Content-Type'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'application/json'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> body:\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> JSON\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">stringify\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">({ \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">nonce_d:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> deviceNonce\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }),\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> grant\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> response\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">json\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">();\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"201","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"4\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"grant_blob\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"AQIDBA...\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"expires_at\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-08-19T06:15:00.000Z\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Create Deprovision Grant","path":"/devices/{id}/deprovision-grant","servers":[{"url":"https://api.bota.dev/v1"}],"method":"post","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"nonce_d":[{"type":"string","description":"Current device auth nonce as 16 bytes encoded as 32 lowercase hexadecimal characters. Required by current nonce-bound firmware; omission exists only for legacy compatibility."}]}}],"examples":{"example":{"value":{"nonce_d":"\u003cstring>"}}}}}},"response":{},"deprecated":false}},"jsLinks":[],"subdomain":"bota","siteName":"Bota","title":"Create Deprovision Grant - Bota","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-19T08:08:50.048Z","originalFileLocation":"api-reference/devices/deprovision-grant.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=\"Create a nonce-bound BLE grant for clearing device pairing state\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bota\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bota/iIFPO_Q7te9pAv-o/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/bota/iIFPO_Q7te9pAv-o/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bota/iIFPO_Q7te9pAv-o/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bota/iIFPO_Q7te9pAv-o/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bota/iIFPO_Q7te9pAv-o/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bota/iIFPO_Q7te9pAv-o/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bota/iIFPO_Q7te9pAv-o/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bota/iIFPO_Q7te9pAv-o/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bota/iIFPO_Q7te9pAv-o/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Deprovision Grant - Bota\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a nonce-bound BLE grant for clearing device pairing state\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bota\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bota.dev/api-reference/devices/deprovision-grant\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bota.mintlify.site/_mintlify/api/og/v2?division=Devices\u0026amp;title=Create+Deprovision+Grant\u0026amp;description=Create+a+nonce-bound+BLE+grant+for+clearing+device+pairing+state\u0026amp;theme=f9094092291468256398fa8f\u0026amp;signature=bc5b7083f9fc144d52ae2d5d86323668dec17347f4d3250872885c908cd11151\">\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=\"Create Deprovision Grant - Bota\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a nonce-bound BLE grant for clearing device pairing state\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bota.mintlify.site/_mintlify/api/og/v2?division=Devices\u0026amp;title=Create+Deprovision+Grant\u0026amp;description=Create+a+nonce-bound+BLE+grant+for+clearing+device+pairing+state\u0026amp;theme=f9094092291468256398fa8f\u0026amp;signature=bc5b7083f9fc144d52ae2d5d86323668dec17347f4d3250872885c908cd11151\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/bota/iIFPO_Q7te9pAv-o/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bota\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#689e51\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bota.dev/api-reference/devices/deprovision-grant\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/devices/deprovision-grant.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bota.dev/#organization\",\"name\":\"Bota\",\"url\":\"https://docs.bota.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/bota/PChzEAzCXQwb8s15/logo-light.png?fit=max\u0026auto=format\u0026n=PChzEAzCXQwb8s15\u0026q=85\u0026s=132aca137c9c13164cfb2177c485b332\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bota.dev#website\",\"name\":\"Bota\",\"url\":\"https://docs.bota.dev\",\"publisher\":{\"@id\":\"https://docs.bota.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bota.dev/api-reference/devices/deprovision-grant#webpage\",\"url\":\"https://docs.bota.dev/api-reference/devices/deprovision-grant\",\"name\":\"Create Deprovision Grant\",\"description\":\"Create a nonce-bound BLE grant for clearing device pairing state\",\"dateModified\":\"2026-08-19T08:08:50.048Z\",\"isPartOf\":{\"@id\":\"https://docs.bota.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bota.dev/api-reference/devices/deprovision-grant#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bota.dev/api-reference/devices/deprovision-grant#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Devices\",\"item\":\"https://docs.bota.dev/api-reference/devices/create\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Deprovision Grant\",\"item\":\"https://docs.bota.dev/api-reference/devices/deprovision-grant\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.bota.dev/api-reference/devices/deprovision-grant#apireference\",\"headline\":\"Create Deprovision Grant\",\"name\":\"Create Deprovision Grant\",\"description\":\"Create a nonce-bound BLE grant for clearing device pairing state\",\"url\":\"https://docs.bota.dev/api-reference/devices/deprovision-grant\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bota.dev/api-reference/devices/deprovision-grant#webpage\"},\"dateModified\":\"2026-08-19T08:08:50.048Z\",\"publisher\":{\"@id\":\"https://docs.bota.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bota.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bota\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Bota\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/devices/deprovision-grant.md","siteName":"Bota","nav":{"global":{},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference","href":"/api-reference/introduction"},{"group":"API Basics","expanded":false,"pages":[{"title":"Errors","href":"/api-reference/errors"},{"title":"Credential identity","href":"/api-reference/auth/identity"},{"title":"Pagination","href":"/api-reference/pagination"},{"title":"Filtering","href":"/api-reference/filtering"},{"title":"Rate Limits","href":"/api-reference/rate-limits"},{"title":"Timestamps","href":"/api-reference/timestamps"},{"title":"External IDs","href":"/api-reference/external-ids"},{"title":"Versioning","href":"/api-reference/versioning"},{"title":"Idempotency","href":"/api-reference/idempotency"},{"title":"Test Mode (Coming Soon)","href":"/api-reference/test-mode"},{"title":"OpenAPI Spec","href":"/api-reference/openapi"},{"title":"Postman Collection","href":"/api-reference/postman"},{"title":"Client SDKs","href":"/api-reference/client-sdks"}]}]},{"group":"End Users","pages":[{"title":"Create End User","api":"POST /end-users","href":"/api-reference/end-users/create"},{"title":"List End Users","api":"GET /end-users","href":"/api-reference/end-users/list"},{"title":"Get End User","api":"GET /end-users/{id}","href":"/api-reference/end-users/get"},{"title":"Delete End User","api":"DELETE /end-users/{id}","href":"/api-reference/end-users/delete"},{"title":"Get Terms and Acceptance","openapi":"GET /end-users/{id}/terms","href":"/api-reference/end-users/terms"},{"title":"Record Terms Presentation","openapi":"POST /end-users/{id}/terms/notices","href":"/api-reference/end-users/terms-notice"},{"title":"Record Terms Acceptance","openapi":"POST /end-users/{id}/terms/acceptances","href":"/api-reference/end-users/terms-acceptance"},{"title":"List Terms Events","openapi":"GET /end-users/{id}/terms/events","href":"/api-reference/end-users/terms-events"},{"title":"Get Terms Document","openapi":"GET /end-users/{id}/terms/documents/{version}","href":"/api-reference/end-users/terms-document"}]},{"group":"Integrations","pages":[{"title":"Provider Integrations","href":"/api-reference/integrations/overview"}]},{"group":"Devices","pages":[{"title":"Register Device","api":"POST /devices","href":"/api-reference/devices/create"},{"title":"List Devices","api":"GET /devices","href":"/api-reference/devices/list"},{"title":"Get Device","api":"GET /devices/{id}","href":"/api-reference/devices/get"},{"title":"Get Device State","api":"GET /devices/{id}/state","href":"/api-reference/devices/get-state"},{"title":"Update Device","api":"PATCH /devices/{id}","href":"/api-reference/devices/update"},{"title":"Bind Device","api":"POST /devices/{id}/bind","description":"Bind a device to an end user and receive a device token for 4G uploads","href":"/api-reference/devices/bind"},{"title":"Create Deprovision Grant","api":"POST /devices/{id}/deprovision-grant","href":"/api-reference/devices/deprovision-grant"},{"title":"Unbind Device","api":"POST /devices/{id}/unbind","description":"Unbind a device from its current end user","href":"/api-reference/devices/unbind"},{"title":"Reset Device","api":"POST /devices/{id}/reset","href":"/api-reference/devices/reset"},{"title":"Device Heartbeat","api":"POST /devices/{id}/heartbeat","href":"/api-reference/devices/heartbeat"},{"title":"Create WiFi Config Grant","api":"POST /devices/{id}/wifi-config/grant","href":"/api-reference/devices/wifi-config-grant"},{"title":"Create Device Command","api":"POST /devices/{id}/commands","href":"/api-reference/devices/create-command"},{"title":"List Device Commands","api":"GET /devices/{id}/commands","href":"/api-reference/devices/list-commands"},{"title":"Cancel Device Command","api":"DELETE /devices/{id}/commands/{commandId}","href":"/api-reference/devices/cancel-command"}]},{"group":"Firmware","pages":[{"title":"List Firmware Releases","api":"GET /firmware-releases","href":"/api-reference/firmware/list"},{"title":"Get Firmware Release","api":"GET /firmware-releases/{id}","href":"/api-reference/firmware/get"},{"title":"Get Firmware Download URL","api":"GET /firmware-releases/{id}/download-url","href":"/api-reference/firmware/download-url"},{"title":"Assign Firmware to Device","api":"POST /devices/{id}/ota","href":"/api-reference/firmware/assign-ota"},{"title":"Issue Bluetooth OTA Grant","api":"POST /v1/devices/{id}/ota-grant","href":"/api-reference/firmware/ota-grant"},{"title":"Get Device OTA Status","api":"GET /devices/{id}/ota","href":"/api-reference/firmware/get-ota"},{"title":"List Device OTA History","api":"GET /devices/{id}/ota/history","href":"/api-reference/firmware/ota-history"},{"title":"Cancel Device OTA Assignment","api":"DELETE /devices/{id}/ota","href":"/api-reference/firmware/cancel-ota"}]},{"group":"Recordings","pages":[{"title":"Create Recording","api":"POST /recordings","href":"/api-reference/recordings/create"},{"title":"Finalize Streaming Recording","api":"POST /recordings/{id}/finalize","href":"/api-reference/recordings/finalize-streaming"},{"title":"List Recordings","api":"GET /recordings","href":"/api-reference/recordings/list"},{"title":"Get Recording","api":"GET /recordings/{id}","href":"/api-reference/recordings/get"},{"title":"Delete Recording","api":"DELETE /recordings/{id}","href":"/api-reference/recordings/delete"},{"title":"Search Recordings","api":"POST /recordings/search","href":"/api-reference/recordings/search"}]},{"group":"Uploads","pages":[{"title":"Get Upload URL","api":"POST /recordings/{id}/upload-url","href":"/api-reference/uploads/create-url"},{"title":"Get Download URL","api":"GET /recordings/{id}/download-url","href":"/api-reference/uploads/download-url"},{"title":"Complete Upload","api":"POST /recordings/{id}/upload-complete","href":"/api-reference/uploads/complete"},{"title":"Encrypted Upload v2","href":"/api-reference/uploads/encrypted-v2"}]},{"group":"AI Ask","pages":[{"title":"Create Session","api":"POST /ask/sessions","href":"/api-reference/ask/create-session"},{"title":"Send Message","api":"POST /ask/sessions/{id}/messages","href":"/api-reference/ask/send-message"},{"title":"List Sessions","api":"GET /ask/sessions","href":"/api-reference/ask/list-sessions"},{"title":"Get Session","api":"GET /ask/sessions/{id}","href":"/api-reference/ask/get-session"},{"title":"List Messages","api":"GET /ask/sessions/{id}/messages","href":"/api-reference/ask/list-messages"},{"title":"Update Session","api":"PATCH /ask/sessions/{id}","href":"/api-reference/ask/update-session"},{"title":"Delete Session","api":"DELETE /ask/sessions/{id}","href":"/api-reference/ask/delete-session"}]},{"group":"AI Processing","pages":[{"title":"Create Transcription","api":"POST /transcriptions","href":"/api-reference/ai/transcriptions/create"},{"title":"Get Transcription","api":"GET /transcriptions/{id}","href":"/api-reference/ai/transcriptions/get"},{"title":"Create Summary","api":"POST /summaries","href":"/api-reference/ai/summaries/create"},{"title":"Get Summary","api":"GET /summaries/{id}","href":"/api-reference/ai/summaries/get"}]},{"group":"Resources","pages":[{"title":"Changelog","href":"/changelog"},{"title":"API Status","href":"/api-reference/api-status"}]}]}]},"basePath":"","title":"Create Deprovision Grant - Bota","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js"]}