Starts SSH access on an owned VM or Bare Metal reservation. If the reservation already has machines (for example after activation), launch sends the selected SSH keys to them and returns 202 with the current nodes. Otherwise launch selects nodes for the reservation, starts provisioning, and returns 201. Either response is acceptance, not readiness: poll the reservation’s VMs or the node until SSH is ready. Repeating launch after machines exist does not reprovision them; it sends the keys again. ssh_key_ids adds keys to the reservation’s saved list. Without it, launch uses the saved list, including an empty list. With no earlier selection, launch saves every active SSH key in your organization. There is no VM size option: each VM receives its reserved GPUs and a matching share of the host’s vCPUs, memory, and local disk, with at most 3 TiB of RAM on compatible hosts. Launch does not attach storage volumes. Use Kubernetes or Slurm cluster routes for those access modes.
CLI equivalent: ornn launch <reservation-id> --mode vm --key <key-id> (or --mode bare-metal). Add --wait to wait for SSH. Walkthroughs: VM and Bare Metal.
VM only. Overrides the reservation's saved disk for VMs this request creates. When omitted, the saved disk is used; a VM launch with no disk available fails with disk_required. Must be omitted for Bare Metal.
Private networking only. An existing private network in your organization. Omit it to use the organization's shared network. This does not create a network.
How many of the reservation's nodes to provision when launch starts provisioning. Defaults to every reserved node and cannot exceed it. Ignored when the reservation already has machines.
Active organization SSH key IDs to add to the reservation's saved selection. Omit to use the saved list, including an empty list. With no earlier selection, launch saves every active organization key.
{"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":"6af2366f628bd61a64bfcc64","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/virtual-machines/launch","slug":"/api-reference/virtual-machines/launch","pageMetadata":{"title":"Launch VM or Bare Metal access","openapi":"openapi.yaml POST /v1/orchestrator/nodes/reservations/{reservation_id}/launch","description":"Starts SSH access on an owned VM or Bare Metal reservation. If the reservation already has machines (for example after activation), launch sends the selected SSH keys to them and returns 202 with the current nodes. Otherwise launch selects nodes for the reservation, starts provisioning, and returns 201. Either response is acceptance, not readiness: poll the reservation's VMs or the node until SSH is ready. Repeating launch after machines exist does not reprovision them; it sends the keys again. ssh_key_ids adds keys to the reservation's saved list. Without it, launch uses the saved list, including an empty list. With no earlier selection, launch saves every active SSH key in your organization. There is no VM size option: each VM receives its reserved GPUs and a matching share of the host's vCPUs, memory, and local disk, with at most 3 TiB of RAM on compatible hosts. Launch does not attach storage volumes. Use Kubernetes or Slurm cluster routes for those access modes.","href":"/api-reference/virtual-machines/launch"},"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: \"Starts SSH access on an owned VM or Bare Metal reservation. If the reservation already has machines (for example after activation), launch sends the selected SSH keys to them and returns 202 with the current nodes. Otherwise launch selects nodes for the reservation, starts provisioning, and returns 201. Either response is acceptance, not readiness: poll the reservation’s VMs or the node until SSH is ready. Repeating launch after machines exist does not reprovision them; it sends the keys again. ssh_key_ids adds keys to the reservation’s saved list. Without it, launch uses the saved list, including an empty list. With no earlier selection, launch saves every active SSH key in your organization. There is no VM size option: each VM receives its reserved GPUs and a matching share of the host’s vCPUs, memory, and local disk, with at most 3 TiB of RAM on compatible hosts. Launch does not attach storage volumes. Use Kubernetes or Slurm cluster routes for those access modes.\"\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{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,..._provideComponents(),...props.components};return _jsxs(_components.p,{children:[`CLI equivalent: `,_jsx(_components.code,{children:`ornn launch \u003creservation-id> --mode vm --key \u003ckey-id>`}),` (or `,_jsx(_components.code,{children:`--mode bare-metal`}),`). Add `,_jsx(_components.code,{children:`--wait`}),` to wait for SSH. Walkthroughs: `,_jsx(_components.a,{href:`/guides/vm-access#use-the-api`,children:`VM`}),` and `,_jsx(_components.a,{href:`/guides/bare-metal-access#use-the-api`,children:`Bare Metal`}),`.`]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Launch VM or Bare Metal access","openapi":"openapi.yaml POST /v1/orchestrator/nodes/reservations/{reservation_id}/launch","description":"Starts SSH access on an owned VM or Bare Metal reservation. If the reservation already has machines (for example after activation), launch sends the selected SSH keys to them and returns 202 with the current nodes. Otherwise launch selects nodes for the reservation, starts provisioning, and returns 201. Either response is acceptance, not readiness: poll the reservation's VMs or the node until SSH is ready. Repeating launch after machines exist does not reprovision them; it sends the keys again. ssh_key_ids adds keys to the reservation's saved list. Without it, launch uses the saved list, including an empty list. With no earlier selection, launch saves every active SSH key in your organization. There is no VM size option: each VM receives its reserved GPUs and a matching share of the host's vCPUs, memory, and local disk, with at most 3 TiB of RAM on compatible hosts. Launch does not attach storage volumes. Use Kubernetes or Slurm cluster routes for those access modes.","href":"/api-reference/virtual-machines/launch"}}},"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":"Launch VM or Bare Metal access","operationId":"accessLaunchReservation","tags":["Virtual machines","Bare Metal"],"description":"Starts SSH access on an owned VM or Bare Metal reservation. If the reservation already has machines (for example after activation), launch sends the selected SSH keys to them and returns 202 with the current nodes. Otherwise launch selects nodes for the reservation, starts provisioning, and returns 201. Either response is acceptance, not readiness: poll the reservation's VMs or the node until SSH is ready. Repeating launch after machines exist does not reprovision them; it sends the keys again. ssh_key_ids adds keys to the reservation's saved list. Without it, launch uses the saved list, including an empty list. With no earlier selection, launch saves every active SSH key in your organization. There is no VM size option: each VM receives its reserved GPUs and a matching share of the host's vCPUs, memory, and local disk, with at most 3 TiB of RAM on compatible hosts. Launch does not attach storage volumes. Use Kubernetes or Slurm cluster routes for those access modes.","parameters":["a7e604ed-9b76-467c-9760-f426ed00e660"],"requestBody":"b3a6d722-c3d7-46e0-865b-45cedffe1995","responses":{"201":"44b60632-a8e3-4e4d-9c16-d3e55e49e268","202":"ac8e5cdd-ea39-449d-8daa-f08183161146","400":"3fb1df40-b8da-4e45-8dcb-a2121cef58fd","401":"4d8b42b2-433e-4049-ae54-97af42a3e551","403":"f4794ed2-b83c-465c-9018-dadd25cdcff5","404":"594f8ef9-b085-4ba3-b26d-b0d41218d1d9","409":"fac172eb-a54a-49ef-bbb6-36317ac509af","422":"578bd1ae-0b7f-4272-a68d-7b33e93d7e6a","default":"1a423c44-b9fa-4e06-a413-de61edb75263"},"method":"post","type":"path","servers":["b5278a3e-d7b4-4091-bdc0-1851b2a0c7e8"],"security":["baed9a0c-2c12-4011-8c36-813eef0e864e"],"path":"/v1/orchestrator/nodes/reservations/{reservation_id}/launch","baseUrlOptions":["https://api.ornn.com"],"title":"Launch VM or Bare Metal access","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","php","go","java","ruby"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"a7e604ed-9b76-467c-9760-f426ed00e660":{"name":"reservation_id","in":"path","required":true,"description":"An owned reservation ID (reservationId in reservation responses).","schema":{"type":"string","format":"uuid","isRequired":true,"description":"An owned reservation ID (reservationId in reservation responses).","uniqueKey":"","typeLabel":"string\u003cuuid>"},"example":"11111111-1111-4111-8111-111111111111"}},"requestBody":{"required":true,"description":"Send an empty object to use the reservation's defaults.","content":{"application/json":{"schema":{"type":"object","properties":{"access_mode":{"type":"string","enum":["virtual-machine","bare-metal"],"description":"Defaults to the reservation's access mode. Use the mode your reservation was booked with.","uniqueKey":"access_mode","typeLabel":"enum\u003cstring>"},"disk_id":{"oneOf":[{"type":"string","format":"uuid","description":"VM only. Overrides the reservation's saved disk for VMs this request creates. When omitted, the saved disk is used; a VM launch with no disk available fails with disk_required. Must be omitted for Bare Metal.","uniqueKey":"disk_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"VM only. Overrides the reservation's saved disk for VMs this request creates. When omitted, the saved disk is used; a VM launch with no disk available fails with disk_required. Must be omitted for Bare Metal.","uniqueKey":"disk_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"disk_id","typeLabel":"string\u003cuuid> | null"},"network_mode":{"type":"string","enum":["public","private"],"default":"public","description":"public exposes SSH on the host's public address. private connects the machine to your organization's private network.","uniqueKey":"network_mode","typeLabel":"enum\u003cstring>"},"network_id":{"oneOf":[{"type":"string","format":"uuid","description":"Private networking only. An existing private network in your organization. Omit it to use the organization's shared network. This does not create a network.","uniqueKey":"network_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Private networking only. An existing private network in your organization. Omit it to use the organization's shared network. This does not create a network.","uniqueKey":"network_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"network_id","typeLabel":"string\u003cuuid> | null"},"node_count":{"oneOf":[{"type":"integer","minimum":1,"description":"How many of the reservation's nodes to provision when launch starts provisioning. Defaults to every reserved node and cannot exceed it. Ignored when the reservation already has machines.","uniqueKey":"node_count.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":1,"description":"How many of the reservation's nodes to provision when launch starts provisioning. Defaults to every reserved node and cannot exceed it. Ignored when the reservation already has machines.","uniqueKey":"node_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"node_count","typeLabel":"integer | null"},"ssh_key_ids":{"type":"array","uniqueItems":true,"items":{"type":"string","format":"uuid","uniqueKey":"ssh_key_ids.items.[INDEX]","typeLabel":"string\u003cuuid>"},"description":"Active organization SSH key IDs to add to the reservation's saved selection. Omit to use the saved list, including an empty list. With no earlier selection, launch saves every active organization key.","uniqueKey":"ssh_key_ids","typeLabel":"string\u003cuuid>[]"},"request_id":{"oneOf":[{"type":"string","description":"Optional client token for this request. Reuse it when you retry the same launch so Ornn can recognize repeated commands.","uniqueKey":"request_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional client token for this request. Reuse it when you retry the same launch so Ornn can recognize repeated commands.","uniqueKey":"request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"request_id","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"virtualMachine":{"title":"virtualMachine","value":{"access_mode":"virtual-machine","network_mode":"public","ssh_key_ids":["88888888-8888-4888-8888-888888888888"],"request_id":"launch-2026-10-15-a"}},"bareMetal":{"title":"bareMetal","value":{"access_mode":"bare-metal","network_mode":"private","network_id":"aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa","ssh_key_ids":["88888888-8888-4888-8888-888888888888"]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"44b60632-a8e3-4e4d-9c16-d3e55e49e268":{"description":"Provisioning started on the returned nodes.","content":{"application/json":{"schema":{"type":"object","required":["nodes"],"properties":{"nodes":{"type":"array","items":{"type":"object","description":"A reserved host node. Fields not listed under Node are SSH key delivery and reboot state.","required":["node_id","reservation_id","controller_id","status"],"properties":{"node_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"nodes.items.[INDEX].node_id","typeLabel":"string\u003cuuid>"},"reservation_id":{"oneOf":[{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"nodes.items.[INDEX].reservation_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","isRequired":true,"uniqueKey":"nodes.items.[INDEX].reservation_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nodes.items.[INDEX].reservation_id","typeLabel":"string\u003cuuid> | null"},"controller_id":{"oneOf":[{"type":"string","format":"uuid","description":"The cluster currently holding this node, or null.","isRequired":true,"uniqueKey":"nodes.items.[INDEX].controller_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"The cluster currently holding this node, or null.","isRequired":true,"uniqueKey":"nodes.items.[INDEX].controller_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nodes.items.[INDEX].controller_id","typeLabel":"string\u003cuuid> | null"},"status":{"type":"string","description":"Node lifecycle or access mode, such as bare-metal; not a liveness signal.","isRequired":true,"uniqueKey":"nodes.items.[INDEX].status","typeLabel":"string"},"health_readiness":{"type":"object","description":"Heartbeat-based launch preflight returned on reservation nodes. A stale heartbeat blocks launch. Missing heartbeat evidence returns ready true with heartbeat:unknown in advisory_reasons; this is not proof of host reachability, GPU health, or workload readiness. Treat an absent readiness object as unknown, not as ready. The reservation-node serializer returns an object, never null.","required":["ready","status","reasons","advisory_reasons"],"properties":{"ready":{"type":"boolean","description":"Whether the heartbeat preflight reports no blocking reason.","isRequired":true,"uniqueKey":"nodes.items.[INDEX].health_readiness.ready","typeLabel":"boolean"},"status":{"type":"string","enum":["ready","blocked"],"isRequired":true,"uniqueKey":"nodes.items.[INDEX].health_readiness.status","typeLabel":"enum\u003cstring>"},"reasons":{"type":"array","items":{"type":"string","uniqueKey":"nodes.items.[INDEX].health_readiness.reasons.items.[INDEX]","typeLabel":"string"},"description":"Blocking reasons, such as heartbeat:stale.","isRequired":true,"uniqueKey":"nodes.items.[INDEX].health_readiness.reasons","typeLabel":"string[]"},"advisory_reasons":{"type":"array","items":{"type":"string","uniqueKey":"nodes.items.[INDEX].health_readiness.advisory_reasons.items.[INDEX]","typeLabel":"string"},"description":"Nonblocking advisories, such as heartbeat:unknown.","isRequired":true,"uniqueKey":"nodes.items.[INDEX].health_readiness.advisory_reasons","typeLabel":"string[]"}},"example":{"ready":false,"status":"blocked","reasons":["heartbeat:stale"],"advisory_reasons":[]},"uniqueKey":"nodes.items.[INDEX].health_readiness","typeLabel":"object"},"gpu_type":{"oneOf":[{"type":"string","description":"GPU model. Null with gpu_count 0 on a CPU node, a node without GPUs.","uniqueKey":"nodes.items.[INDEX].gpu_type.oneOf.0","typeLabel":"string"},{"type":"null","description":"GPU model. Null with gpu_count 0 on a CPU node, a node without GPUs.","uniqueKey":"nodes.items.[INDEX].gpu_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].gpu_type","typeLabel":"string | null"},"gpu_count":{"oneOf":[{"type":"integer","description":"GPUs on the node; 0 on a CPU node.","uniqueKey":"nodes.items.[INDEX].gpu_count.oneOf.0","typeLabel":"integer"},{"type":"null","description":"GPUs on the node; 0 on a CPU node.","uniqueKey":"nodes.items.[INDEX].gpu_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].gpu_count","typeLabel":"integer | null"},"vcpus":{"oneOf":[{"type":"integer","description":"vCPUs on the node. Null when not yet reported.","uniqueKey":"nodes.items.[INDEX].vcpus.oneOf.0","typeLabel":"integer"},{"type":"null","description":"vCPUs on the node. Null when not yet reported.","uniqueKey":"nodes.items.[INDEX].vcpus.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].vcpus","typeLabel":"integer | null"},"hostname":{"oneOf":[{"type":"string","uniqueKey":"nodes.items.[INDEX].hostname.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"nodes.items.[INDEX].hostname.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].hostname","typeLabel":"string | null"},"facility_id":{"oneOf":[{"type":"string","format":"uuid","uniqueKey":"nodes.items.[INDEX].facility_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","uniqueKey":"nodes.items.[INDEX].facility_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].facility_id","typeLabel":"string\u003cuuid> | null"},"cpu_type":{"oneOf":[{"type":"string","uniqueKey":"nodes.items.[INDEX].cpu_type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"nodes.items.[INDEX].cpu_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].cpu_type","typeLabel":"string | null"},"memory_bytes":{"oneOf":[{"type":"integer","format":"int64","uniqueKey":"nodes.items.[INDEX].memory_bytes.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","uniqueKey":"nodes.items.[INDEX].memory_bytes.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].memory_bytes","typeLabel":"integer\u003cint64> | null"},"storage_bytes":{"oneOf":[{"type":"integer","format":"int64","uniqueKey":"nodes.items.[INDEX].storage_bytes.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","uniqueKey":"nodes.items.[INDEX].storage_bytes.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].storage_bytes","typeLabel":"integer\u003cint64> | null"},"ip":{"type":"string","uniqueKey":"nodes.items.[INDEX].ip","typeLabel":"string"},"port":{"oneOf":[{"type":"integer","uniqueKey":"nodes.items.[INDEX].port.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"nodes.items.[INDEX].port.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].port","typeLabel":"integer | null"},"username":{"type":"string","uniqueKey":"nodes.items.[INDEX].username","typeLabel":"string"},"ssh_endpoint":{"oneOf":[{"description":"SSH login and host for the node. A configured SSH forward uses the public entry point with the node's port. Null means the endpoint is unavailable.","type":"string","uniqueKey":"nodes.items.[INDEX].ssh_endpoint.oneOf.0","typeLabel":"string"},{"description":"SSH login and host for the node. A configured SSH forward uses the public entry point with the node's port. Null means the endpoint is unavailable.","type":"null","uniqueKey":"nodes.items.[INDEX].ssh_endpoint.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].ssh_endpoint","typeLabel":"string | null"},"enrolled_at":{"type":"string","format":"date-time","uniqueKey":"nodes.items.[INDEX].enrolled_at","typeLabel":"string\u003cdate-time>"},"cleanup_state":{"type":"string","uniqueKey":"nodes.items.[INDEX].cleanup_state","typeLabel":"string"},"authorized_key_fingerprints":{"type":"array","items":{"type":"string","uniqueKey":"nodes.items.[INDEX].authorized_key_fingerprints.items.[INDEX]","typeLabel":"string"},"description":"Fingerprints of SSH keys recorded as installed on this host or its VMs. For a specific VM, use the reservation SSH-key list with virtual_machine_id; a host fingerprint alone does not prove access to that guest.","uniqueKey":"nodes.items.[INDEX].authorized_key_fingerprints","typeLabel":"string[]"},"authorized_key_metadata":{"type":"array","items":{"type":"object","description":"Delivery state of one SSH key on a host or one of its VMs. These host-level records do not identify the guest; use the reservation SSH-key list with virtual_machine_id to confirm an active key on a specific VM.","properties":{"fingerprint":{"type":"string","description":"SHA256 fingerprint of the public key.","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].fingerprint","typeLabel":"string"},"label":{"oneOf":[{"type":"string","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].label.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].label.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].label","typeLabel":"string | null"},"status":{"type":"string","description":"installed or failed.","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].status","typeLabel":"string"},"linux_username":{"type":"string","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].linux_username","typeLabel":"string"},"pushed_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].pushed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].pushed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].pushed_at","typeLabel":"string\u003cdate-time> | null"},"failed_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].failed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].failed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].failed_at","typeLabel":"string\u003cdate-time> | null"},"failure_reason":{"oneOf":[{"type":"string","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].failure_reason.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].failure_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].failure_reason","typeLabel":"string | null"},"request_id":{"oneOf":[{"type":"string","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].request_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].request_id","typeLabel":"string | null"}},"uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX]","typeLabel":"object"},"uniqueKey":"nodes.items.[INDEX].authorized_key_metadata","typeLabel":"object[]"},"keys_pushed_at":{"oneOf":[{"type":"string","format":"date-time","description":"When keys were last recorded as installed on this host or one of its VMs.","uniqueKey":"nodes.items.[INDEX].keys_pushed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When keys were last recorded as installed on this host or one of its VMs.","uniqueKey":"nodes.items.[INDEX].keys_pushed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].keys_pushed_at","typeLabel":"string\u003cdate-time> | null"},"reboot":{"oneOf":[{"type":"null","description":"The latest tracked host reboot, or null.","uniqueKey":"nodes.items.[INDEX].reboot.oneOf.0","typeLabel":"null"},{"type":"object","description":"The latest tracked host reboot, or null.","required":["packet_id","status","started_at"],"properties":{"packet_id":{"type":"string","format":"uuid","description":"Identifier of the reboot request.","isRequired":true,"uniqueKey":"nodes.items.[INDEX].reboot.oneOf.1.packet_id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["in_progress","succeeded","failed"],"isRequired":true,"uniqueKey":"nodes.items.[INDEX].reboot.oneOf.1.status","typeLabel":"enum\u003cstring>"},"started_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"nodes.items.[INDEX].reboot.oneOf.1.started_at","typeLabel":"string\u003cdate-time>"},"detail":{"oneOf":[{"type":"null","description":"Why the reboot failed, when status is failed.","uniqueKey":"nodes.items.[INDEX].reboot.oneOf.1.detail.oneOf.0","typeLabel":"null"},{"type":"object","description":"Why the reboot failed, when status is failed.","properties":{"code":{"type":"string","uniqueKey":"nodes.items.[INDEX].reboot.oneOf.1.detail.oneOf.1.code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"nodes.items.[INDEX].reboot.oneOf.1.detail.oneOf.1.message","typeLabel":"string"}},"uniqueKey":"nodes.items.[INDEX].reboot.oneOf.1.detail.oneOf.1","typeLabel":"object"}],"uniqueKey":"nodes.items.[INDEX].reboot.oneOf.1.detail","typeLabel":"null | object"}},"uniqueKey":"nodes.items.[INDEX].reboot.oneOf.1","typeLabel":"object"}],"uniqueKey":"nodes.items.[INDEX].reboot","typeLabel":"null | object"}},"uniqueKey":"nodes.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"nodes","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"nodes":[{"node_id":"33333333-3333-4333-8333-333333333333","reservation_id":"11111111-1111-4111-8111-111111111111","controller_id":null,"status":"bare-metal","hostname":"gpu-host-01","ip":"203.0.113.10","port":22,"username":"tenant","ssh_endpoint":"tenant@203.0.113.10","gpu_type":"H100","gpu_count":8,"authorized_key_fingerprints":[],"authorized_key_metadata":[],"keys_pushed_at":null,"reboot":null,"health_readiness":{"ready":true,"status":"ready","reasons":[],"advisory_reasons":[]}}]},"examples":{"Example":{"title":"Example","value":{"nodes":[{"node_id":"33333333-3333-4333-8333-333333333333","reservation_id":"11111111-1111-4111-8111-111111111111","controller_id":null,"status":"bare-metal","hostname":"gpu-host-01","ip":"203.0.113.10","port":22,"username":"tenant","ssh_endpoint":"tenant@203.0.113.10","gpu_type":"H100","gpu_count":8,"authorized_key_fingerprints":[],"authorized_key_metadata":[],"keys_pushed_at":null,"reboot":null,"health_readiness":{"ready":true,"status":"ready","reasons":[],"advisory_reasons":[]}}]}}},"exampleType":"examples"}},"exampleType":"examples"},"ac8e5cdd-ea39-449d-8daa-f08183161146":{"description":"The reservation already has machines. SSH keys were queued for delivery; the body lists the current nodes.","content":{"application/json":{"schema":{"type":"object","required":["nodes"],"properties":{"nodes":{"type":"array","items":{"type":"object","description":"A reserved host node. Fields not listed under Node are SSH key delivery and reboot state.","required":["node_id","reservation_id","controller_id","status"],"properties":{"node_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"nodes.items.[INDEX].node_id","typeLabel":"string\u003cuuid>"},"reservation_id":{"oneOf":[{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"nodes.items.[INDEX].reservation_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","isRequired":true,"uniqueKey":"nodes.items.[INDEX].reservation_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nodes.items.[INDEX].reservation_id","typeLabel":"string\u003cuuid> | null"},"controller_id":{"oneOf":[{"type":"string","format":"uuid","description":"The cluster currently holding this node, or null.","isRequired":true,"uniqueKey":"nodes.items.[INDEX].controller_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"The cluster currently holding this node, or null.","isRequired":true,"uniqueKey":"nodes.items.[INDEX].controller_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nodes.items.[INDEX].controller_id","typeLabel":"string\u003cuuid> | null"},"status":{"type":"string","description":"Node lifecycle or access mode, such as bare-metal; not a liveness signal.","isRequired":true,"uniqueKey":"nodes.items.[INDEX].status","typeLabel":"string"},"health_readiness":{"type":"object","description":"Heartbeat-based launch preflight returned on reservation nodes. A stale heartbeat blocks launch. Missing heartbeat evidence returns ready true with heartbeat:unknown in advisory_reasons; this is not proof of host reachability, GPU health, or workload readiness. Treat an absent readiness object as unknown, not as ready. The reservation-node serializer returns an object, never null.","required":["ready","status","reasons","advisory_reasons"],"properties":{"ready":{"type":"boolean","description":"Whether the heartbeat preflight reports no blocking reason.","isRequired":true,"uniqueKey":"nodes.items.[INDEX].health_readiness.ready","typeLabel":"boolean"},"status":{"type":"string","enum":["ready","blocked"],"isRequired":true,"uniqueKey":"nodes.items.[INDEX].health_readiness.status","typeLabel":"enum\u003cstring>"},"reasons":{"type":"array","items":{"type":"string","uniqueKey":"nodes.items.[INDEX].health_readiness.reasons.items.[INDEX]","typeLabel":"string"},"description":"Blocking reasons, such as heartbeat:stale.","isRequired":true,"uniqueKey":"nodes.items.[INDEX].health_readiness.reasons","typeLabel":"string[]"},"advisory_reasons":{"type":"array","items":{"type":"string","uniqueKey":"nodes.items.[INDEX].health_readiness.advisory_reasons.items.[INDEX]","typeLabel":"string"},"description":"Nonblocking advisories, such as heartbeat:unknown.","isRequired":true,"uniqueKey":"nodes.items.[INDEX].health_readiness.advisory_reasons","typeLabel":"string[]"}},"example":{"ready":false,"status":"blocked","reasons":["heartbeat:stale"],"advisory_reasons":[]},"uniqueKey":"nodes.items.[INDEX].health_readiness","typeLabel":"object"},"gpu_type":{"oneOf":[{"type":"string","description":"GPU model. Null with gpu_count 0 on a CPU node, a node without GPUs.","uniqueKey":"nodes.items.[INDEX].gpu_type.oneOf.0","typeLabel":"string"},{"type":"null","description":"GPU model. Null with gpu_count 0 on a CPU node, a node without GPUs.","uniqueKey":"nodes.items.[INDEX].gpu_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].gpu_type","typeLabel":"string | null"},"gpu_count":{"oneOf":[{"type":"integer","description":"GPUs on the node; 0 on a CPU node.","uniqueKey":"nodes.items.[INDEX].gpu_count.oneOf.0","typeLabel":"integer"},{"type":"null","description":"GPUs on the node; 0 on a CPU node.","uniqueKey":"nodes.items.[INDEX].gpu_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].gpu_count","typeLabel":"integer | null"},"vcpus":{"oneOf":[{"type":"integer","description":"vCPUs on the node. Null when not yet reported.","uniqueKey":"nodes.items.[INDEX].vcpus.oneOf.0","typeLabel":"integer"},{"type":"null","description":"vCPUs on the node. Null when not yet reported.","uniqueKey":"nodes.items.[INDEX].vcpus.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].vcpus","typeLabel":"integer | null"},"hostname":{"oneOf":[{"type":"string","uniqueKey":"nodes.items.[INDEX].hostname.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"nodes.items.[INDEX].hostname.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].hostname","typeLabel":"string | null"},"facility_id":{"oneOf":[{"type":"string","format":"uuid","uniqueKey":"nodes.items.[INDEX].facility_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","uniqueKey":"nodes.items.[INDEX].facility_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].facility_id","typeLabel":"string\u003cuuid> | null"},"cpu_type":{"oneOf":[{"type":"string","uniqueKey":"nodes.items.[INDEX].cpu_type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"nodes.items.[INDEX].cpu_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].cpu_type","typeLabel":"string | null"},"memory_bytes":{"oneOf":[{"type":"integer","format":"int64","uniqueKey":"nodes.items.[INDEX].memory_bytes.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","uniqueKey":"nodes.items.[INDEX].memory_bytes.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].memory_bytes","typeLabel":"integer\u003cint64> | null"},"storage_bytes":{"oneOf":[{"type":"integer","format":"int64","uniqueKey":"nodes.items.[INDEX].storage_bytes.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","uniqueKey":"nodes.items.[INDEX].storage_bytes.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].storage_bytes","typeLabel":"integer\u003cint64> | null"},"ip":{"type":"string","uniqueKey":"nodes.items.[INDEX].ip","typeLabel":"string"},"port":{"oneOf":[{"type":"integer","uniqueKey":"nodes.items.[INDEX].port.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"nodes.items.[INDEX].port.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].port","typeLabel":"integer | null"},"username":{"type":"string","uniqueKey":"nodes.items.[INDEX].username","typeLabel":"string"},"ssh_endpoint":{"oneOf":[{"description":"SSH login and host for the node. A configured SSH forward uses the public entry point with the node's port. Null means the endpoint is unavailable.","type":"string","uniqueKey":"nodes.items.[INDEX].ssh_endpoint.oneOf.0","typeLabel":"string"},{"description":"SSH login and host for the node. A configured SSH forward uses the public entry point with the node's port. Null means the endpoint is unavailable.","type":"null","uniqueKey":"nodes.items.[INDEX].ssh_endpoint.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].ssh_endpoint","typeLabel":"string | null"},"enrolled_at":{"type":"string","format":"date-time","uniqueKey":"nodes.items.[INDEX].enrolled_at","typeLabel":"string\u003cdate-time>"},"cleanup_state":{"type":"string","uniqueKey":"nodes.items.[INDEX].cleanup_state","typeLabel":"string"},"authorized_key_fingerprints":{"type":"array","items":{"type":"string","uniqueKey":"nodes.items.[INDEX].authorized_key_fingerprints.items.[INDEX]","typeLabel":"string"},"description":"Fingerprints of SSH keys recorded as installed on this host or its VMs. For a specific VM, use the reservation SSH-key list with virtual_machine_id; a host fingerprint alone does not prove access to that guest.","uniqueKey":"nodes.items.[INDEX].authorized_key_fingerprints","typeLabel":"string[]"},"authorized_key_metadata":{"type":"array","items":{"type":"object","description":"Delivery state of one SSH key on a host or one of its VMs. These host-level records do not identify the guest; use the reservation SSH-key list with virtual_machine_id to confirm an active key on a specific VM.","properties":{"fingerprint":{"type":"string","description":"SHA256 fingerprint of the public key.","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].fingerprint","typeLabel":"string"},"label":{"oneOf":[{"type":"string","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].label.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].label.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].label","typeLabel":"string | null"},"status":{"type":"string","description":"installed or failed.","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].status","typeLabel":"string"},"linux_username":{"type":"string","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].linux_username","typeLabel":"string"},"pushed_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].pushed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].pushed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].pushed_at","typeLabel":"string\u003cdate-time> | null"},"failed_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].failed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].failed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].failed_at","typeLabel":"string\u003cdate-time> | null"},"failure_reason":{"oneOf":[{"type":"string","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].failure_reason.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].failure_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].failure_reason","typeLabel":"string | null"},"request_id":{"oneOf":[{"type":"string","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].request_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX].request_id","typeLabel":"string | null"}},"uniqueKey":"nodes.items.[INDEX].authorized_key_metadata.items.[INDEX]","typeLabel":"object"},"uniqueKey":"nodes.items.[INDEX].authorized_key_metadata","typeLabel":"object[]"},"keys_pushed_at":{"oneOf":[{"type":"string","format":"date-time","description":"When keys were last recorded as installed on this host or one of its VMs.","uniqueKey":"nodes.items.[INDEX].keys_pushed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When keys were last recorded as installed on this host or one of its VMs.","uniqueKey":"nodes.items.[INDEX].keys_pushed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"nodes.items.[INDEX].keys_pushed_at","typeLabel":"string\u003cdate-time> | null"},"reboot":{"oneOf":[{"type":"null","description":"The latest tracked host reboot, or null.","uniqueKey":"nodes.items.[INDEX].reboot.oneOf.0","typeLabel":"null"},{"type":"object","description":"The latest tracked host reboot, or null.","required":["packet_id","status","started_at"],"properties":{"packet_id":{"type":"string","format":"uuid","description":"Identifier of the reboot request.","isRequired":true,"uniqueKey":"nodes.items.[INDEX].reboot.oneOf.1.packet_id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["in_progress","succeeded","failed"],"isRequired":true,"uniqueKey":"nodes.items.[INDEX].reboot.oneOf.1.status","typeLabel":"enum\u003cstring>"},"started_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"nodes.items.[INDEX].reboot.oneOf.1.started_at","typeLabel":"string\u003cdate-time>"},"detail":{"oneOf":[{"type":"null","description":"Why the reboot failed, when status is failed.","uniqueKey":"nodes.items.[INDEX].reboot.oneOf.1.detail.oneOf.0","typeLabel":"null"},{"type":"object","description":"Why the reboot failed, when status is failed.","properties":{"code":{"type":"string","uniqueKey":"nodes.items.[INDEX].reboot.oneOf.1.detail.oneOf.1.code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"nodes.items.[INDEX].reboot.oneOf.1.detail.oneOf.1.message","typeLabel":"string"}},"uniqueKey":"nodes.items.[INDEX].reboot.oneOf.1.detail.oneOf.1","typeLabel":"object"}],"uniqueKey":"nodes.items.[INDEX].reboot.oneOf.1.detail","typeLabel":"null | object"}},"uniqueKey":"nodes.items.[INDEX].reboot.oneOf.1","typeLabel":"object"}],"uniqueKey":"nodes.items.[INDEX].reboot","typeLabel":"null | object"}},"uniqueKey":"nodes.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"nodes","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"nodes":[{"node_id":"33333333-3333-4333-8333-333333333333","reservation_id":"11111111-1111-4111-8111-111111111111","controller_id":null,"status":"bare-metal","hostname":"gpu-host-01","ip":"203.0.113.10","port":22,"username":"tenant","ssh_endpoint":"tenant@203.0.113.10","gpu_type":"H100","gpu_count":8,"authorized_key_fingerprints":["SHA256:exampleFingerprint0000000000000000000000000"],"authorized_key_metadata":[{"fingerprint":"SHA256:exampleFingerprint0000000000000000000000000","label":null,"status":"installed","linux_username":"tenant","pushed_at":"2026-10-15T00:06:40Z","failed_at":null,"failure_reason":null,"request_id":null}],"keys_pushed_at":"2026-10-15T00:06:40Z","reboot":null,"health_readiness":{"ready":true,"status":"ready","reasons":[],"advisory_reasons":[]}}]},"examples":{"Example":{"title":"Example","value":{"nodes":[{"node_id":"33333333-3333-4333-8333-333333333333","reservation_id":"11111111-1111-4111-8111-111111111111","controller_id":null,"status":"bare-metal","hostname":"gpu-host-01","ip":"203.0.113.10","port":22,"username":"tenant","ssh_endpoint":"tenant@203.0.113.10","gpu_type":"H100","gpu_count":8,"authorized_key_fingerprints":["SHA256:exampleFingerprint0000000000000000000000000"],"authorized_key_metadata":[{"fingerprint":"SHA256:exampleFingerprint0000000000000000000000000","label":null,"status":"installed","linux_username":"tenant","pushed_at":"2026-10-15T00:06:40Z","failed_at":null,"failure_reason":null,"request_id":null}],"keys_pushed_at":"2026-10-15T00:06:40Z","reboot":null,"health_readiness":{"ready":true,"status":"ready","reasons":[],"advisory_reasons":[]}}]}}},"exampleType":"examples"}},"exampleType":"examples"},"3fb1df40-b8da-4e45-8dcb-a2121cef58fd":{"description":"Invalid launch input, such as a VM with no disk available, an unsupported access mode, network_id without private networking, or a repeated SSH key ID. Some of these errors return detail as a plain code string.","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":{"diskRequired":{"title":"diskRequired","value":{"detail":"disk_required"}},"networkIdNotAllowed":{"title":"networkIdNotAllowed","value":{"detail":{"code":"network_id_not_allowed","message":"A named network can only be used with Private VPN. Switch to Private VPN, or leave the network as Shared."}}}},"exampleType":"examples"}},"exampleType":"examples"},"4d8b42b2-433e-4049-ae54-97af42a3e551":{"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"},"f4794ed2-b83c-465c-9018-dadd25cdcff5":{"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"},"594f8ef9-b085-4ba3-b26d-b0d41218d1d9":{"description":"The reservation is absent or not owned by your organization.","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"},"example":{"detail":{"code":"reservation_not_found","message":"Ornn could not find that reservation."}},"examples":{"Example":{"title":"Example","value":{"detail":{"code":"reservation_not_found","message":"Ornn could not find that reservation."}}}},"exampleType":"examples"}},"exampleType":"examples"},"fac172eb-a54a-49ef-bbb6-36317ac509af":{"description":"The reservation cannot launch in its current state, no active SSH key is available, not enough nodes are free, or a node still has a previous environment to clean up.","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"},"example":{"detail":{"code":"ssh_key_required","message":"Add an SSH key to your account before you launch. Machines are reached over SSH."}},"examples":{"Example":{"title":"Example","value":{"detail":{"code":"ssh_key_required","message":"Add an SSH key to your account before you launch. Machines are reached over SSH."}}}},"exampleType":"examples"}},"exampleType":"examples"},"578bd1ae-0b7f-4272-a68d-7b33e93d7e6a":{"description":"A disk was sent for Bare Metal. This error returns detail as a plain string.","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"},"example":{"detail":"bare_metal_disk_not_allowed"},"examples":{"Example":{"title":"Example","value":{"detail":"bare_metal_disk_not_allowed"}}},"exampleType":"examples"}},"exampleType":"examples"},"1a423c44-b9fa-4e06-a413-de61edb75263":{"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":{"baed9a0c-2c12-4011-8c36-813eef0e864e":{"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":{"b5278a3e-d7b4-4091-bdc0-1851b2a0c7e8":{"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":"Launch VM or Bare Metal access - Ornn","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-09T21:06:49.080Z","originalFileLocation":"api-reference/virtual-machines/launch.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=\"Starts SSH access on an owned VM or Bare Metal reservation. If the reservation already has machines (for example after activation), launch sends the selected SSH keys to them and returns 202 with the current nodes. Otherwise launch selects nodes for the reservation, starts provisioning, and returns 201. Either response is acceptance, not readiness: poll the reservation\u0026#x27;s VMs or the node until SSH is ready. Repeating launch after machines exist does not reprovision them; it sends the keys again. ssh_key_ids adds keys to the reservation\u0026#x27;s saved list. Without it, launch uses the saved list, including an empty list. With no earlier selection, launch saves every active SSH key in your organization. There is no VM size option: each VM receives its reserved GPUs and a matching share of the host\u0026#x27;s vCPUs, memory, and local disk, with at most 3 TiB of RAM on compatible hosts. Launch does not attach storage volumes. Use Kubernetes or Slurm cluster routes for those access modes.\">\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=\"Launch VM or Bare Metal access - Ornn\">\u003cmeta data-mint-head property=\"og:description\" content=\"Starts SSH access on an owned VM or Bare Metal reservation. If the reservation already has machines (for example after activation), launch sends the selected SSH keys to them and returns 202 with the current nodes. Otherwise launch selects nodes for the reservation, starts provisioning, and returns 201. Either response is acceptance, not readiness: poll the reservation\u0026#x27;s VMs or the node until SSH is ready. Repeating launch after machines exist does not reprovision them; it sends the keys again. ssh_key_ids adds keys to the reservation\u0026#x27;s saved list. Without it, launch uses the saved list, including an empty list. With no earlier selection, launch saves every active SSH key in your organization. There is no VM size option: each VM receives its reserved GPUs and a matching share of the host\u0026#x27;s vCPUs, memory, and local disk, with at most 3 TiB of RAM on compatible hosts. Launch does not attach storage volumes. Use Kubernetes or Slurm cluster routes for those access modes.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ornn\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ornn.com/api-reference/virtual-machines/launch\">\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=VM+and+Bare+Metal\u0026amp;title=Launch+VM+or+Bare+Metal+access\u0026amp;description=Starts+SSH+access+on+an+owned+VM+or+Bare+Metal+reservation.+If+the+reservation+already+has+machines+%28for+example+after+activation%29%2C+launch+sends+the+selected+SS\u0026amp;theme=3cb4facbf0c28da5810d277d\u0026amp;signature=9e1ec84a1b9395cf019f0b389082f182a2ccfa144ee3d7fda4dcabbf191af496\">\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=\"Launch VM or Bare Metal access - Ornn\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Starts SSH access on an owned VM or Bare Metal reservation. If the reservation already has machines (for example after activation), launch sends the selected SSH keys to them and returns 202 with the current nodes. Otherwise launch selects nodes for the reservation, starts provisioning, and returns 201. Either response is acceptance, not readiness: poll the reservation\u0026#x27;s VMs or the node until SSH is ready. Repeating launch after machines exist does not reprovision them; it sends the keys again. ssh_key_ids adds keys to the reservation\u0026#x27;s saved list. Without it, launch uses the saved list, including an empty list. With no earlier selection, launch saves every active SSH key in your organization. There is no VM size option: each VM receives its reserved GPUs and a matching share of the host\u0026#x27;s vCPUs, memory, and local disk, with at most 3 TiB of RAM on compatible hosts. Launch does not attach storage volumes. Use Kubernetes or Slurm cluster routes for those access modes.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ornn.mintlify.site/_mintlify/api/og/v2?division=VM+and+Bare+Metal\u0026amp;title=Launch+VM+or+Bare+Metal+access\u0026amp;description=Starts+SSH+access+on+an+owned+VM+or+Bare+Metal+reservation.+If+the+reservation+already+has+machines+%28for+example+after+activation%29%2C+launch+sends+the+selected+SS\u0026amp;theme=3cb4facbf0c28da5810d277d\u0026amp;signature=9e1ec84a1b9395cf019f0b389082f182a2ccfa144ee3d7fda4dcabbf191af496\">\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/virtual-machines/launch\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/virtual-machines/launch.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/virtual-machines/launch#webpage\",\"url\":\"https://docs.ornn.com/api-reference/virtual-machines/launch\",\"name\":\"Launch VM or Bare Metal access\",\"description\":\"Starts SSH access on an owned VM or Bare Metal reservation. If the reservation already has machines (for example after activation), launch sends the selected SSH keys to them and returns 202 with the current nodes. Otherwise launch selects nodes for the reservation, starts provisioning, and returns 201. Either response is acceptance, not readiness: poll the reservation's VMs or the node until SSH is ready. Repeating launch after machines exist does not reprovision them; it sends the keys again. ssh_key_ids adds keys to the reservation's saved list. Without it, launch uses the saved list, including an empty list. With no earlier selection, launch saves every active SSH key in your organization. There is no VM size option: each VM receives its reserved GPUs and a matching share of the host's vCPUs, memory, and local disk, with at most 3 TiB of RAM on compatible hosts. Launch does not attach storage volumes. Use Kubernetes or Slurm cluster routes for those access modes.\",\"dateModified\":\"2026-11-09T21:06:49.080Z\",\"isPartOf\":{\"@id\":\"https://docs.ornn.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ornn.com/api-reference/virtual-machines/launch#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ornn.com/api-reference/virtual-machines/launch#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"VM and Bare Metal\",\"item\":\"https://docs.ornn.com/api-reference/virtual-machines/set-image\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Launch VM or Bare Metal access\",\"item\":\"https://docs.ornn.com/api-reference/virtual-machines/launch\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.ornn.com/api-reference/virtual-machines/launch#apireference\",\"headline\":\"Launch VM or Bare Metal access\",\"name\":\"Launch VM or Bare Metal access\",\"description\":\"Starts SSH access on an owned VM or Bare Metal reservation. If the reservation already has machines (for example after activation), launch sends the selected SSH keys to them and returns 202 with the current nodes. Otherwise launch selects nodes for the reservation, starts provisioning, and returns 201. Either response is acceptance, not readiness: poll the reservation's VMs or the node until SSH is ready. Repeating launch after machines exist does not reprovision them; it sends the keys again. ssh_key_ids adds keys to the reservation's saved list. Without it, launch uses the saved list, including an empty list. With no earlier selection, launch saves every active SSH key in your organization. There is no VM size option: each VM receives its reserved GPUs and a matching share of the host's vCPUs, memory, and local disk, with at most 3 TiB of RAM on compatible hosts. Launch does not attach storage volumes. Use Kubernetes or Slurm cluster routes for those access modes.\",\"url\":\"https://docs.ornn.com/api-reference/virtual-machines/launch\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ornn.com/api-reference/virtual-machines/launch#webpage\"},\"dateModified\":\"2026-11-09T21:06:49.080Z\",\"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","description":"Requests machines for a VM or Bare Metal reservation during its reserved window. Ornn also activates reservations automatically when their window starts, so you only need this call to start sooner within the window or to retry a pending activation. A VM reservation gets one VM per reserved node, booted from the saved disk; a Bare Metal reservation is assigned its hosts. Activation provisions machines with the reservation's saved SSH-key selection; with no earlier selection, it saves all active organization keys. A 200 response means machines were requested, not that they are reachable. Wait for readiness and verify key delivery before connecting. Repeating the call on an activated reservation returns it unchanged. If you receive 409 runtime_pending, repeat the same request. Kubernetes and Slurm reservations use the cluster routes instead. Requires organization membership.","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","description":"Returns the reservation's VMs, oldest first, with their status, latest operation, grouped launch progress, and SSH details. Deleted VMs are omitted. ip and port appear while a VM is provisioning or running; tenant_username and ready_at appear only when it is running. Connect when status is running, using the returned ip, port, and tenant_username. Poll every five seconds with a deadline while any VM is provisioning or deleting. A failed VM carries failure with a code and message. You can read this list after the reservation ends.","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","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}","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":"Get an offer","openapi":"openapi.yaml GET /v1/markets/offers/{offerId}","href":"/api-reference/reserve/get-offer"},{"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":"Launch VM or Bare Metal access - 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"]}