Skip to main content
PATCH
Update your listing
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.

Authorizations

Authorization
string
header
required

Create an organization API key in Account Settings > Developer. Do not send this key to the Kubernetes API server.

Headers

Idempotency-Key
string

Required when editing terms. Reuse the same key and body when retrying.

Path Parameters

listingId
string<uuid>
required

Listing ID (capacityListingId or listingId).

Body

application/json
powerPerNodeKw
string | null

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.

Pattern: ^(?:(?:0|[1-9][0-9]{0,5})(?:\.[0-9]{1,12})?|1000000(?:\.0{1,12})?)$
Examples:

"10.2"

"0"

null

state
enum<string>

draft takes the listing off sale without delisting it; available puts it back on sale; delisted withdraws it, like the delist operation.

Available options:
draft,
available,
delisted
nodeCount
integer

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.

Required range: x >= 0
availableAt
string<date-time>

Relist start within the source reservation. Send with terms.

availableUntil
string<date-time> | null

Availability end within the source reservation; null is allowed only when the source has no committed end.

terms
object[]

Existing terms of an unsold reservation relist, saved atomically. Requires Idempotency-Key. Do not send state with terms.

Minimum array length: 1

Response

The updated listing.

A capacity listing's hardware, size, and availability. Read prices from its terms.

capacityListingId
string<uuid>
required
kind
enum<string>
required

primary for Reserve listings; secondary for relisted capacity.

Available options:
primary,
secondary,
on_demand
state
string
required

draft, available, held, sold, or delisted. Handle unrecognized values.

gpuSlug
string | null
required

Catalog GPU slug. Null for CPU capacity, nodes without GPUs.

gpusPerNode
integer
required

GPUs per node; 0 for CPU capacity.

capacityNodeCount
integer
required
listingNumber
integer

A short reference number. Use capacityListingId in API paths.

parentReservationId
string<uuid> | null

Set on relisted capacity: the reservation it was relisted from.

coresPerNode
integer | null

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.

Required range: x >= 1
powerPerNodeKw
string | null

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.

Pattern: ^(?:(?:0|[1-9][0-9]{0,5})(?:\.[0-9]{1,12})?|1000000(?:\.0{1,12})?)$
Examples:

"10.2"

"0"

null

totalPowerKw
string | null
read-only

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.

Pattern: ^(0|[1-9][0-9]*)(\.[0-9]{1,12})?$
Examples:

"40.8"

"0"

null

facilityId
string<uuid>
provisioningType
enum<string>
Available options:
bare-metal,
virtual-machine
availableAt
string<date-time> | null
availableUntil
string<date-time> | null
daysToRfs
integer | null

Readiness lead time in days when the listing has no fixed dates.

cpu
string | null
ram
string | null
storage
string | null
fabricType
string | null

GPU interconnect.

internet
string | null

Internet bandwidth.

createdAt
string<date-time>
updatedAt
string<date-time>