Skip to main content
POST
Add a term to your listing
Terms cannot be edited. To change a price, add a term with the new price, then delete the old term if nothing uses it. The console and CLI do not provide this operation.

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

Required. A unique key of 1 to 200 bytes for this operation, such as a UUID. Retrying with the same key and the same body returns the original response instead of writing again. The key is remembered for 24 hours; reusing it with a different body returns 409 idempotency_conflict. A missing key returns 422 invalid_idempotency_key.

Required string length: 1 - 200

Path Parameters

listingId
string<uuid>
required

Listing ID (capacityListingId or listingId).

Body

application/json
minDurationHours
number
required

Shortest window a buyer can take, in hours equal to whole seconds.

maxDurationHours
number
required

Longest window, in hours equal to whole seconds. Must fit inside the listing window.

pricePerGpuHourMicroUsd
integer<int64>
required

Your asking price: what you receive per GPU-hour, in integer micro-USD.

Required range: x >= 1
renewable
boolean
required
type
enum<string>

reserved (the default) sells fixed windows in the Market. spot offers the nodes' idle time on the Spot order book and requires VM capacity. spot and on-demand are hourly: set both durations to 1 and renewable to true.

Available options:
reserved,
spot,
on-demand
downPaymentCents
integer<int64> | null
Required range: x >= 0

Response

Term added.

listingTermsId
string<uuid>
required

Send as listingTermId in offers and purchases.

capacityListingId
string<uuid>
required
renewable
boolean
required
pricePerGpuHourMicroUsd
integer<int64>
required

The listing's price. On relisted capacity this is the seller's asking price before fees; buyers pay the schedule price instead.

type
enum<string> | null
Available options:
reserved,
spot,
on-demand,
null
minDurationHours
number | null
maxDurationHours
number | null
downPaymentCents
integer<int64> | null
createdAt
string<date-time>