This endpoint allows you to permanently remove a registered secret from storage, revoking access for any tool previously authorized to use it. Once deleted, the secret and its associations cannot be recovered.
The API supports multiple authentication mechanisms, but only one needs to be provided per request. You may authenticate using any of the following headers, an Authorization header, or an x-api-key header (io.net API key).
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"io.net","colors":{"primary":"#6b6b6b","light":"#6b6b6b","dark":"#6b6b6b"},"logo":{"light":"https://mintcdn.com/ionet-cca8037f/b19dlbPlCUid06dF/logo/light.svg?fit=max\u0026auto=format\u0026n=b19dlbPlCUid06dF\u0026q=85\u0026s=debc44eff771f4f2f76b8b8a86faf828","dark":"https://mintcdn.com/ionet-cca8037f/b19dlbPlCUid06dF/logo/dark.svg?fit=max\u0026auto=format\u0026n=b19dlbPlCUid06dF\u0026q=85\u0026s=ea1ddf5bcdb6dab50a40fe0c7b30589f"},"favicon":"https://mintcdn.com/ionet-cca8037f/UVfyCRC1Po30yGvw/logo-small-favicon.png?fit=max\u0026auto=format\u0026n=UVfyCRC1Po30yGvw\u0026q=85\u0026s=7f6d17a7f949fb2e0ddaf85f9da85629","appearance":{"default":"light","strict":true},"fonts":{"heading":{"family":"Geist","source":"https://cdn.jsdelivr.net/fontsource/fonts/geist@latest/latin-400-normal.woff2","format":"woff2"},"body":{"family":"Geist","source":"https://cdn.jsdelivr.net/fontsource/fonts/geist@latest/latin-400-normal.woff2","format":"woff2"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ionet-cca8037f","hasAudioNarration":false,"actualSubdomain":"ionet-cca8037f","customDomains":["io.net"],"gitSource":{"type":"github","owner":"ionet-official","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aec56ed754501e0c6b58691","collectionId":"011874f7-2bd8-4421-ad50-a739e36f9792","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aec56ed754501e0c6b58691"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aec56ed754501e0c6b58691","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"Community","count":59},{"language":"default","tag":"API References","count":51},{"language":"default","tag":"IO Worker","count":35},{"language":"default","tag":"IO Cloud","count":25},{"language":"default","tag":"Cloud","count":23},{"language":"default","tag":"IO Intelligence","count":21},{"language":"default","tag":"Core Concepts","count":17},{"language":"default","tag":"Intelligence","count":16},{"language":"default","tag":"IO Explorer","count":13},{"language":"default","tag":"IO Staking","count":13}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","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":"llms-txt-v2","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":"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":"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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"@font-face{font-family:\"Geist\";font-style:normal;font-weight:400;font-display:swap;src:url(\"https://cdn.jsdelivr.net/fontsource/fonts/geist@latest/latin-400-normal.woff2\") format(\"woff2\")}:root{--gray-700: 10, 10, 10;--primary: 10, 10, 10}body,#sidebar,#content-area,#content-container{font-family:\"Geist\", ui-sans-serif, system-ui, sans-serif}#search-bar-entry{border-radius:9999px!important}@media (min-width: 1024px){:has(>#content-container){background:#f9f9f9}}#content-area{position:relative}#content-area::before{content:\"\";display:none}@media (min-width: 1024px){#content-area::before{display:block;position:absolute;top:-2.5rem;left:-2.5rem;width:calc(100% + 5rem);height:calc(100% + 2.5rem);background:#fff}#content-area{}}#sidebar{background:#f9f9f9}.nav-logo{height:20px}#table-of-contents-content,#table-of-contents-layout{display:block!important;min-width:12rem}.toc-track-wrapper{position:relative;padding-left:0rem}.toc{padding-left:0.75rem}.toc-track{position:absolute;left:0;top:0;bottom:0;width:1px;background:#f5f5f5;border-radius:1px;pointer-events:none}.toc-thumb{position:absolute;left:0;width:1px;background:#0a0a0a;border-radius:1px;pointer-events:none;transition:top 0.2s ease-out, height 0.2s ease-out}"}],"page":{"pagePath":"reference/ai-agents/secret-management-delete","slug":"/reference/ai-agents/secret-management-delete","pageMetadata":{"openapi":"openapi/ai-agents/secret-management-delete.json DELETE /v1/secrets/{secret_id}","title":"Delete a Secret","description":"Deletes an existing secret and its associated configuration.","href":"/reference/ai-agents/secret-management-delete"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Deletes an existing secret and its associated configuration.\"\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={code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Note}=_components;if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`This endpoint allows you to permanently remove a registered secret from storage, revoking access for any tool previously authorized to use it. Once deleted, the secret and its associations cannot be recovered.`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The API supports multiple authentication mechanisms, but only `,_jsx(_components.strong,{children:`one`}),` needs to be provided per request. You may authenticate using `,_jsx(_components.strong,{children:`any`}),` of the following headers, an `,_jsx(_components.code,{children:`Authorization`}),` header, or an `,_jsx(_components.code,{children:`x-api-key`}),` header (io.net API key).`]})})]})}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":"openapi/ai-agents/secret-management-delete.json DELETE /v1/secrets/{secret_id}","title":"Delete a Secret","description":"Deletes an existing secret and its associated configuration.","href":"/reference/ai-agents/secret-management-delete"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/ionet-cca8037f/536253863eb63726/scripts/toc-track.js"],"openApiReferenceData":{"operation":{"tags":["agents"],"summary":"Delete Secret","operationId":"delete_secret_v1_secrets__secret_id__delete","parameters":["79513e64-8932-4b6d-9e12-bc796d161fb7"],"responses":{"200":"9dcb89d4-8cfc-4287-ac76-0f24088c3b14","404":"1640c2f6-74d6-46c0-b8c5-01b527f7d4c8","422":"2fa6c972-6dcb-41f8-ac5c-2c02a708f24e"},"method":"delete","type":"path","servers":["4c38c0d9-c0b5-4140-a518-67580855a847"],"security":["6cd90150-be49-418d-8d28-badaa4c0cf61","4b5499a6-03c3-412b-aa10-c4cc4982deba"],"path":"/v1/secrets/{secret_id}","baseUrlOptions":["https://api.intelligence.io.solutions"],"title":"Delete Secret","description":"Deletes an existing secret and its associated configuration.","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"79513e64-8932-4b6d-9e12-bc796d161fb7":{"name":"secret_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Secret Id","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"9dcb89d4-8cfc-4287-ac76-0f24088c3b14":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"exampleType":"generated"},"1640c2f6-74d6-46c0-b8c5-01b527f7d4c8":{"description":"Not found","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"2fa6c972-6dcb-41f8-ac5c-2c02a708f24e":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"6cd90150-be49-418d-8d28-badaa4c0cf61":{"BearerAuth":{"type":"http","scheme":"bearer","description":"io.net provided API Key, sent as `Authorization: Bearer \u003cAPI_KEY>`.","scopes":[],"schemeName":"BearerAuth"}},"4b5499a6-03c3-412b-aa10-c4cc4982deba":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"io.net provided API Key. Use either this header or `Authorization: Bearer \u003cAPI_KEY>`.","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"4c38c0d9-c0b5-4140-a518-67580855a847":{"url":"https://api.intelligence.io.solutions"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"io.net provided API Key, sent as `Authorization: Bearer \u003cAPI_KEY>`.","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"io.net provided API Key, sent as `Authorization: Bearer \u003cAPI_KEY>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"},{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"io.net provided API Key. Use either this header or `Authorization: Bearer \u003cAPI_KEY>`.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-api-key","type":"string","description":"io.net provided API Key. Use either this header or `Authorization: Bearer \u003cAPI_KEY>`.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi/ai-agents/secret-management-delete.json"},"subdomain":"ionet-cca8037f","siteName":"io.net","title":"Delete a Secret - io.net","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T11:31:38.166Z","originalFileLocation":"reference/ai-agents/secret-management-delete.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";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=\"light\"}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=\"Deletes an existing secret and its associated configuration.\">\u003cmeta data-mint-head name=\"application-name\" content=\"io.net\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/ionet-cca8037f/45_PhHvAsXqoDTU6/_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/ionet-cca8037f/45_PhHvAsXqoDTU6/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/ionet-cca8037f/45_PhHvAsXqoDTU6/_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/ionet-cca8037f/45_PhHvAsXqoDTU6/_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/ionet-cca8037f/45_PhHvAsXqoDTU6/_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/ionet-cca8037f/45_PhHvAsXqoDTU6/_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/ionet-cca8037f/45_PhHvAsXqoDTU6/_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/ionet-cca8037f/45_PhHvAsXqoDTU6/_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/ionet-cca8037f/45_PhHvAsXqoDTU6/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Delete a Secret - io.net\">\u003cmeta data-mint-head property=\"og:description\" content=\"Deletes an existing secret and its associated configuration.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"io.net\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://io.net/docs/reference/ai-agents/secret-management-delete\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ionet-cca8037f.mintlify.site/docs/_mintlify/api/og/v2?division=Secret+Management\u0026amp;title=Delete+a+Secret\u0026amp;description=Deletes+an+existing+secret+and+its+associated+configuration.\u0026amp;theme=dd3fe0536bec471aecbf47c0\u0026amp;signature=c4ce106b7576cc2e9e3e3051434ff4378da9d459aa78cec6eecbab2d463f59b8\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Delete a Secret - io.net\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Deletes an existing secret and its associated configuration.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ionet-cca8037f.mintlify.site/docs/_mintlify/api/og/v2?division=Secret+Management\u0026amp;title=Delete+a+Secret\u0026amp;description=Deletes+an+existing+secret+and+its+associated+configuration.\u0026amp;theme=dd3fe0536bec471aecbf47c0\u0026amp;signature=c4ce106b7576cc2e9e3e3051434ff4378da9d459aa78cec6eecbab2d463f59b8\">\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/ionet-cca8037f/45_PhHvAsXqoDTU6/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"io.net\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6b6b6b\">\u003clink data-mint-head rel=\"canonical\" href=\"https://io.net/docs/reference/ai-agents/secret-management-delete\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/reference/ai-agents/secret-management-delete.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://io.net/#organization\",\"name\":\"io.net\",\"url\":\"https://io.net\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ionet-cca8037f/b19dlbPlCUid06dF/logo/light.svg?fit=max\u0026auto=format\u0026n=b19dlbPlCUid06dF\u0026q=85\u0026s=debc44eff771f4f2f76b8b8a86faf828\"}},{\"@type\":\"WebSite\",\"@id\":\"https://io.net/docs#website\",\"name\":\"io.net\",\"url\":\"https://io.net/docs\",\"publisher\":{\"@id\":\"https://io.net/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://io.net/docs/reference/ai-agents/secret-management-delete#webpage\",\"url\":\"https://io.net/docs/reference/ai-agents/secret-management-delete\",\"name\":\"Delete a Secret\",\"description\":\"Deletes an existing secret and its associated configuration.\",\"dateModified\":\"2026-11-04T11:31:38.166Z\",\"isPartOf\":{\"@id\":\"https://io.net/docs#website\"},\"breadcrumb\":{\"@id\":\"https://io.net/docs/reference/ai-agents/secret-management-delete#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://io.net/docs/reference/ai-agents/secret-management-delete#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"IO Intelligence\",\"item\":\"https://io.net/docs/reference/ai-models/get-started-with-io-intelligence-api\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Getting Started with AI Agents API\",\"item\":\"https://io.net/docs/reference/ai-agents/getting-started-with-api-agents\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Secret Management\",\"item\":\"https://io.net/docs/reference/ai-agents/secret-management-list\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Delete a Secret\",\"item\":\"https://io.net/docs/reference/ai-agents/secret-management-delete\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://io.net/docs/reference/ai-agents/secret-management-delete#apireference\",\"headline\":\"Delete a Secret\",\"name\":\"Delete a Secret\",\"description\":\"Deletes an existing secret and its associated configuration.\",\"url\":\"https://io.net/docs/reference/ai-agents/secret-management-delete\",\"mainEntityOfPage\":{\"@id\":\"https://io.net/docs/reference/ai-agents/secret-management-delete#webpage\"},\"dateModified\":\"2026-11-04T11:31:38.166Z\",\"publisher\":{\"@id\":\"https://io.net/#organization\"},\"isPartOf\":{\"@id\":\"https://io.net/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"io.net\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"io.net","nav":{"global":null,"tabs":[{"tab":"Core Concepts","pages":[{"title":"Core Concepts","href":"/guides/inception"}]},{"tab":"Cloud","pages":[{"title":"Cloud","href":"/guides/clouds/io-cloud"}]},{"tab":"Intelligence","pages":[{"title":"Intelligence","href":"/guides/intelligence/unified-chat"}]},{"tab":"Community","pages":[{"title":"Community","href":"/guides/workers/io-worker"}]},{"tab":"API References","groups":[{"group":"IO Explorer","pages":[{"group":"Getting Started With IO Explorer API","pages":[{"title":"Getting Started with IO Explorer API","sidebarTitle":"Overview","href":"/reference/io-explorer/getting-started-with-your-api"},{"title":"Device Object Reference","href":"/reference/io-explorer/objects"},{"openapi":"openapi/io-explorer/get-device-details.json GET /v1/io-explorer/devices/{device_id}/details","title":"Device Details","href":"/reference/io-explorer/get-device-details"},{"openapi":"openapi/io-explorer/device-summary.json GET /v1/io-explorer/devices/{device_id}/summary","title":"Device Summary","href":"/reference/io-explorer/device-summary"},{"openapi":"openapi/io-explorer/pow-summary.json GET /v1/io-explorer/devices/{device_id}/pow-summary","title":"PoW Summary","href":"/reference/io-explorer/pow-summary"}]}]},{"group":"IO Intelligence","pages":[{"group":"Getting Started with AI Models API","pages":[{"sidebarTitle":"Overview","title":"Getting Started with AI Models API","href":"/reference/ai-models/get-started-with-io-intelligence-api"},{"title":"Uploading Images","href":"/reference/ai-models/uploading-images"},{"openapi":"openapi/ai-models/get-models-list.json GET /api/v1/models","title":"Models List","sidebarTitle":"Models List","href":"/reference/ai-models/get-models-list"},{"openapi":"openapi/ai-models/create-chat-completion.json POST /api/v1/chat/completions","title":"Create Chat Completion","sidebarTitle":"Chat Completion","href":"/reference/ai-models/create-chat-completion"},{"openapi":"openapi/ai-models/create-response.json POST /api/v1/responses","title":"Create Response","sidebarTitle":"Responses","href":"/reference/ai-models/create-response"}]},{"group":"Sub-API Keys","pages":[{"openapi":"openapi/sub-keys/create-sub-key.json POST /v1/api-keys/sub-keys","title":"Create Sub-API Key","sidebarTitle":"Create Sub-Key","href":"/reference/sub-keys/create-sub-key"},{"openapi":"openapi/sub-keys/list-sub-keys.json GET /v1/api-keys/sub-keys","title":"List Sub-API Keys","sidebarTitle":"List Sub-Keys","href":"/reference/sub-keys/list-sub-keys"},{"openapi":"openapi/sub-keys/update-sub-key.json PATCH /v1/api-keys/sub-keys/{key_id}","title":"Update Sub-API Key","sidebarTitle":"Update Sub-Key","href":"/reference/sub-keys/update-sub-key"},{"openapi":"openapi/sub-keys/revoke-sub-key.json DELETE /v1/api-keys/sub-keys/{key_id}","title":"Revoke Sub-API Key","sidebarTitle":"Revoke Sub-Key","href":"/reference/sub-keys/revoke-sub-key"},{"openapi":"openapi/sub-keys/get-all-keys-usage.json GET /v1/api-keys/sub-keys/usage","title":"Get All Sub-Keys Usage","sidebarTitle":"All Keys Usage","href":"/reference/sub-keys/get-all-keys-usage"},{"openapi":"openapi/sub-keys/get-key-usage.json GET /v1/api-keys/sub-keys/{key_id}/usage","title":"Get Sub-Key Usage","sidebarTitle":"Single Key Usage","href":"/reference/sub-keys/get-key-usage"},{"openapi":"openapi/sub-keys/get-own-usage.json GET /v1/api-keys/sub-keys/me/usage","title":"Get Own Usage (Sub-Key Self-Service)","sidebarTitle":"Self Usage Check","href":"/reference/sub-keys/get-own-usage"}]},{"group":"Getting Started with AI Agents API","pages":[{"sidebarTitle":"Overview","title":"Getting Started with AI Agents API","href":"/reference/ai-agents/getting-started-with-api-agents"},{"openapi":"openapi/ai-agents/get-agents-list.json GET /api/v1/agents","title":"Agents List","href":"/reference/ai-agents/get-agents-list"},{"openapi":"openapi/ai-agents/workflows-schema.json GET /api/v1/workflows/schema","title":"Workflows Schema","href":"/reference/ai-agents/workflows-schema"},{"openapi":"openapi/ai-agents/workflows-run.json POST /api/v1/workflows/run","title":"Workflows Run","href":"/reference/ai-agents/workflows-run"},{"group":"Secret Management","hidden":false,"pages":[{"openapi":"openapi/ai-agents/secret-management-list.json GET /v1/secrets/","title":"Secrets List","href":"/reference/ai-agents/secret-management-list"},{"openapi":"openapi/ai-agents/secret-management-get.json GET /v1/secrets/{secret_id}","title":"Get Secret Details","href":"/reference/ai-agents/secret-management-get"},{"openapi":"openapi/ai-agents/secret-management-post.json POST /v1/secrets/","title":"Create a Secret","href":"/reference/ai-agents/secret-management-post"},{"openapi":"openapi/ai-agents/secret-management-patch.json PATCH /v1/secrets/{secret_id}","title":"Update Secret Details","description":"Updates an existing secret or its associated metadata.","href":"/reference/ai-agents/secret-management-patch"},{"openapi":"openapi/ai-agents/secret-management-delete.json DELETE /v1/secrets/{secret_id}","title":"Delete a Secret","href":"/reference/ai-agents/secret-management-delete"}]}]}]},{"group":"IO Cloud","pages":[{"group":"Getting Started With CaaS API","pages":[{"sidebarTitle":"Overview","title":"Getting Started with CaaS API","description":"The CaaS API lets you programmatically deploy and manage high-performance containerized workloads on io.net’s decentralized GPU network.","href":"/reference/caas/get-started-with-caas-api"},{"openapi":"openapi/caas/get-all-deployments.json GET /enterprise/v1/io-cloud/caas/deployments","title":"Get All Deployments","href":"/reference/caas/get-all-deployments"},{"openapi":"openapi/caas/get-deployment-details.json GET /enterprise/v1/io-cloud/caas/deployment/{deployment_id}","title":"Get Deployment Details","href":"/reference/caas/get-deployment-details"},{"openapi":"openapi/caas/deploy-a-container.json POST /enterprise/v1/io-cloud/caas/deploy","title":"Deploy a Container","href":"/reference/caas/deploy-a-container"},{"openapi":"openapi/caas/list-deployment-containers.json GET /enterprise/v1/io-cloud/caas/deployment/{deployment_id}/containers","title":"List Deployment Containers","href":"/reference/caas/list-deployment-containers"},{"openapi":"openapi/caas/get-hardware-list.json GET /enterprise/v1/io-cloud/caas/hardware","title":"Get Hardware List","href":"/reference/caas/get-hardware-list"},{"openapi":"openapi/caas/get-node-pools.json GET /enterprise/v1/io-cloud/caas/node-pools","title":"Get Private Node Pools","href":"/reference/caas/get-node-pools"},{"openapi":"openapi/caas/price-estimation.json GET /enterprise/v1/io-cloud/caas/price","title":"Deployment Price Check","href":"/reference/caas/price-estimation"},{"openapi":"openapi/caas/container-job-details.json GET /enterprise/v1/io-cloud/caas/deployment/{deployment_id}/containers-jobs/{container_id}","title":"Container Job Details","href":"/reference/caas/container-job-details"},{"openapi":"openapi/caas/container-logs.json GET /enterprise/v1/io-cloud/caas/deployment/{deployment_id}/log/{container_id}","title":"Container Logs","href":"/reference/caas/container-logs"},{"openapi":"openapi/caas/update-deployment-configuration.json PATCH /enterprise/v1/io-cloud/caas/deployment/{deployment_id}","title":"Update Deployment Configuration","href":"/reference/caas/update-deployment-configuration"},{"openapi":"openapi/caas/extend-deployment-duration.json POST /enterprise/v1/io-cloud/caas/deployment/{deployment_id}/extend","title":"Extend Deployment Duration","href":"/reference/caas/extend-deployment-duration"},{"openapi":"openapi/caas/destroy-container.json DELETE /enterprise/v1/io-cloud/caas/deployment/{deployment_id}","title":"Destroy Container","href":"/reference/caas/destroy-container"}]},{"group":"Getting Started With VMaaS API","pages":[{"title":"Getting Started with VMaaS API","sidebarTitle":"Overview","href":"/reference/vmaas/get-started-with-vmaas-api"},{"title":"Cluster Deployment using APIs","href":"/reference/vmaas/example-deploying-using-APIs"},{"openapi":"openapi/vmaas/get-hardware-list.json GET /enterprise/v1/io-cloud/vmaas/hardware","title":"Get Hardware List","sidebarTitle":"Hardware List","href":"/reference/vmaas/get-hardware-list"},{"openapi":"openapi/vmaas/get-all-deployments.json GET /enterprise/v1/io-cloud/vmaas/deployments","title":"Get All Deployments","sidebarTitle":"Deployments List","href":"/reference/vmaas/get-all-deployments"},{"openapi":"openapi/vmaas/get-deployment-details.json GET /enterprise/v1/io-cloud/vmaas/deployment/{deployment_id}","title":"Get Deployment Details","sidebarTitle":"Deployment Details","href":"/reference/vmaas/get-deployment-details"},{"openapi":"openapi/vmaas/get-deployment-vms.json GET /enterprise/v1/io-cloud/vmaas/deployment/{deployment_id}/vms","title":"Get Deployment VMs","sidebarTitle":"Deployment VMs","href":"/reference/vmaas/get-deployment-vms"},{"openapi":"openapi/vmaas/get-vms-jobs-history.json GET /enterprise/v1/io-cloud/vmaas/deployment/{deployment_id}/vms-jobs/{container_id}","title":"Get a VM's Jobs History","sidebarTitle":"VM Jobs History","href":"/reference/vmaas/get-vms-jobs-history"},{"openapi":"openapi/vmaas/get-deployment-price.json GET /enterprise/v1/io-cloud/vmaas/price","title":"Get Deployment Price","sidebarTitle":"Deployment Price","href":"/reference/vmaas/get-deployment-price"},{"openapi":"openapi/vmaas/deploy-vms.json POST /enterprise/v1/io-cloud/vmaas/deploy","title":"Deploy a VM","href":"/reference/vmaas/deploy-vms"},{"openapi":"openapi/vmaas/extend-cluster.json POST /enterprise/v1/io-cloud/vmaas/deployment/{deployment_id}/extend","title":"Extend Cluster","href":"/reference/vmaas/extend-cluster"},{"openapi":"openapi/vmaas/destroy-deployment.json DELETE /enterprise/v1/io-cloud/vmaas/deployment/{deployment_id}","title":"Destroy Deployment","href":"/reference/vmaas/destroy-deployment"}]},{"group":"Billing","pages":[{"openapi":"openapi/io-cloud/get-burn-rate.json GET /enterprise/v1/io-cloud/users/burn-rate","title":"Get Burn Rate","href":"/reference/io-cloud/get-burn-rate"}]}]}]}]},"basePath":"","title":"Delete a Secret - io.net","buildId":"dpl_ATnXPMW25DMPUr9VBw6kL6MfBt6T","deploymentId":"dpl_ATnXPMW25DMPUr9VBw6kL6MfBt6T","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CNqlzjVB.js","utils-BqFiXZ79.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CnR4QBe6.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BY2ZM1OO.js","snippetPresets-x-8ACO8V.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ch-SJE05.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CqqG_0NE.js","shallow-BXrZ2b0C.js","getApiPlaygroundDisplay-n7J_wkjq.js","CodeSnippet-CQsp4vyQ.js","CodeSnippets-BfuHqvZx.js","Page-CTxrMSpo.js","getPastedJson-BjrGIK1i.js","icon-7iLZnVOC.js","MethodPill-TBS1m84e.js","DuplicateIcon-BNMrV4Vs.js","createIcon-C5kCqeU2.js","DynamicMarkdown-Bq09mRwR.js","SectionHeading-G4Bflf5Q.js","axios-vUo_bRtp.js","Markdown-BTUds0aX.js","clsx-6wHzaN2_.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BPypQKlo.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-o6bee4ro.js"]}