{
"detail": {
"code": "invalid_id",
"message": "That capacity or financial term ID is not valid."
}
}
{
"code": "<string>",
"detail": "<string>"
}
{
"detail": {
"code": "forbidden",
"message": "Your account cannot make this change."
}
}
{
"detail": {
"code": "listing_has_active_reservations",
"message": "This listing cannot be withdrawn while a non-Spot reservation is active. Wait until it ends and try again."
}
}
Updates a listing your organization owns. An available reservation relist with no purchases or purchase holds can update nodeCount, availableAt, availableUntil and existing terms atomically; include an Idempotency-Key and explicit Reserved or Spot term types. Hardware specifications remain inherited. Date-only edits remain allowed after a purchase when the new availability covers all accepted bookings and existing reservations and fits within the parent reservation. Send state separately, without terms, to pause, resume or withdraw. Moving a listing to draft or delisted is refused while a non-Spot reservation is active. Running Spot rentals receive their notice; windows already sold stay sold.
{
"detail": {
"code": "invalid_id",
"message": "That capacity or financial term ID is not valid."
}
}
{
"code": "<string>",
"detail": "<string>"
}
{
"detail": {
"code": "forbidden",
"message": "Your account cannot make this change."
}
}
{
"detail": {
"code": "listing_has_active_reservations",
"message": "This listing cannot be withdrawn while a non-Spot reservation is active. Wait until it ends and try again."
}
}
In Nodes → Listings, use Manage listing → Edit on an unsold listing. You can change its node count, availability, price, and Reserved, Spot, or On-demand terms. Price and Term edit icons on its detail page open the corresponding step.The API saves listing fields and existing terms together. Include each term’s listingTermsId, complete financial fields, and explicit type, and send an Idempotency-Key. Reuse the key and identical body when retrying. Edits require an available reservation relist with no purchases or purchase holds; its specifications remain inherited from the reservation.You can send availableAt and availableUntil alone even after a purchase. The new window must cover all accepted bookings and existing reservations and remain within your original reservation. Exact booking boundaries are allowed; dates that cut into a booked window are refused.To pause or resume, send state separately, without terms. To withdraw a listing, you can also call Delist your listing, which ornn capacity-offers delist uses. A running Spot rental gets one hour of notice.To remove unsold capacity immediately, send only nodeCount with the number of nodes to keep. Send zero to withdraw a fully unsold listing. This never interrupts a rental: the request is refused if it would remove capacity in use or held for a purchase. Use an Idempotency-Key and reuse it for retries. The console offers this as Remove from listing for selected unsold nodes.
Supplier-authorized updates only; customer relist owners cannot set this field, including null, and it cannot change once the listing is reserved or held. Rated kilowatts per node from 0 to 1,000,000 with at most 12 fractional digits. Omit to preserve the current rating, send null to clear it to unknown, or "0" to record known zero. Do not send totalPowerKw; it is calculated from the saved node count.
Whole nodes to keep. Send with terms to edit an unsold reservation relist. Send alone to reduce unsold capacity without interrupting rentals; zero withdraws a fully unsold listing. Existing purchases and holds are protected.
Rated power per node in kilowatts, from 0 to 1,000,000 with at most 12 fractional digits. Null means unknown; "0" is known zero. This is not measured power draw.
Rated powerPerNodeKw multiplied by capacityNodeCount, as an exact decimal string. Null when per-node power is unknown. This uses total listed capacity, not online or available capacity.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ornn","description":"Ornn: The Omnicloud for AI Workloads\nOrnn is an omnicloud for high-performance GPU compute. Reserve capacity, manage your reservations, and connect via VM, Bare Metal, Kubernetes, or Slurm.","colors":{"primary":"#000000","light":"#F3F3F3","dark":"#0B0B0C"},"logo":{"light":"https://mintcdn.com/ornn/kJ0iqH_E0L2Jw6j6/images/ornn-docs-logo-light.svg?fit=max\u0026auto=format\u0026n=kJ0iqH_E0L2Jw6j6\u0026q=85\u0026s=6f5b0c872f8bb7b4b5b6b8ab492dc2a6","dark":"https://mintcdn.com/ornn/kJ0iqH_E0L2Jw6j6/images/ornn-docs-logo-dark.svg?fit=max\u0026auto=format\u0026n=kJ0iqH_E0L2Jw6j6\u0026q=85\u0026s=518cd92bb74cb6eb82ac33e462421918","href":"https://ornn.com"},"favicon":"https://mintcdn.com/ornn/fNQRwmmR9H-yzza5/favicon.png?fit=max\u0026auto=format\u0026n=fNQRwmmR9H-yzza5\u0026q=85\u0026s=ae08364c28579651525833a71bd8ec7c","api":{"examples":{"languages":["curl","python","javascript","php","go","java","ruby"]}},"appearance":{"default":"dark","strict":true},"background":{"color":{"light":"#FFFFFF","dark":"#0B0B0C"}},"navbar":{"links":[{"href":"/changelog","label":"Changelog"}],"primary":{"type":"button","label":"Visit Ornn","href":"https://ornn.com"}},"footer":{"socials":{"x":"https://x.com/OrnnExchange","linkedin":"https://www.linkedin.com/company/ornn"}},"fonts":{"family":"PP Neue Montreal Regular","weight":400,"source":"fonts/PPNeueMontreal-Regular.woff2","format":"woff2"},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","latex":true},"contextual":{"options":["copy","view","assistant","chatgpt","claude","perplexity","grok","aistudio","devin","windsurf","mcp","add-mcp","cursor","vscode","devin-mcp","download-spec"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ornn","hasAudioNarration":false,"actualSubdomain":"ornn","customDomains":["docs.ornn.com"],"gitSource":{"type":"github","owner":"ornn-ai","repo":"fabric","deployBranch":"main","contentDirectory":"docs-site","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af228bd2b97ba9fc64bce19","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"API reference","count":122},{"language":"default","tag":"Guides","count":30},{"language":"default","tag":"Storage","count":17},{"language":"default","tag":"VM and Bare Metal","count":13},{"language":"default","tag":"Private networks","count":12},{"language":"default","tag":"Order books","count":11},{"language":"default","tag":"Billing","count":10},{"language":"default","tag":"Disks","count":10},{"language":"default","tag":"Accessing Compute","count":9},{"language":"default","tag":"Monitoring","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@ornn.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","href":"/_mintlify/custom/ornn/0f3bb7ade51d2cb7/style.css"}],"page":{"pagePath":"api-reference/relist/update-listing","slug":"/api-reference/relist/update-listing","pageMetadata":{"title":"Update your listing","openapi":"openapi.yaml PATCH /commerce/v2/listings/{listingId}","description":"Updates a listing your organization owns. An available reservation relist with no purchases or purchase holds can update nodeCount, availableAt, availableUntil and existing terms atomically; include an Idempotency-Key and explicit Reserved or Spot term types. Hardware specifications remain inherited. Date-only edits remain allowed after a purchase when the new availability covers all accepted bookings and existing reservations and fits within the parent reservation. Send state separately, without terms, to pause, resume or withdraw. Moving a listing to draft or delisted is refused while a non-Spot reservation is active. Running Spot rentals receive their notice; windows already sold stay sold.","href":"/api-reference/relist/update-listing"},"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: \"Updates a listing your organization owns. An available reservation relist with no purchases or purchase holds can update nodeCount, availableAt, availableUntil and existing terms atomically; include an Idempotency-Key and explicit Reserved or Spot term types. Hardware specifications remain inherited. Date-only edits remain allowed after a purchase when the new availability covers all accepted bookings and existing reservations and fits within the parent reservation. Send state separately, without terms, to pause, resume or withdraw. Moving a listing to draft or delisted is refused while a non-Spot reservation is active. Running Spot rentals receive their notice; windows already sold stay sold.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components};return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`In `,_jsx(_components.strong,{children:`Nodes → Listings`}),`, use `,_jsx(_components.strong,{children:`Manage listing → Edit`}),` on an unsold listing. You can change its node count, availability, price, and Reserved, Spot, or On-demand terms. Price and Term edit icons on its detail page open the corresponding step.`]}),`\n`,_jsxs(_components.p,{children:[`The API saves listing fields and existing terms together. Include each term’s `,_jsx(_components.code,{children:`listingTermsId`}),`, complete financial fields, and explicit `,_jsx(_components.code,{children:`type`}),`, and send an `,_jsx(_components.code,{children:`Idempotency-Key`}),`. Reuse the key and identical body when retrying. Edits require an available reservation relist with no purchases or purchase holds; its specifications remain inherited from the reservation.`]}),`\n`,_jsxs(_components.p,{children:[`You can send `,_jsx(_components.code,{children:`availableAt`}),` and `,_jsx(_components.code,{children:`availableUntil`}),` alone even after a purchase. The new window must cover all accepted bookings and existing reservations and remain within your original reservation. Exact booking boundaries are allowed; dates that cut into a booked window are refused.`]}),`\n`,_jsxs(_components.p,{children:[`To pause or resume, send `,_jsx(_components.code,{children:`state`}),` separately, without `,_jsx(_components.code,{children:`terms`}),`. To withdraw a listing, you can also call `,_jsx(_components.a,{href:`/api-reference/relist/delist`,children:`Delist your listing`}),`, which `,_jsx(_components.code,{children:`ornn capacity-offers delist`}),` uses. A running Spot rental gets one hour of notice.`]}),`\n`,_jsxs(_components.p,{children:[`To remove unsold capacity immediately, send only `,_jsx(_components.code,{children:`nodeCount`}),` with the number of nodes to keep. Send zero to withdraw a fully unsold listing. This never interrupts a rental: the request is refused if it would remove capacity in use or held for a purchase. Use an `,_jsx(_components.code,{children:`Idempotency-Key`}),` and reuse it for retries. The console offers this as `,_jsx(_components.strong,{children:`Remove from listing`}),` for selected unsold nodes.`]})]})}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":"Update your listing","openapi":"openapi.yaml PATCH /commerce/v2/listings/{listingId}","description":"Updates a listing your organization owns. An available reservation relist with no purchases or purchase holds can update nodeCount, availableAt, availableUntil and existing terms atomically; include an Idempotency-Key and explicit Reserved or Spot term types. Hardware specifications remain inherited. Date-only edits remain allowed after a purchase when the new availability covers all accepted bookings and existing reservations and fits within the parent reservation. Send state separately, without terms, to pause, resume or withdraw. Moving a listing to draft or delisted is refused while a non-Spot reservation is active. Running Spot rentals receive their notice; windows already sold stay sold.","href":"/api-reference/relist/update-listing"}}},"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":{"operationId":"capacityUpdateListing","summary":"Update your listing","tags":["Relist"],"description":"Updates a listing your organization owns. An available reservation relist with no purchases or purchase holds can update nodeCount, availableAt, availableUntil and existing terms atomically; include an Idempotency-Key and explicit Reserved or Spot term types. Hardware specifications remain inherited. Date-only edits remain allowed after a purchase when the new availability covers all accepted bookings and existing reservations and fits within the parent reservation. Send state separately, without terms, to pause, resume or withdraw. Moving a listing to draft or delisted is refused while a non-Spot reservation is active. Running Spot rentals receive their notice; windows already sold stay sold.","parameters":["d60b349e-d4f6-45e1-b649-e3c61408e9ba","56834b55-aae3-48e0-b264-17cd32e4cd64"],"requestBody":"371289b9-8748-40ec-b14d-6adf2fd85ca7","responses":{"200":"b2dd1229-0f54-4d89-a7d3-d7ea9a952edd","400":"f6c2c426-56c6-408e-8f7e-5d8e8b4dfa4a","401":"16a0c543-6c0f-4f8d-ba1b-f5f68608bd9b","403":"02e9d4b4-2125-41b1-abcf-6e56fc2da9a8","409":"c18a5cb9-4e93-4633-a764-d69f33095f51","422":"a0a3c98a-7a09-4bf8-923b-58fe5c1b90dd","default":"941b987a-0d2b-49bc-a2f9-f087d0329f43"},"method":"patch","type":"path","servers":["6c9d2719-818c-44a7-9ca6-2edfbdaa6d61"],"security":["eab2b1d2-04d0-434f-b42f-337672534c39"],"path":"/commerce/v2/listings/{listingId}","baseUrlOptions":["https://api.ornn.com"],"title":"Update your listing","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","php","go","java","ruby"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"d60b349e-d4f6-45e1-b649-e3c61408e9ba":{"name":"listingId","in":"path","required":true,"description":"Listing ID (capacityListingId or listingId).","schema":{"type":"string","format":"uuid","isRequired":true,"description":"Listing ID (capacityListingId or listingId).","uniqueKey":"","typeLabel":"string\u003cuuid>"},"example":"77777777-7777-4777-8777-777777777777"},"56834b55-aae3-48e0-b264-17cd32e4cd64":{"name":"Idempotency-Key","in":"header","description":"Required when editing terms. Reuse the same key and body when retrying.","schema":{"type":"string","description":"Required when editing terms. Reuse the same key and body when retrying.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"powerPerNodeKw":{"oneOf":[{"type":"string","pattern":"^(?:(?:0|[1-9][0-9]{0,5})(?:\\.[0-9]{1,12})?|1000000(?:\\.0{1,12})?)$","description":"Supplier-authorized updates only; customer relist owners cannot set this field, including null, and it cannot change once the listing is reserved or held. Rated kilowatts per node from 0 to 1,000,000 with at most 12 fractional digits. Omit to preserve the current rating, send null to clear it to unknown, or \"0\" to record known zero. Do not send totalPowerKw; it is calculated from the saved node count.","examples":["10.2","0",null],"uniqueKey":"powerPerNodeKw.oneOf.0","typeLabel":"string"},{"type":"null","pattern":"^(?:(?:0|[1-9][0-9]{0,5})(?:\\.[0-9]{1,12})?|1000000(?:\\.0{1,12})?)$","description":"Supplier-authorized updates only; customer relist owners cannot set this field, including null, and it cannot change once the listing is reserved or held. Rated kilowatts per node from 0 to 1,000,000 with at most 12 fractional digits. Omit to preserve the current rating, send null to clear it to unknown, or \"0\" to record known zero. Do not send totalPowerKw; it is calculated from the saved node count.","examples":["10.2","0",null],"uniqueKey":"powerPerNodeKw.oneOf.1","typeLabel":"null"}],"uniqueKey":"powerPerNodeKw","typeLabel":"string | null"},"state":{"type":"string","enum":["draft","available","delisted"],"description":"draft takes the listing off sale without delisting it; available puts it back on sale; delisted withdraws it, like the delist operation.","uniqueKey":"state","typeLabel":"enum\u003cstring>"},"nodeCount":{"type":"integer","minimum":0,"description":"Whole nodes to keep. Send with terms to edit an unsold reservation relist. Send alone to reduce unsold capacity without interrupting rentals; zero withdraws a fully unsold listing. Existing purchases and holds are protected.","uniqueKey":"nodeCount","typeLabel":"integer"},"availableAt":{"type":"string","format":"date-time","description":"Relist start within the source reservation. Send with terms.","uniqueKey":"availableAt","typeLabel":"string\u003cdate-time>"},"availableUntil":{"oneOf":[{"type":"string","format":"date-time","description":"Availability end within the source reservation; null is allowed only when the source has no committed end.","uniqueKey":"availableUntil.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Availability end within the source reservation; null is allowed only when the source has no committed end.","uniqueKey":"availableUntil.oneOf.1","typeLabel":"null"}],"uniqueKey":"availableUntil","typeLabel":"string\u003cdate-time> | null"},"terms":{"type":"array","minItems":1,"description":"Existing terms of an unsold reservation relist, saved atomically. Requires Idempotency-Key. Do not send state with terms.","items":{"type":"object","required":["listingTermsId","type","minDurationHours","maxDurationHours","pricePerGpuHourMicroUsd","renewable"],"properties":{"listingTermsId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"terms.items.[INDEX].listingTermsId","typeLabel":"string\u003cuuid>"},"type":{"type":"string","enum":["reserved","spot","on-demand"],"isRequired":true,"uniqueKey":"terms.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"minDurationHours":{"type":"number","exclusiveMinimum":0,"isRequired":true,"uniqueKey":"terms.items.[INDEX].minDurationHours","typeLabel":"number"},"maxDurationHours":{"type":"number","exclusiveMinimum":0,"isRequired":true,"uniqueKey":"terms.items.[INDEX].maxDurationHours","typeLabel":"number"},"pricePerGpuHourMicroUsd":{"type":"integer","format":"int64","minimum":1,"isRequired":true,"uniqueKey":"terms.items.[INDEX].pricePerGpuHourMicroUsd","typeLabel":"integer\u003cint64>"},"renewable":{"type":"boolean","isRequired":true,"uniqueKey":"terms.items.[INDEX].renewable","typeLabel":"boolean"},"downPaymentCents":{"type":"null","description":"Reservation relists have no down payment.","uniqueKey":"terms.items.[INDEX].downPaymentCents","typeLabel":"null"}},"uniqueKey":"terms.items.[INDEX]","typeLabel":"object"},"uniqueKey":"terms","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"state":"draft"},"examples":{"Example":{"title":"Example","value":{"state":"draft"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"b2dd1229-0f54-4d89-a7d3-d7ea9a952edd":{"description":"The updated listing.","content":{"application/json":{"schema":{"type":"object","description":"A capacity listing's hardware, size, and availability. Read prices from its terms.","required":["capacityListingId","kind","state","gpuSlug","gpusPerNode","capacityNodeCount"],"properties":{"capacityListingId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"capacityListingId","typeLabel":"string\u003cuuid>"},"kind":{"type":"string","enum":["primary","secondary","on_demand"],"description":"primary for Reserve listings; secondary for relisted capacity.","isRequired":true,"uniqueKey":"kind","typeLabel":"enum\u003cstring>"},"state":{"type":"string","description":"draft, available, held, sold, or delisted. Handle unrecognized values.","isRequired":true,"uniqueKey":"state","typeLabel":"string"},"gpuSlug":{"oneOf":[{"type":"string","description":"Catalog GPU slug. Null for CPU capacity, nodes without GPUs.","isRequired":true,"uniqueKey":"gpuSlug.oneOf.0","typeLabel":"string"},{"type":"null","description":"Catalog GPU slug. Null for CPU capacity, nodes without GPUs.","isRequired":true,"uniqueKey":"gpuSlug.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"gpuSlug","typeLabel":"string | null"},"gpusPerNode":{"type":"integer","description":"GPUs per node; 0 for CPU capacity.","isRequired":true,"uniqueKey":"gpusPerNode","typeLabel":"integer"},"capacityNodeCount":{"type":"integer","isRequired":true,"uniqueKey":"capacityNodeCount","typeLabel":"integer"},"listingNumber":{"type":"integer","description":"A short reference number. Use capacityListingId in API paths.","uniqueKey":"listingNumber","typeLabel":"integer"},"parentReservationId":{"oneOf":[{"type":"string","format":"uuid","description":"Set on relisted capacity: the reservation it was relisted from.","uniqueKey":"parentReservationId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Set on relisted capacity: the reservation it was relisted from.","uniqueKey":"parentReservationId.oneOf.1","typeLabel":"null"}],"uniqueKey":"parentReservationId","typeLabel":"string\u003cuuid> | null"},"coresPerNode":{"oneOf":[{"type":"integer","minimum":1,"description":"CPU capacity only. Cores each node sells, at least 1; each core is 2 vCPUs. Terms are priced per vCPU-hour. Null for GPU capacity.","uniqueKey":"coresPerNode.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":1,"description":"CPU capacity only. Cores each node sells, at least 1; each core is 2 vCPUs. Terms are priced per vCPU-hour. Null for GPU capacity.","uniqueKey":"coresPerNode.oneOf.1","typeLabel":"null"}],"uniqueKey":"coresPerNode","typeLabel":"integer | null"},"powerPerNodeKw":{"oneOf":[{"type":"string","pattern":"^(?:(?:0|[1-9][0-9]{0,5})(?:\\.[0-9]{1,12})?|1000000(?:\\.0{1,12})?)$","description":"Rated power per node in kilowatts, from 0 to 1,000,000 with at most 12 fractional digits. Null means unknown; \"0\" is known zero. This is not measured power draw.","examples":["10.2","0",null],"uniqueKey":"powerPerNodeKw.oneOf.0","typeLabel":"string"},{"type":"null","pattern":"^(?:(?:0|[1-9][0-9]{0,5})(?:\\.[0-9]{1,12})?|1000000(?:\\.0{1,12})?)$","description":"Rated power per node in kilowatts, from 0 to 1,000,000 with at most 12 fractional digits. Null means unknown; \"0\" is known zero. This is not measured power draw.","examples":["10.2","0",null],"uniqueKey":"powerPerNodeKw.oneOf.1","typeLabel":"null"}],"uniqueKey":"powerPerNodeKw","typeLabel":"string | null"},"totalPowerKw":{"oneOf":[{"type":"string","readOnly":true,"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,12})?$","description":"Rated powerPerNodeKw multiplied by capacityNodeCount, as an exact decimal string. Null when per-node power is unknown. This uses total listed capacity, not online or available capacity.","examples":["40.8","0",null],"uniqueKey":"totalPowerKw.oneOf.0","typeLabel":"string"},{"type":"null","readOnly":true,"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,12})?$","description":"Rated powerPerNodeKw multiplied by capacityNodeCount, as an exact decimal string. Null when per-node power is unknown. This uses total listed capacity, not online or available capacity.","examples":["40.8","0",null],"uniqueKey":"totalPowerKw.oneOf.1","typeLabel":"null"}],"uniqueKey":"totalPowerKw","typeLabel":"string | null"},"facilityId":{"type":"string","format":"uuid","uniqueKey":"facilityId","typeLabel":"string\u003cuuid>"},"provisioningType":{"type":"string","enum":["bare-metal","virtual-machine"],"uniqueKey":"provisioningType","typeLabel":"enum\u003cstring>"},"availableAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"availableAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"availableAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"availableAt","typeLabel":"string\u003cdate-time> | null"},"availableUntil":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"availableUntil.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"availableUntil.oneOf.1","typeLabel":"null"}],"uniqueKey":"availableUntil","typeLabel":"string\u003cdate-time> | null"},"daysToRfs":{"oneOf":[{"type":"integer","description":"Readiness lead time in days when the listing has no fixed dates.","uniqueKey":"daysToRfs.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Readiness lead time in days when the listing has no fixed dates.","uniqueKey":"daysToRfs.oneOf.1","typeLabel":"null"}],"uniqueKey":"daysToRfs","typeLabel":"integer | null"},"cpu":{"oneOf":[{"type":"string","uniqueKey":"cpu.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"cpu.oneOf.1","typeLabel":"null"}],"uniqueKey":"cpu","typeLabel":"string | null"},"ram":{"oneOf":[{"type":"string","uniqueKey":"ram.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"ram.oneOf.1","typeLabel":"null"}],"uniqueKey":"ram","typeLabel":"string | null"},"storage":{"oneOf":[{"type":"string","uniqueKey":"storage.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"storage.oneOf.1","typeLabel":"null"}],"uniqueKey":"storage","typeLabel":"string | null"},"fabricType":{"oneOf":[{"type":"string","description":"GPU interconnect.","uniqueKey":"fabricType.oneOf.0","typeLabel":"string"},{"type":"null","description":"GPU interconnect.","uniqueKey":"fabricType.oneOf.1","typeLabel":"null"}],"uniqueKey":"fabricType","typeLabel":"string | null"},"internet":{"oneOf":[{"type":"string","description":"Internet bandwidth.","uniqueKey":"internet.oneOf.0","typeLabel":"string"},{"type":"null","description":"Internet bandwidth.","uniqueKey":"internet.oneOf.1","typeLabel":"null"}],"uniqueKey":"internet","typeLabel":"string | null"},"createdAt":{"type":"string","format":"date-time","uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"example":{"capacityListingId":"eeeeeeee-eeee-4eee-8eee-eeeeeeeeeeee","listingNumber":1188,"parentReservationId":"11111111-1111-4111-8111-111111111111","kind":"secondary","state":"draft","gpuSlug":"nvidia_h100_sxm","gpusPerNode":8,"capacityNodeCount":2,"facilityId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc","provisioningType":"virtual-machine","availableAt":"2026-10-20T00:00:00Z","availableUntil":"2026-11-03T00:00:00Z","daysToRfs":null,"cpu":"2x 56-core x86","ram":"2 TB","storage":"8x 3.84 TB NVMe","fabricType":"InfiniBand 3.2 Tbps","internet":"10 Gbps","createdAt":"2026-10-14T18:30:00Z","updatedAt":"2026-10-14T18:30:00Z"},"examples":{"Example":{"title":"Example","value":{"capacityListingId":"eeeeeeee-eeee-4eee-8eee-eeeeeeeeeeee","listingNumber":1188,"parentReservationId":"11111111-1111-4111-8111-111111111111","kind":"secondary","state":"draft","gpuSlug":"nvidia_h100_sxm","gpusPerNode":8,"capacityNodeCount":2,"facilityId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc","provisioningType":"virtual-machine","availableAt":"2026-10-20T00:00:00Z","availableUntil":"2026-11-03T00:00:00Z","daysToRfs":null,"cpu":"2x 56-core x86","ram":"2 TB","storage":"8x 3.84 TB NVMe","fabricType":"InfiniBand 3.2 Tbps","internet":"10 Gbps","createdAt":"2026-10-14T18:30:00Z","updatedAt":"2026-10-14T18:30:00Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"f6c2c426-56c6-408e-8f7e-5d8e8b4dfa4a":{"description":"Malformed body, unknown field, or invalid ID.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"code":{"type":"string","uniqueKey":"oneOf.0.code","typeLabel":"string"},"detail":{"oneOf":[{"type":"string","uniqueKey":"oneOf.0.detail.oneOf.0","typeLabel":"string"},{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.detail.oneOf.1.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.detail.oneOf.1.message","typeLabel":"string"}},"uniqueKey":"oneOf.0.detail.oneOf.1","typeLabel":"object"}],"uniqueKey":"oneOf.0.detail","typeLabel":"string | object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Returned for a malformed JSON body or an unknown field.","example":{"error":"invalid request body"},"properties":{"error":{"type":"string","uniqueKey":"oneOf.1.error","typeLabel":"string"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"example":{"detail":{"code":"invalid_id","message":"That capacity or financial term ID is not valid."}},"examples":{"Example":{"title":"Example","value":{"detail":{"code":"invalid_id","message":"That capacity or financial term ID is not valid."}}}},"exampleType":"examples"}},"exampleType":"examples"},"16a0c543-6c0f-4f8d-ba1b-f5f68608bd9b":{"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"},"02e9d4b4-2125-41b1-abcf-6e56fc2da9a8":{"description":"Your organization does not own the listing.","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":"forbidden","message":"Your account cannot make this change."}},"examples":{"Example":{"title":"Example","value":{"detail":{"code":"forbidden","message":"Your account cannot make this change."}}}},"exampleType":"examples"}},"exampleType":"examples"},"c18a5cb9-4e93-4633-a764-d69f33095f51":{"description":"A non-Spot reservation is active, or a fixed field changed.","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":"listing_has_active_reservations","message":"This listing cannot be withdrawn while a non-Spot reservation is active. Wait until it ends and try again."}},"examples":{"Example":{"title":"Example","value":{"detail":{"code":"listing_has_active_reservations","message":"This listing cannot be withdrawn while a non-Spot reservation is active. Wait until it ends and try again."}}}},"exampleType":"examples"}},"exampleType":"examples"},"a0a3c98a-7a09-4bf8-923b-58fe5c1b90dd":{"description":"Unknown state.","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":"invalid_state","message":"Choose draft, available, or delisted."}},"examples":{"Example":{"title":"Example","value":{"detail":{"code":"invalid_state","message":"Choose draft, available, or delisted."}}}},"exampleType":"examples"}},"exampleType":"examples"},"941b987a-0d2b-49bc-a2f9-f087d0329f43":{"description":"Unsuccessful request. Check HTTP status first. Errors may have detail.code/detail.message, a string detail and optional top-level code, or an empty/non-JSON body. 401: invalid credential; 403: access or Reserve approval required; 404: not visible or credentials not ready; 409: lifecycle conflict; 429: back off; 5xx: service failure. Inspect current state before retrying mutations.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"detail.oneOf.1.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"detail.oneOf.1.message","typeLabel":"string"}},"uniqueKey":"detail.oneOf.1","typeLabel":"object"}],"uniqueKey":"detail","typeLabel":"string | object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"\u003cstring>","detail":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"eab2b1d2-04d0-434f-b42f-337672534c39":{"OrnnApiKey":{"type":"http","scheme":"bearer","bearerFormat":"ornn_sk_...","description":"Create an organization API key in Account Settings > Developer. Do not send this key to the Kubernetes API server.","scopes":[],"schemeName":"OrnnApiKey"}}},"servers":{"6c9d2719-818c-44a7-9ca6-2edfbdaa6d61":{"url":"https://api.ornn.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"ornn_sk_...","description":"Create an organization API key in Account Settings > Developer. Do not send this key to the Kubernetes API server.","scopes":[],"schemeName":"OrnnApiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Create an organization API key in Account Settings > Developer. Do not send this key to the Kubernetes API server.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"OrnnApiKey","name":"Authorization"}],"title":"OrnnApiKey"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"ornn","siteName":"Ornn","title":"Update your listing - Ornn","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-05T00:36:21.575Z","originalFileLocation":"api-reference/relist/update-listing.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=\"Updates a listing your organization owns. An available reservation relist with no purchases or purchase holds can update nodeCount, availableAt, availableUntil and existing terms atomically; include an Idempotency-Key and explicit Reserved or Spot term types. Hardware specifications remain inherited. Date-only edits remain allowed after a purchase when the new availability covers all accepted bookings and existing reservations and fits within the parent reservation. Send state separately, without terms, to pause, resume or withdraw. Moving a listing to draft or delisted is refused while a non-Spot reservation is active. Running Spot rentals receive their notice; windows already sold stay sold.\">\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=\"Update your listing - Ornn\">\u003cmeta data-mint-head property=\"og:description\" content=\"Updates a listing your organization owns. An available reservation relist with no purchases or purchase holds can update nodeCount, availableAt, availableUntil and existing terms atomically; include an Idempotency-Key and explicit Reserved or Spot term types. Hardware specifications remain inherited. Date-only edits remain allowed after a purchase when the new availability covers all accepted bookings and existing reservations and fits within the parent reservation. Send state separately, without terms, to pause, resume or withdraw. Moving a listing to draft or delisted is refused while a non-Spot reservation is active. Running Spot rentals receive their notice; windows already sold stay sold.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ornn\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ornn.com/api-reference/relist/update-listing\">\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=Relist\u0026amp;title=Update+your+listing\u0026amp;description=Updates+a+listing+your+organization+owns.+An+available+reservation+relist+with+no+purchases+or+purchase+holds+can+update+nodeCount%2C+availableAt%2C+availableUntil+\u0026amp;theme=3cb4facbf0c28da5810d277d\u0026amp;signature=f08124bf1061d43d416894155fddfdf44d7cfe6835397cb0aa1f95c6bc09cfbf\">\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=\"Update your listing - Ornn\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Updates a listing your organization owns. An available reservation relist with no purchases or purchase holds can update nodeCount, availableAt, availableUntil and existing terms atomically; include an Idempotency-Key and explicit Reserved or Spot term types. Hardware specifications remain inherited. Date-only edits remain allowed after a purchase when the new availability covers all accepted bookings and existing reservations and fits within the parent reservation. Send state separately, without terms, to pause, resume or withdraw. Moving a listing to draft or delisted is refused while a non-Spot reservation is active. Running Spot rentals receive their notice; windows already sold stay sold.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ornn.mintlify.site/_mintlify/api/og/v2?division=Relist\u0026amp;title=Update+your+listing\u0026amp;description=Updates+a+listing+your+organization+owns.+An+available+reservation+relist+with+no+purchases+or+purchase+holds+can+update+nodeCount%2C+availableAt%2C+availableUntil+\u0026amp;theme=3cb4facbf0c28da5810d277d\u0026amp;signature=f08124bf1061d43d416894155fddfdf44d7cfe6835397cb0aa1f95c6bc09cfbf\">\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/relist/update-listing\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/relist/update-listing.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/relist/update-listing#webpage\",\"url\":\"https://docs.ornn.com/api-reference/relist/update-listing\",\"name\":\"Update your listing\",\"description\":\"Updates a listing your organization owns. An available reservation relist with no purchases or purchase holds can update nodeCount, availableAt, availableUntil and existing terms atomically; include an Idempotency-Key and explicit Reserved or Spot term types. Hardware specifications remain inherited. Date-only edits remain allowed after a purchase when the new availability covers all accepted bookings and existing reservations and fits within the parent reservation. Send state separately, without terms, to pause, resume or withdraw. Moving a listing to draft or delisted is refused while a non-Spot reservation is active. Running Spot rentals receive their notice; windows already sold stay sold.\",\"dateModified\":\"2026-11-05T00:36:21.575Z\",\"isPartOf\":{\"@id\":\"https://docs.ornn.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ornn.com/api-reference/relist/update-listing#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ornn.com/api-reference/relist/update-listing#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Relist\",\"item\":\"https://docs.ornn.com/api-reference/relist/create\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Update your listing\",\"item\":\"https://docs.ornn.com/api-reference/relist/update-listing\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.ornn.com/api-reference/relist/update-listing#apireference\",\"headline\":\"Update your listing\",\"name\":\"Update your listing\",\"description\":\"Updates a listing your organization owns. An available reservation relist with no purchases or purchase holds can update nodeCount, availableAt, availableUntil and existing terms atomically; include an Idempotency-Key and explicit Reserved or Spot term types. Hardware specifications remain inherited. Date-only edits remain allowed after a purchase when the new availability covers all accepted bookings and existing reservations and fits within the parent reservation. Send state separately, without terms, to pause, resume or withdraw. Moving a listing to draft or delisted is refused while a non-Spot reservation is active. Running Spot rentals receive their notice; windows already sold stay sold.\",\"url\":\"https://docs.ornn.com/api-reference/relist/update-listing\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ornn.com/api-reference/relist/update-listing#webpage\"},\"dateModified\":\"2026-11-05T00:36:21.575Z\",\"publisher\":{\"@id\":\"https://docs.ornn.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ornn.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ornn\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Ornn","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"API reference","groups":[{"group":"Start here","pages":[{"title":"Integrate with the Ornn REST API","sidebarTitle":"Overview","href":"/api-reference/overview"},{"title":"Check API authentication","openapi":"openapi.yaml GET /v1/auth/session","href":"/api-reference/session"}]},{"group":"Reserved capacity","pages":[{"title":"List reservations","openapi":"openapi.yaml GET /commerce/reservations","href":"/api-reference/reservations/list"},{"title":"Get a reservation","openapi":"openapi.yaml GET /commerce/reservations/{reservationId}","href":"/api-reference/reservations/get"},{"title":"List reserved nodes","openapi":"openapi.yaml GET /v1/orchestrator/nodes","href":"/api-reference/nodes/list"}]},{"group":"VM and Bare Metal","pages":[{"title":"Choose a VM disk","openapi":"openapi.yaml PUT /commerce/reservations/{reservationId}/disk","href":"/api-reference/virtual-machines/set-image"},{"title":"Activate a reservation","openapi":"openapi.yaml POST /commerce/reservations/{reservationId}/activate","href":"/api-reference/virtual-machines/activate"},{"title":"Launch VM or Bare Metal access","openapi":"openapi.yaml POST /v1/orchestrator/nodes/reservations/{reservation_id}/launch","href":"/api-reference/virtual-machines/launch"},{"title":"List a reservation's VMs","openapi":"openapi.yaml GET /v1/orchestrator/reservations/{reservation_id}/virtual-machines","href":"/api-reference/virtual-machines/list"},{"title":"Reboot a VM","openapi":"openapi.yaml POST /v1/orchestrator/nodes/{node_id}/virtual-machines/{vm_id}/reboot","href":"/api-reference/virtual-machines/reboot"},{"title":"Reimage a VM","openapi":"openapi.yaml POST /v1/orchestrator/nodes/{node_id}/virtual-machines/{vm_id}/reimage","href":"/api-reference/virtual-machines/reimage"},{"title":"List a VM's ports","openapi":"openapi.yaml GET /v1/orchestrator/nodes/{node_id}/virtual-machines/{vm_id}/ports","href":"/api-reference/virtual-machines/list-ports"},{"title":"Open a VM port","openapi":"openapi.yaml POST /v1/orchestrator/nodes/{node_id}/virtual-machines/{vm_id}/ports","href":"/api-reference/virtual-machines/open-port"},{"title":"Close a VM port","openapi":"openapi.yaml DELETE /v1/orchestrator/nodes/{node_id}/virtual-machines/{vm_id}/ports/{port_id}","href":"/api-reference/virtual-machines/close-port"},{"title":"Get a reserved node","openapi":"openapi.yaml GET /v1/orchestrator/nodes/{node_id}","href":"/api-reference/bare-metal/get-node"},{"title":"Reboot or hard reset a Bare Metal host","openapi":"openapi.yaml POST /v1/orchestrator/nodes/{node_id}/reboot","href":"/api-reference/bare-metal/reboot"},{"title":"Switch access mode or network","openapi":"openapi.yaml POST /v1/orchestrator/nodes/reservations/{reservation_id}/switch-access","href":"/api-reference/virtual-machines/switch-access"},{"title":"Stop VMs or a reservation","openapi":"openapi.yaml DELETE /commerce/reservations/{reservationId}","href":"/api-reference/virtual-machines/stop"}]},{"group":"Disks","pages":[{"title":"List disks","openapi":"openapi.yaml GET /v1/orchestrator/disks","href":"/api-reference/disks/list"},{"title":"Get a disk","openapi":"openapi.yaml GET /v1/orchestrator/disks/{disk_id}","href":"/api-reference/disks/get"},{"title":"Create a disk","openapi":"openapi.yaml POST /v1/orchestrator/disks","href":"/api-reference/disks/create"},{"title":"Start a disk upload","openapi":"openapi.yaml POST /v1/orchestrator/disks/uploads","href":"/api-reference/disks/upload-start"},{"title":"Upload disk bytes","openapi":"openapi.yaml POST /v1/orchestrator/disks/objects","href":"/api-reference/disks/upload-bytes"},{"title":"Complete a disk upload","openapi":"openapi.yaml POST /v1/orchestrator/disks/uploads/{disk_id}/complete","href":"/api-reference/disks/upload-complete"},{"title":"Import a disk from a URL","openapi":"openapi.yaml POST /v1/orchestrator/disks/imports","href":"/api-reference/disks/import"},{"title":"Delete a disk","openapi":"openapi.yaml DELETE /v1/orchestrator/disks/{disk_id}","href":"/api-reference/disks/delete"},{"title":"List base images","openapi":"openapi.yaml GET /v1/orchestrator/catalog/images","href":"/api-reference/disks/list-images"},{"title":"List disk software","openapi":"openapi.yaml GET /v1/orchestrator/catalog/software","href":"/api-reference/disks/list-software"}]},{"group":"Clusters","pages":[{"title":"Create a cluster","openapi":"openapi.yaml POST /v1/orchestrator/controllers","href":"/api-reference/clusters/create"},{"title":"List clusters and workers","openapi":"openapi.yaml GET /v1/orchestrator/controllers","href":"/api-reference/clusters/list"},{"title":"Get cluster access","openapi":"openapi.yaml GET /v1/orchestrator/controllers/{controller_id}/access","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":"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","description":"Creates a listing that sells whole nodes from a reservation your organization holds, at your asking price, and puts it on sale immediately. Your reservation and its billing continue; buyers never see who relisted the capacity.\n\nRead the reservation first: relistableNodeCount and relistUnavailableReason describe what you can relist. The window must fit inside the reservation. An end may be null or omitted only when the source has no committed expiry; renewable reservations, including month-to-month contracts, cannot be relisted even if they have a scheduled end. Use a reserved term to sell windows in the Market (set minDurationHours to the shortest rental you accept and maxDurationHours no longer than the window), or a spot term (1 hour, renewable) to offer VM capacity on the order books. You can relist the same reservation again as long as relists that overlap in time do not sell more nodes together than it has. Buyers run on machines Ornn assigns when their rental starts. Spot and On-demand reservations cannot be relisted.\n\nRequires Idempotency-Key. Publication to the Market and the order books follows within moments of the response.","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","description":"Withdraws a listing your organization owns from new sales. Its unsold time leaves the Market, its asks are cancelled, and running Spot VMs on it end. Windows already sold stay sold. Refused while a non-Spot reservation on the listing is active. No request body is needed.","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":"Update your listing - 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"]}