Stops a launch in progress or tears down a cluster. Ornn deletes the cluster’s workloads, revokes its access, and sends cleanup to every worker. The cluster stays in state deleting, with teardown stages in progress, while Ornn waits up to five minutes for workers to confirm cleanup; then its record is removed. Workers that never confirm are released anyway and cleaned when they reconnect. Reservation billing continues, and separately provisioned filesystems are not deleted.
Repeating the request while the cluster is deleting returns only its state and does not restart cleanup. Teardown is complete when the cluster is absent from listClusters and getClusterAccess returns 404 cluster_not_found; this operation then returns 404 with an empty body. If the state becomes failed instead, send the teardown again, and contact Ornn if it fails twice. Wait for teardown to finish before creating another cluster.
Stages of the latest launch or teardown. Launch stages are create_plane, prepare_hosts, join_workers, apply_plane, and issue_access. Teardown stages include workers and the control-plane stage (namespace for Kubernetes, stack for Slurm), plus nodes or storage when those steps fail.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ornn","description":"Ornn: The Omnicloud for AI Workloads\nOrnn is an omnicloud for high-performance GPU compute. Reserve capacity, manage your reservations, and connect via VM, Bare Metal, Kubernetes, or Slurm.","colors":{"primary":"#000000","light":"#F3F3F3","dark":"#0B0B0C"},"logo":{"light":"https://mintcdn.com/ornn/kJ0iqH_E0L2Jw6j6/images/ornn-docs-logo-light.svg?fit=max\u0026auto=format\u0026n=kJ0iqH_E0L2Jw6j6\u0026q=85\u0026s=6f5b0c872f8bb7b4b5b6b8ab492dc2a6","dark":"https://mintcdn.com/ornn/kJ0iqH_E0L2Jw6j6/images/ornn-docs-logo-dark.svg?fit=max\u0026auto=format\u0026n=kJ0iqH_E0L2Jw6j6\u0026q=85\u0026s=518cd92bb74cb6eb82ac33e462421918","href":"https://ornn.com"},"favicon":"https://mintcdn.com/ornn/fNQRwmmR9H-yzza5/favicon.png?fit=max\u0026auto=format\u0026n=fNQRwmmR9H-yzza5\u0026q=85\u0026s=ae08364c28579651525833a71bd8ec7c","api":{"examples":{"languages":["curl","python","javascript","php","go","java","ruby"]}},"appearance":{"default":"dark","strict":true},"background":{"color":{"light":"#FFFFFF","dark":"#0B0B0C"}},"navbar":{"links":[{"href":"/changelog","label":"Changelog"}],"primary":{"type":"button","label":"Visit Ornn","href":"https://ornn.com"}},"footer":{"socials":{"x":"https://x.com/OrnnExchange","linkedin":"https://www.linkedin.com/company/ornn"}},"fonts":{"family":"PP Neue Montreal Regular","weight":400,"source":"fonts/PPNeueMontreal-Regular.woff2","format":"woff2"},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","latex":true},"contextual":{"options":["copy","view","assistant","chatgpt","claude","perplexity","grok","aistudio","devin","windsurf","mcp","add-mcp","cursor","vscode","devin-mcp","download-spec"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ornn","hasAudioNarration":false,"actualSubdomain":"ornn","customDomains":["docs.ornn.com"],"gitSource":{"type":"github","owner":"ornn-ai","repo":"fabric","deployBranch":"main","contentDirectory":"docs-site","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af228bd2b97ba9fc64bce19","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"API reference","count":122},{"language":"default","tag":"Guides","count":30},{"language":"default","tag":"Storage","count":17},{"language":"default","tag":"VM and Bare Metal","count":13},{"language":"default","tag":"Private networks","count":12},{"language":"default","tag":"Order books","count":11},{"language":"default","tag":"Billing","count":10},{"language":"default","tag":"Disks","count":10},{"language":"default","tag":"Accessing Compute","count":9},{"language":"default","tag":"Monitoring","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@ornn.com","showHelpButton":true}},"basePath":"","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":"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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","href":"/_mintlify/custom/ornn/0f3bb7ade51d2cb7/style.css"}],"page":{"pagePath":"api-reference/clusters/teardown","slug":"/api-reference/clusters/teardown","pageMetadata":{"title":"Tear down a cluster","openapi":"openapi.yaml POST /v1/orchestrator/controllers/{controller_id}/teardown","description":"Stops a launch in progress or tears down a cluster. Ornn deletes the cluster's workloads, revokes its access, and sends cleanup to every worker. The cluster stays in state deleting, with teardown stages in progress, while Ornn waits up to five minutes for workers to confirm cleanup; then its record is removed. Workers that never confirm are released anyway and cleaned when they reconnect. Reservation billing continues, and separately provisioned filesystems are not deleted.\n\nRepeating the request while the cluster is deleting returns only its state and does not restart cleanup. Teardown is complete when the cluster is absent from listClusters and getClusterAccess returns 404 cluster_not_found; this operation then returns 404 with an empty body. If the state becomes failed instead, send the teardown again, and contact Ornn if it fails twice. Wait for teardown to finish before creating another cluster.","href":"/api-reference/clusters/teardown"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Stops a launch in progress or tears down a cluster. Ornn deletes the cluster’s workloads, revokes its access, and sends cleanup to every worker. The cluster stays in state deleting, with teardown stages in progress, while Ornn waits up to five minutes for workers to confirm cleanup; then its record is removed. Workers that never confirm are released anyway and cleaned when they reconnect. Reservation billing continues, and separately provisioned filesystems are not deleted.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Repeating the request while the cluster is deleting returns only its state and does not restart cleanup. Teardown is complete when the cluster is absent from listClusters and getClusterAccess returns 404 cluster_not_found; this operation then returns 404 with an empty body. If the state becomes failed instead, send the teardown again, and contact Ornn if it fails twice. Wait for teardown to finish before creating another cluster.\"\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/guides/kubernetes-api#7-tear-down-the-cluster-and-confirm`,children:`Tear down the cluster and confirm`}),` for how to verify completion.`]}),`\n`,_jsxs(_components.p,{children:[`CLI equivalent, after `,_jsx(_components.code,{children:`ornn login`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,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:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ornn`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` clusters`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` teardown`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` CLUSTER_ID`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --wait`})]}),`\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":{"title":"Tear down a cluster","openapi":"openapi.yaml POST /v1/orchestrator/controllers/{controller_id}/teardown","description":"Stops a launch in progress or tears down a cluster. Ornn deletes the cluster's workloads, revokes its access, and sends cleanup to every worker. The cluster stays in state deleting, with teardown stages in progress, while Ornn waits up to five minutes for workers to confirm cleanup; then its record is removed. Workers that never confirm are released anyway and cleaned when they reconnect. Reservation billing continues, and separately provisioned filesystems are not deleted.\n\nRepeating the request while the cluster is deleting returns only its state and does not restart cleanup. Teardown is complete when the cluster is absent from listClusters and getClusterAccess returns 404 cluster_not_found; this operation then returns 404 with an empty body. If the state becomes failed instead, send the teardown again, and contact Ornn if it fails twice. Wait for teardown to finish before creating another cluster.","href":"/api-reference/clusters/teardown"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/ornn/51d5a96cc0778150/region-picker.js","/_mintlify/custom/ornn/0f843ad695dae46a/toc-hatch.js","/_mintlify/custom/ornn/38a1cac05e624580/copy-page-label.js"],"openApiReferenceData":{"operation":{"summary":"Tear down a cluster","operationId":"teardownCluster","tags":["Clusters"],"description":"Stops a launch in progress or tears down a cluster. Ornn deletes the cluster's workloads, revokes its access, and sends cleanup to every worker. The cluster stays in state deleting, with teardown stages in progress, while Ornn waits up to five minutes for workers to confirm cleanup; then its record is removed. Workers that never confirm are released anyway and cleaned when they reconnect. Reservation billing continues, and separately provisioned filesystems are not deleted.\n\nRepeating the request while the cluster is deleting returns only its state and does not restart cleanup. Teardown is complete when the cluster is absent from listClusters and getClusterAccess returns 404 cluster_not_found; this operation then returns 404 with an empty body. If the state becomes failed instead, send the teardown again, and contact Ornn if it fails twice. Wait for teardown to finish before creating another cluster.","responses":{"202":"80288e61-61cc-49ce-a3b2-9ab287f5b48f","401":"6b681f22-b8e4-4f41-9a09-07e3776be778","403":"2f68c004-9ce6-440c-a52a-3e98cbf10891","404":"88dc5dd6-62ac-4fd8-af8e-e3049ecdc48a","default":"98bfc3bd-3f5a-4461-a13d-0f0212229739"},"parameters":["b528827c-78f5-4356-b4cc-2f93ab031c3b"],"method":"post","type":"path","servers":["6c9d2719-818c-44a7-9ca6-2edfbdaa6d61"],"security":["eab2b1d2-04d0-434f-b42f-337672534c39"],"path":"/v1/orchestrator/controllers/{controller_id}/teardown","baseUrlOptions":["https://api.ornn.com"],"title":"Tear down a cluster","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","php","go","java","ruby"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"b528827c-78f5-4356-b4cc-2f93ab031c3b":{"name":"controller_id","in":"path","required":true,"description":"Cluster id returned by create or list; not a reservation ID.","schema":{"type":"string","format":"uuid","isRequired":true,"description":"Cluster id returned by create or list; not a reservation ID.","uniqueKey":"","typeLabel":"string\u003cuuid>"},"example":"44444444-4444-4444-8444-444444444444"}},"responses":{"80288e61-61cc-49ce-a3b2-9ab287f5b48f":{"description":"Teardown accepted, or already in progress. Poll for completion. Reservation billing continues.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","state"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"oneOf.0.id","typeLabel":"string\u003cuuid>"},"state":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.state","typeLabel":"string"},"kind":{"type":"string","uniqueKey":"oneOf.0.kind","typeLabel":"string"},"organization_id":{"oneOf":[{"type":"string","format":"uuid","uniqueKey":"oneOf.0.organization_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","uniqueKey":"oneOf.0.organization_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.organization_id","typeLabel":"string\u003cuuid> | null"},"access_mode":{"type":"string","uniqueKey":"oneOf.0.access_mode","typeLabel":"string"},"network_mode":{"type":"string","uniqueKey":"oneOf.0.network_mode","typeLabel":"string"},"endpoint":{"oneOf":[{"type":"string","uniqueKey":"oneOf.0.endpoint.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"oneOf.0.endpoint.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.endpoint","typeLabel":"string | null"},"credential_state":{"type":"string","uniqueKey":"oneOf.0.credential_state","typeLabel":"string"},"namespace":{"oneOf":[{"type":"string","description":"The namespace Ornn configures for your workloads.","uniqueKey":"oneOf.0.namespace.oneOf.0","typeLabel":"string"},{"type":"null","description":"The namespace Ornn configures for your workloads.","uniqueKey":"oneOf.0.namespace.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.namespace","typeLabel":"string | null"},"node_count":{"type":"integer","description":"Workers attached when this response was built; usually 0 right after a launch.","uniqueKey":"oneOf.0.node_count","typeLabel":"integer"},"gpu_count":{"type":"integer","description":"GPUs on the workers counted in node_count; 0 on CPU capacity.","uniqueKey":"oneOf.0.gpu_count","typeLabel":"integer"},"progress":{"oneOf":[{"type":"object","description":"Stages of the latest launch or teardown. Launch stages are create_plane, prepare_hosts, join_workers, apply_plane, and issue_access. Teardown stages include workers and the control-plane stage (namespace for Kubernetes, stack for Slurm), plus nodes or storage when those steps fail.","properties":{"stages":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","description":"Stable stage identifier.","uniqueKey":"oneOf.0.progress.oneOf.0.stages.items.[INDEX].key","typeLabel":"string"},"label":{"type":"string","description":"Display label for the stage.","uniqueKey":"oneOf.0.progress.oneOf.0.stages.items.[INDEX].label","typeLabel":"string"},"status":{"type":"string","enum":["pending","running","completed","failed"],"uniqueKey":"oneOf.0.progress.oneOf.0.stages.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"detail":{"oneOf":[{"type":"string","description":"Failure reason or worker confirmation count, when available.","uniqueKey":"oneOf.0.progress.oneOf.0.stages.items.[INDEX].detail.oneOf.0","typeLabel":"string"},{"type":"null","description":"Failure reason or worker confirmation count, when available.","uniqueKey":"oneOf.0.progress.oneOf.0.stages.items.[INDEX].detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.progress.oneOf.0.stages.items.[INDEX].detail","typeLabel":"string | null"}},"uniqueKey":"oneOf.0.progress.oneOf.0.stages.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.0.progress.oneOf.0.stages","typeLabel":"object[]"}},"uniqueKey":"oneOf.0.progress.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"oneOf.0.progress.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.progress","typeLabel":"object | null"},"created_at":{"type":"string","format":"date-time","uniqueKey":"oneOf.0.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","uniqueKey":"oneOf.0.updated_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["state"],"properties":{"state":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.state","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"accepted":{"title":"accepted","value":{"id":"44444444-4444-4444-8444-444444444444","kind":"kubernetes","organization_id":"22222222-2222-4222-8222-222222222222","access_mode":"kubernetes","state":"deleting","network_mode":"public","endpoint":null,"credential_state":"pending","namespace":"k8s-22222222-2222-4222-8222-222222222222","node_count":1,"gpu_count":8,"progress":{"stages":[{"key":"workers","label":"Release the workers","status":"running","detail":"0 of 1 confirmed"},{"key":"namespace","label":"Delete the cluster namespace","status":"running","detail":null}]},"created_at":"2026-10-14T12:00:00Z","updated_at":"2026-10-14T13:00:00Z"}},"repeated":{"title":"repeated","value":{"state":"deleting"}}},"exampleType":"examples"}},"exampleType":"examples"},"6b681f22-b8e4-4f41-9a09-07e3776be778":{"description":"The credential is missing, invalid, or revoked. Check the HTTP status before parsing the body.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"detail.oneOf.1.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"detail.oneOf.1.message","typeLabel":"string"}},"uniqueKey":"detail.oneOf.1","typeLabel":"object"}],"uniqueKey":"detail","typeLabel":"string | object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"\u003cstring>","detail":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"2f68c004-9ce6-440c-a52a-3e98cbf10891":{"description":"The credential lacks access to this operation, or the Reserve operation requires approval. An API key does not bypass these checks.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"detail.oneOf.1.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"detail.oneOf.1.message","typeLabel":"string"}},"uniqueKey":"detail.oneOf.1","typeLabel":"object"}],"uniqueKey":"detail","typeLabel":"string | object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"\u003cstring>","detail":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"88dc5dd6-62ac-4fd8-af8e-e3049ecdc48a":{"description":"The cluster does not exist or is not visible to your organization, including after its teardown finished. This response has no body.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"98bfc3bd-3f5a-4461-a13d-0f0212229739":{"description":"Unsuccessful request. Check HTTP status first. Errors may have detail.code/detail.message, a string detail and optional top-level code, or an empty/non-JSON body. 401: invalid credential; 403: access or Reserve approval required; 404: not visible or credentials not ready; 409: lifecycle conflict; 429: back off; 5xx: service failure. Inspect current state before retrying mutations.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"detail.oneOf.1.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"detail.oneOf.1.message","typeLabel":"string"}},"uniqueKey":"detail.oneOf.1","typeLabel":"object"}],"uniqueKey":"detail","typeLabel":"string | object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"\u003cstring>","detail":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"eab2b1d2-04d0-434f-b42f-337672534c39":{"OrnnApiKey":{"type":"http","scheme":"bearer","bearerFormat":"ornn_sk_...","description":"Create an organization API key in Account Settings > Developer. Do not send this key to the Kubernetes API server.","scopes":[],"schemeName":"OrnnApiKey"}}},"servers":{"6c9d2719-818c-44a7-9ca6-2edfbdaa6d61":{"url":"https://api.ornn.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"ornn_sk_...","description":"Create an organization API key in Account Settings > Developer. Do not send this key to the Kubernetes API server.","scopes":[],"schemeName":"OrnnApiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Create an organization API key in Account Settings > Developer. Do not send this key to the Kubernetes API server.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"OrnnApiKey","name":"Authorization"}],"title":"OrnnApiKey"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"ornn","siteName":"Ornn","title":"Tear down a cluster - Ornn","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-05T00:36:21.718Z","originalFileLocation":"api-reference/clusters/teardown.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";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=\"Stops a launch in progress or tears down a cluster. Ornn deletes the cluster\u0026#x27;s workloads, revokes its access, and sends cleanup to every worker. The cluster stays in state deleting, with teardown stages in progress, while Ornn waits up to five minutes for workers to confirm cleanup; then its record is removed. Workers that never confirm are released anyway and cleaned when they reconnect. Reservation billing continues, and separately provisioned filesystems are not deleted. Repeating the request while the cluster is deleting returns only its state and does not restart cleanup. Teardown is complete when the cluster is absent from listClusters and getClusterAccess returns 404 cluster_not_found; this operation then returns 404 with an empty body. If the state becomes failed instead, send the teardown again, and contact Ornn if it fails twice. Wait for teardown to finish before creating another cluster.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ornn\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ornn/xSbMvd8knxlcr1Zk/_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/ornn/xSbMvd8knxlcr1Zk/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ornn/xSbMvd8knxlcr1Zk/_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/ornn/xSbMvd8knxlcr1Zk/_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/ornn/xSbMvd8knxlcr1Zk/_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/ornn/xSbMvd8knxlcr1Zk/_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/ornn/xSbMvd8knxlcr1Zk/_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/ornn/xSbMvd8knxlcr1Zk/_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/ornn/xSbMvd8knxlcr1Zk/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Tear down a cluster - Ornn\">\u003cmeta data-mint-head property=\"og:description\" content=\"Stops a launch in progress or tears down a cluster. Ornn deletes the cluster\u0026#x27;s workloads, revokes its access, and sends cleanup to every worker. The cluster stays in state deleting, with teardown stages in progress, while Ornn waits up to five minutes for workers to confirm cleanup; then its record is removed. Workers that never confirm are released anyway and cleaned when they reconnect. Reservation billing continues, and separately provisioned filesystems are not deleted. Repeating the request while the cluster is deleting returns only its state and does not restart cleanup. Teardown is complete when the cluster is absent from listClusters and getClusterAccess returns 404 cluster_not_found; this operation then returns 404 with an empty body. If the state becomes failed instead, send the teardown again, and contact Ornn if it fails twice. Wait for teardown to finish before creating another cluster.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ornn\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ornn.com/api-reference/clusters/teardown\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ornn.mintlify.site/_mintlify/api/og/v2?division=Clusters\u0026amp;title=Tear+down+a+cluster\u0026amp;description=Stops+a+launch+in+progress+or+tears+down+a+cluster.+Ornn+deletes+the+cluster%27s+workloads%2C+revokes+its+access%2C+and+sends+cleanup+to+every+worker.+The+cluster+sta\u0026amp;theme=3cb4facbf0c28da5810d277d\u0026amp;signature=25adfe1bfc0ed09a6e4719a5e753adfcf0d6983db4ac4870073e016ee32479e4\">\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=\"Tear down a cluster - Ornn\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Stops a launch in progress or tears down a cluster. Ornn deletes the cluster\u0026#x27;s workloads, revokes its access, and sends cleanup to every worker. The cluster stays in state deleting, with teardown stages in progress, while Ornn waits up to five minutes for workers to confirm cleanup; then its record is removed. Workers that never confirm are released anyway and cleaned when they reconnect. Reservation billing continues, and separately provisioned filesystems are not deleted. Repeating the request while the cluster is deleting returns only its state and does not restart cleanup. Teardown is complete when the cluster is absent from listClusters and getClusterAccess returns 404 cluster_not_found; this operation then returns 404 with an empty body. If the state becomes failed instead, send the teardown again, and contact Ornn if it fails twice. Wait for teardown to finish before creating another cluster.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ornn.mintlify.site/_mintlify/api/og/v2?division=Clusters\u0026amp;title=Tear+down+a+cluster\u0026amp;description=Stops+a+launch+in+progress+or+tears+down+a+cluster.+Ornn+deletes+the+cluster%27s+workloads%2C+revokes+its+access%2C+and+sends+cleanup+to+every+worker.+The+cluster+sta\u0026amp;theme=3cb4facbf0c28da5810d277d\u0026amp;signature=25adfe1bfc0ed09a6e4719a5e753adfcf0d6983db4ac4870073e016ee32479e4\">\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/ornn/xSbMvd8knxlcr1Zk/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ornn\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ornn.com/api-reference/clusters/teardown\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/clusters/teardown.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ornn.com/#organization\",\"name\":\"Ornn\",\"url\":\"https://docs.ornn.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ornn/kJ0iqH_E0L2Jw6j6/images/ornn-docs-logo-light.svg?fit=max\u0026auto=format\u0026n=kJ0iqH_E0L2Jw6j6\u0026q=85\u0026s=6f5b0c872f8bb7b4b5b6b8ab492dc2a6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ornn.com#website\",\"name\":\"Ornn\",\"url\":\"https://docs.ornn.com\",\"publisher\":{\"@id\":\"https://docs.ornn.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ornn.com/api-reference/clusters/teardown#webpage\",\"url\":\"https://docs.ornn.com/api-reference/clusters/teardown\",\"name\":\"Tear down a cluster\",\"description\":\"Stops a launch in progress or tears down a cluster. Ornn deletes the cluster's workloads, revokes its access, and sends cleanup to every worker. The cluster stays in state deleting, with teardown stages in progress, while Ornn waits up to five minutes for workers to confirm cleanup; then its record is removed. Workers that never confirm are released anyway and cleaned when they reconnect. Reservation billing continues, and separately provisioned filesystems are not deleted. Repeating the request while the cluster is deleting returns only its state and does not restart cleanup. Teardown is complete when the cluster is absent from listClusters and getClusterAccess returns 404 cluster_not_found; this operation then returns 404 with an empty body. If the state becomes failed instead, send the teardown again, and contact Ornn if it fails twice. Wait for teardown to finish before creating another cluster.\",\"dateModified\":\"2026-11-05T00:36:21.718Z\",\"isPartOf\":{\"@id\":\"https://docs.ornn.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ornn.com/api-reference/clusters/teardown#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ornn.com/api-reference/clusters/teardown#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Clusters\",\"item\":\"https://docs.ornn.com/api-reference/clusters/create\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tear down a cluster\",\"item\":\"https://docs.ornn.com/api-reference/clusters/teardown\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.ornn.com/api-reference/clusters/teardown#apireference\",\"headline\":\"Tear down a cluster\",\"name\":\"Tear down a cluster\",\"description\":\"Stops a launch in progress or tears down a cluster. Ornn deletes the cluster's workloads, revokes its access, and sends cleanup to every worker. The cluster stays in state deleting, with teardown stages in progress, while Ornn waits up to five minutes for workers to confirm cleanup; then its record is removed. Workers that never confirm are released anyway and cleaned when they reconnect. Reservation billing continues, and separately provisioned filesystems are not deleted. Repeating the request while the cluster is deleting returns only its state and does not restart cleanup. Teardown is complete when the cluster is absent from listClusters and getClusterAccess returns 404 cluster_not_found; this operation then returns 404 with an empty body. If the state becomes failed instead, send the teardown again, and contact Ornn if it fails twice. Wait for teardown to finish before creating another cluster.\",\"url\":\"https://docs.ornn.com/api-reference/clusters/teardown\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ornn.com/api-reference/clusters/teardown#webpage\"},\"dateModified\":\"2026-11-05T00:36:21.718Z\",\"publisher\":{\"@id\":\"https://docs.ornn.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ornn.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ornn\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Ornn","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"API reference","groups":[{"group":"Start here","pages":[{"title":"Integrate with the Ornn REST API","sidebarTitle":"Overview","href":"/api-reference/overview"},{"title":"Check API authentication","openapi":"openapi.yaml GET /v1/auth/session","href":"/api-reference/session"}]},{"group":"Reserved capacity","pages":[{"title":"List reservations","openapi":"openapi.yaml GET /commerce/reservations","href":"/api-reference/reservations/list"},{"title":"Get a reservation","openapi":"openapi.yaml GET /commerce/reservations/{reservationId}","href":"/api-reference/reservations/get"},{"title":"List reserved nodes","openapi":"openapi.yaml GET /v1/orchestrator/nodes","href":"/api-reference/nodes/list"}]},{"group":"VM and Bare Metal","pages":[{"title":"Choose a VM disk","openapi":"openapi.yaml PUT /commerce/reservations/{reservationId}/disk","href":"/api-reference/virtual-machines/set-image"},{"title":"Activate a reservation","openapi":"openapi.yaml POST /commerce/reservations/{reservationId}/activate","href":"/api-reference/virtual-machines/activate"},{"title":"Launch VM or Bare Metal access","openapi":"openapi.yaml POST /v1/orchestrator/nodes/reservations/{reservation_id}/launch","href":"/api-reference/virtual-machines/launch"},{"title":"List a reservation's VMs","openapi":"openapi.yaml GET /v1/orchestrator/reservations/{reservation_id}/virtual-machines","href":"/api-reference/virtual-machines/list"},{"title":"Reboot a VM","openapi":"openapi.yaml POST /v1/orchestrator/nodes/{node_id}/virtual-machines/{vm_id}/reboot","href":"/api-reference/virtual-machines/reboot"},{"title":"Reimage a VM","openapi":"openapi.yaml POST /v1/orchestrator/nodes/{node_id}/virtual-machines/{vm_id}/reimage","href":"/api-reference/virtual-machines/reimage"},{"title":"List a VM's ports","openapi":"openapi.yaml GET /v1/orchestrator/nodes/{node_id}/virtual-machines/{vm_id}/ports","href":"/api-reference/virtual-machines/list-ports"},{"title":"Open a VM port","openapi":"openapi.yaml POST /v1/orchestrator/nodes/{node_id}/virtual-machines/{vm_id}/ports","href":"/api-reference/virtual-machines/open-port"},{"title":"Close a VM port","openapi":"openapi.yaml DELETE /v1/orchestrator/nodes/{node_id}/virtual-machines/{vm_id}/ports/{port_id}","href":"/api-reference/virtual-machines/close-port"},{"title":"Get a reserved node","openapi":"openapi.yaml GET /v1/orchestrator/nodes/{node_id}","href":"/api-reference/bare-metal/get-node"},{"title":"Reboot or hard reset a Bare Metal host","openapi":"openapi.yaml POST /v1/orchestrator/nodes/{node_id}/reboot","href":"/api-reference/bare-metal/reboot"},{"title":"Switch access mode or network","openapi":"openapi.yaml POST /v1/orchestrator/nodes/reservations/{reservation_id}/switch-access","href":"/api-reference/virtual-machines/switch-access"},{"title":"Stop VMs or a reservation","openapi":"openapi.yaml DELETE /commerce/reservations/{reservationId}","href":"/api-reference/virtual-machines/stop"}]},{"group":"Disks","pages":[{"title":"List disks","openapi":"openapi.yaml GET /v1/orchestrator/disks","href":"/api-reference/disks/list"},{"title":"Get a disk","openapi":"openapi.yaml GET /v1/orchestrator/disks/{disk_id}","href":"/api-reference/disks/get"},{"title":"Create a disk","openapi":"openapi.yaml POST /v1/orchestrator/disks","href":"/api-reference/disks/create"},{"title":"Start a disk upload","openapi":"openapi.yaml POST /v1/orchestrator/disks/uploads","href":"/api-reference/disks/upload-start"},{"title":"Upload disk bytes","openapi":"openapi.yaml POST /v1/orchestrator/disks/objects","href":"/api-reference/disks/upload-bytes"},{"title":"Complete a disk upload","openapi":"openapi.yaml POST /v1/orchestrator/disks/uploads/{disk_id}/complete","href":"/api-reference/disks/upload-complete"},{"title":"Import a disk from a URL","openapi":"openapi.yaml POST /v1/orchestrator/disks/imports","href":"/api-reference/disks/import"},{"title":"Delete a disk","openapi":"openapi.yaml DELETE /v1/orchestrator/disks/{disk_id}","href":"/api-reference/disks/delete"},{"title":"List base images","openapi":"openapi.yaml GET /v1/orchestrator/catalog/images","href":"/api-reference/disks/list-images"},{"title":"List disk software","openapi":"openapi.yaml GET /v1/orchestrator/catalog/software","href":"/api-reference/disks/list-software"}]},{"group":"Clusters","pages":[{"title":"Create a cluster","openapi":"openapi.yaml POST /v1/orchestrator/controllers","href":"/api-reference/clusters/create"},{"title":"List clusters and workers","openapi":"openapi.yaml GET /v1/orchestrator/controllers","href":"/api-reference/clusters/list"},{"title":"Get cluster access","openapi":"openapi.yaml GET /v1/orchestrator/controllers/{controller_id}/access","description":"Returns the issued access for an owned cluster. A Kubernetes cluster returns a kubeconfig, its API server endpoint, and the namespace Ornn configured for your workloads. A Slurm cluster returns its SSH login details. While a launch is still running, 404 kubernetes_credentials_not_ready or slurm_credentials_not_ready means access has not been issued yet; keep polling listClusters. 404 cluster_not_found means the cluster does not exist or is not visible to your organization, including after its teardown finishes. Access stays readable while a teardown is in progress.\n\nThe kubeconfig token is issued for seven days and grants cluster-admin. Ornn issues a new one about two days before the stored token expires, and expires_at reports the stored token's expiry. Read this endpoint again to get the current kubeconfig. An earlier download keeps working until its own token expires. The Ornn API key is not a Kubernetes credential.","href":"/api-reference/clusters/access"},{"title":"Tear down a cluster","openapi":"openapi.yaml POST /v1/orchestrator/controllers/{controller_id}/teardown","href":"/api-reference/clusters/teardown"}]},{"group":"Workers","pages":[{"title":"Add a physical worker","openapi":"openapi.yaml POST /v1/orchestrator/controllers/{controller_id}/nodes/{node_id}","description":"Adds one host to an owned cluster that is not failed or being torn down. The host must be in bare-metal status, not in another cluster, and on an active reservation your organization owns; it can come from a different reservation than the one the cluster launched on. A host in VM access mode or serving VMs is refused with cluster_host_runs_virtual_machines; add its VMs through the VM worker operation instead.\n\nA new host normally returns state cleaning. Ornn first prepares the host - running processes are stopped and the tenant home directory is wiped - and the host then appears in the cluster's nodes in listClusters with state joining, then ready. Repeating the request is safe. It returns cleaning while preparation is pending, or the current membership state once the host is a member.\n\nFor Kubernetes, adding a worker does not raise the GPU quota of the namespace Ornn configured, which is sized when the cluster first becomes active. A host from another reservation is labeled and tainted with the reservation the cluster launched on, so pods in that namespace schedule on it. Verify Node readiness, allocatable GPUs, and the namespace quota through the Kubernetes API before scheduling more work.","href":"/api-reference/clusters/add-node"},{"title":"Remove a physical worker","openapi":"openapi.yaml DELETE /v1/orchestrator/controllers/{controller_id}/nodes/{node_id}","href":"/api-reference/clusters/remove-node"},{"title":"Add a VM worker","openapi":"openapi.yaml POST /v1/orchestrator/controllers/{controller_id}/virtual-machines/{virtual_machine_id}","href":"/api-reference/clusters/add-vm"},{"title":"Remove a VM worker","openapi":"openapi.yaml DELETE /v1/orchestrator/controllers/{controller_id}/virtual-machines/{virtual_machine_id}","href":"/api-reference/clusters/remove-vm"}]},{"group":"SSH keys","pages":[{"title":"List organization SSH keys","openapi":"openapi.yaml GET /v1/organizations/{organization_id}/ssh-keys","href":"/api-reference/ssh-keys/list"},{"title":"Add an organization SSH key","openapi":"openapi.yaml POST /v1/organizations/{organization_id}/ssh-keys","href":"/api-reference/ssh-keys/create"},{"title":"Revoke an organization SSH key","openapi":"openapi.yaml DELETE /v1/organizations/{organization_id}/ssh-keys/{key_id}","href":"/api-reference/ssh-keys/revoke"},{"title":"List a reservation's SSH keys","openapi":"openapi.yaml GET /v1/orchestrator/nodes/reservations/{reservation_id}/ssh-keys","href":"/api-reference/ssh-keys/reservation-list"},{"title":"Assign an SSH key to a reservation","openapi":"openapi.yaml POST /v1/orchestrator/nodes/reservations/{reservation_id}/ssh-keys","href":"/api-reference/ssh-keys/reservation-assign"},{"title":"Unassign an SSH key from a reservation","openapi":"openapi.yaml DELETE /v1/orchestrator/nodes/reservations/{reservation_id}/ssh-keys/{key_id}","href":"/api-reference/ssh-keys/reservation-unassign"},{"title":"Push SSH keys to a machine","openapi":"openapi.yaml POST /v1/orchestrator/nodes/{node_id}/push-keys","href":"/api-reference/ssh-keys/push"}]},{"group":"Storage","pages":[{"title":"List volumes","openapi":"openapi.yaml GET /v1/orchestrator/drives","href":"/api-reference/storage/list"},{"title":"Create a volume","openapi":"openapi.yaml POST /v1/orchestrator/drives","href":"/api-reference/storage/create"},{"title":"Get a volume","openapi":"openapi.yaml GET /v1/orchestrator/drives/{drive_id}","href":"/api-reference/storage/get"},{"title":"Attach or detach a volume","openapi":"openapi.yaml PATCH /v1/orchestrator/drives/{drive_id}","href":"/api-reference/storage/attach"},{"title":"Delete a volume","openapi":"openapi.yaml DELETE /v1/orchestrator/drives/{drive_id}","href":"/api-reference/storage/delete"},{"title":"List volume files","openapi":"openapi.yaml GET /v1/orchestrator/drives/{drive_id}/contents","href":"/api-reference/storage/files/list"},{"title":"Upload a small file","openapi":"openapi.yaml PUT /v1/orchestrator/drives/{drive_id}/files/{file_path}","href":"/api-reference/storage/files/upload"},{"title":"Start a staged upload","openapi":"openapi.yaml POST /v1/orchestrator/drives/{drive_id}/uploads","href":"/api-reference/storage/files/upload-start"},{"title":"Complete a staged upload","openapi":"openapi.yaml POST /v1/orchestrator/drives/{drive_id}/uploads/{upload_id}","href":"/api-reference/storage/files/upload-complete"},{"title":"Cancel a staged upload","openapi":"openapi.yaml DELETE /v1/orchestrator/drives/{drive_id}/uploads/{upload_id}","href":"/api-reference/storage/files/upload-cancel"},{"title":"Download a file","openapi":"openapi.yaml GET /v1/orchestrator/drives/{drive_id}/files/{file_path}","href":"/api-reference/storage/files/download"},{"title":"Download a volume as a ZIP archive","openapi":"openapi.yaml GET /v1/orchestrator/drives/{drive_id}/archive","href":"/api-reference/storage/files/archive"},{"title":"Delete a file","openapi":"openapi.yaml DELETE /v1/orchestrator/drives/{drive_id}/files/{file_path}","href":"/api-reference/storage/files/delete"},{"title":"Delete a folder","openapi":"openapi.yaml DELETE /v1/orchestrator/drives/{drive_id}/folders/{folder_path}","href":"/api-reference/storage/files/delete-folder"},{"title":"Delete all volume files","openapi":"openapi.yaml DELETE /v1/orchestrator/drives/{drive_id}/contents","href":"/api-reference/storage/files/clear"}]},{"group":"GitHub repositories","pages":[{"title":"List GitHub connections","openapi":"openapi.yaml GET /v1/orchestrator/github/connections","href":"/api-reference/storage/github/connections"},{"title":"List GitHub repositories","openapi":"openapi.yaml GET /v1/orchestrator/github/connections/{connection_id}/repositories","href":"/api-reference/storage/github/repositories"},{"title":"List repository branches","openapi":"openapi.yaml GET /v1/orchestrator/github/connections/{connection_id}/repositories/{repository_id}/branches","href":"/api-reference/storage/github/branches"},{"title":"Pull a repository into a volume","openapi":"openapi.yaml POST /v1/orchestrator/drives/{drive_id}/github","href":"/api-reference/storage/github/pull"},{"title":"Sync a repository","openapi":"openapi.yaml POST /v1/orchestrator/drives/{drive_id}/github/{folder}/sync","href":"/api-reference/storage/github/sync"},{"title":"Disconnect a GitHub account","openapi":"openapi.yaml DELETE /v1/orchestrator/github/connections/{connection_id}","href":"/api-reference/storage/github/disconnect"}]},{"group":"Private networks","pages":[{"title":"Private networks and WireGuard","sidebarTitle":"Overview","href":"/api-reference/networks/overview"},{"title":"List private networks","openapi":"openapi.yaml GET /v1/orchestrator/networks","href":"/api-reference/networks/list"},{"title":"Create a private network","openapi":"openapi.yaml POST /v1/orchestrator/networks","href":"/api-reference/networks/create"},{"title":"Get a private network","openapi":"openapi.yaml GET /v1/orchestrator/networks/{network_id}","href":"/api-reference/networks/get"},{"title":"Rename a private network","openapi":"openapi.yaml PATCH /v1/orchestrator/networks/{network_id}","href":"/api-reference/networks/rename"},{"title":"Delete a private network","openapi":"openapi.yaml DELETE /v1/orchestrator/networks/{network_id}","href":"/api-reference/networks/delete"},{"title":"List default-network WireGuard configs","openapi":"openapi.yaml GET /v1/orchestrator/networks/shared/peers","href":"/api-reference/networks/wireguard/default-list"},{"title":"Add a default-network WireGuard config","openapi":"openapi.yaml POST /v1/orchestrator/networks/shared/peers","href":"/api-reference/networks/wireguard/default-create"},{"title":"Remove a default-network WireGuard config","openapi":"openapi.yaml DELETE /v1/orchestrator/networks/shared/peers/{peer_id}","href":"/api-reference/networks/wireguard/default-delete"},{"title":"List network WireGuard configs","openapi":"openapi.yaml GET /v1/orchestrator/networks/{network_id}/peers","href":"/api-reference/networks/wireguard/list"},{"title":"Add a network WireGuard config","openapi":"openapi.yaml POST /v1/orchestrator/networks/{network_id}/peers","href":"/api-reference/networks/wireguard/create"},{"title":"Remove a network WireGuard config","openapi":"openapi.yaml DELETE /v1/orchestrator/networks/{network_id}/peers/{peer_id}","href":"/api-reference/networks/wireguard/delete"}]},{"group":"Monitoring","pages":[{"title":"Read machine metrics and console logs","sidebarTitle":"Overview","href":"/api-reference/monitoring/overview"},{"title":"Get latest node telemetry","openapi":"openapi.yaml GET /v1/observability/nodes/{node_id}/telemetry/latest","href":"/api-reference/monitoring/node-telemetry-latest"},{"title":"Query node telemetry history","openapi":"openapi.yaml GET /v1/observability/nodes/{node_id}/telemetry/query","href":"/api-reference/monitoring/node-telemetry-query"},{"title":"Get latest VM telemetry","openapi":"openapi.yaml GET /v1/observability/virtual-machines/{virtual_machine_id}/telemetry/latest","href":"/api-reference/monitoring/vm-telemetry-latest"},{"title":"Query VM telemetry history","openapi":"openapi.yaml GET /v1/observability/virtual-machines/{virtual_machine_id}/telemetry/query","href":"/api-reference/monitoring/vm-telemetry-query"},{"title":"Get latest telemetry for many machines","openapi":"openapi.yaml POST /v1/observability/nodes/telemetry/latest","href":"/api-reference/monitoring/telemetry-batch"},{"title":"Query node console logs","openapi":"openapi.yaml GET /v1/observability/nodes/{node_id}/logs/{stream}/query","href":"/api-reference/monitoring/node-logs"},{"title":"Query VM console logs","openapi":"openapi.yaml GET /v1/observability/virtual-machines/{virtual_machine_id}/logs/{stream}/query","href":"/api-reference/monitoring/vm-logs"}]},{"group":"Reserve","pages":[{"title":"List capacity listings","openapi":"openapi.yaml GET /commerce/v2/listings","href":"/api-reference/reserve/list-listings"},{"title":"Get a capacity listing","openapi":"openapi.yaml GET /commerce/v2/listings/{listingId}","href":"/api-reference/reserve/get-listing"},{"title":"List a listing's terms","openapi":"openapi.yaml GET /commerce/v2/listings/{listingId}/terms","href":"/api-reference/reserve/list-terms"},{"title":"Post a Reserve offer","openapi":"openapi.yaml POST /v1/markets/offers","href":"/api-reference/reserve/post-offer"},{"title":"List offers","openapi":"openapi.yaml GET /v1/markets/offers","href":"/api-reference/reserve/list-my-offers"},{"title":"Cancel an offer","openapi":"openapi.yaml DELETE /v1/markets/offers/{offerId}","href":"/api-reference/reserve/cancel-offer"},{"title":"Accept an offer on your listing","openapi":"openapi.yaml POST /v1/markets/offers/{offerId}/accept","href":"/api-reference/reserve/accept-offer"}]},{"group":"Market","pages":[{"title":"Get a listing's free capacity","openapi":"openapi.yaml GET /v1/markets/listings/{listingId}/availability","href":"/api-reference/market/availability"},{"title":"Buy Market windows","openapi":"openapi.yaml POST /v1/markets/bookings","href":"/api-reference/market/buy"},{"title":"List your bookings","openapi":"openapi.yaml GET /v1/markets/bookings","href":"/api-reference/market/list-bookings"},{"title":"Cancel a booking","openapi":"openapi.yaml DELETE /v1/markets/bookings/{bookingId}","href":"/api-reference/market/cancel-booking"}]},{"group":"Order books","pages":[{"title":"List order books","openapi":"openapi.yaml GET /v1/markets/books","href":"/api-reference/order-books/list-books"},{"title":"Get order book depth","openapi":"openapi.yaml GET /v1/markets/books/{gpuSlug}","href":"/api-reference/order-books/get-book"},{"title":"List recent trades","openapi":"openapi.yaml GET /v1/markets/books/{gpuSlug}/trades","href":"/api-reference/order-books/list-trades"},{"title":"Quote a bid","openapi":"openapi.yaml GET /v1/markets/books/{gpuSlug}/quote","href":"/api-reference/order-books/quote"},{"title":"Place a bid","openapi":"openapi.yaml POST /v1/markets/orders","href":"/api-reference/order-books/place-bid"},{"title":"List your orders","openapi":"openapi.yaml GET /v1/markets/orders","href":"/api-reference/order-books/list-orders"},{"title":"Get an order","openapi":"openapi.yaml GET /v1/markets/orders/{orderId}","href":"/api-reference/order-books/get-order"},{"title":"Cancel a bid","openapi":"openapi.yaml DELETE /v1/markets/orders/{orderId}","href":"/api-reference/order-books/cancel-order"},{"title":"List your fills","openapi":"openapi.yaml GET /v1/markets/fills","href":"/api-reference/order-books/list-fills"},{"title":"Get a fill","openapi":"openapi.yaml GET /v1/markets/fills/{fillId}","href":"/api-reference/order-books/get-fill"},{"title":"End a fill","openapi":"openapi.yaml DELETE /commerce/reservations/{reservationId}","href":"/api-reference/order-books/end-fill"}]},{"group":"Relist","pages":[{"title":"Relist capacity from a reservation","openapi":"openapi.yaml POST /commerce/reservations/{reservationId}/relist","href":"/api-reference/relist/create"},{"title":"Update your listing","openapi":"openapi.yaml PATCH /commerce/v2/listings/{listingId}","href":"/api-reference/relist/update-listing"},{"title":"Delist your listing","openapi":"openapi.yaml POST /commerce/v2/listings/{listingId}/delist","href":"/api-reference/relist/delist"},{"title":"Add a term to your listing","openapi":"openapi.yaml POST /commerce/v2/listings/{listingId}/terms","href":"/api-reference/relist/add-term"},{"title":"Delete a term from your listing","openapi":"openapi.yaml DELETE /commerce/v2/listings/{listingId}/terms/{listingTermsId}","href":"/api-reference/relist/delete-term"},{"title":"List your listing's nodes","openapi":"openapi.yaml GET /commerce/v2/listings/{listingId}/nodes","href":"/api-reference/relist/list-nodes"}]},{"group":"Billing","pages":[{"title":"List invoices","openapi":"openapi.yaml GET /commerce/invoices","href":"/api-reference/billing/invoices-list"},{"title":"Get an invoice","openapi":"openapi.yaml GET /commerce/invoices/{invoiceId}","href":"/api-reference/billing/invoice-get"},{"title":"List a reservation's invoices","openapi":"openapi.yaml GET /commerce/reservations/{reservationId}/invoices","href":"/api-reference/billing/reservation-invoices"},{"title":"Get billing summary","openapi":"openapi.yaml GET /commerce/billing/summary","href":"/api-reference/billing/summary"},{"title":"Get usage cost","openapi":"openapi.yaml GET /commerce/billing/showback","href":"/api-reference/billing/usage"},{"title":"Get supplied GPU-hours","openapi":"openapi.yaml GET /commerce/reservations/usage","href":"/api-reference/billing/reservation-usage"},{"title":"Get billing contact","openapi":"openapi.yaml GET /commerce/billing/contact","href":"/api-reference/billing/contact"},{"title":"Check for a saved card","openapi":"openapi.yaml GET /commerce/billing/payment-method","href":"/api-reference/billing/payment-method"},{"title":"List account balances","openapi":"openapi.yaml GET /v1/ledger/accounts","href":"/api-reference/billing/credits"},{"title":"List account transactions","openapi":"openapi.yaml GET /v1/ledger/transactions","href":"/api-reference/billing/transactions"}]}]}]},"basePath":"","title":"Tear down a cluster - Ornn","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}