Skip to main content
POST
Post a Reserve offer
Send a new Idempotency-Key for each offer and reuse it only to retry that same request. ornn offers post does not send a term or duration, so it works only on listings without terms. Use this endpoint for listings with terms. See Reserve GPU 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

Path Parameters

listingId
string<uuid>
required

Listing ID (capacityListingId or listingId).

Body

application/json
pricePerGpuHourMicroUsd
integer<int64>
required

Your offer per GPU-hour in integer micro-USD. It can be below or above the term price.

Required range: x >= 1
listingTermId
string<uuid>

Required when the listing has terms. Choose a reserved term.

durationSeconds
integer

Whole seconds within the term's minDurationSeconds and maxDurationSeconds. Required unless the term's minimum equals its maximum.

Required range: x >= 1
downPaymentCents
integer<int64>

The down payment you offer, in whole cents. Omitted means 0. The console sends the selected term's downPaymentCents.

Required range: x >= 0

Response

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

offer
object
required