Skip to main content
POST
Buy Market windows
Send a new Idempotency-Key for each purchase. If the response is lost, retry with the same key and body to get the original result instead of buying twice. ornn schedules buy does not send a term or node count, so it works only on listings without terms and always buys every node. Use this endpoint for listings with terms. See Buy relisted capacity.

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 characters for this operation, such as a UUID. Retrying with the same key and the same body returns the original result with HTTP 200 instead of creating a second one. The key is remembered for 24 hours per organization; reusing it for a different request returns 409 idempotency_conflict. A missing key returns 400 idempotency_key_required.

Required string length: 1 - 200

Body

application/json
legs
object[]
required

Windows to buy together. All legs succeed or none do; legs may not overlap.

Required array length: 1 - 50 elements

Response

A retry with the same Idempotency-Key and body; returns the original purchases.

purchases
object[]
required