> ## Documentation Index > Fetch the complete documentation index at: https://docs.ornn.com/llms.txt > Use this file to discover all available pages before exploring further. # Post a Reserve offer > Offers a price for a whole Reserve listing: every node, starting at the later of the listing's start and now, for the chosen duration. The listing owner accepts or declines. Your organization must be approved. When the listing has terms, send listingTermId for a reserved term and durationSeconds within its bounds (optional when the minimum equals the maximum). The offer is open until it is accepted, you cancel it, or another trade takes the window. Relisted (Market) capacity does not take offers. Requires Idempotency-Key. 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](/guides/reserving-compute#use-the-api). ## OpenAPI ````yaml openapi.yaml POST /v1/markets/schedules/{listingId}/offers openapi: 3.1.0 info: title: Ornn compute API version: 1.0.0 description: >- Customer HTTP API for Ornn GPU capacity. It covers reserved capacity and nodes, VM and Bare Metal access, Kubernetes and Slurm clusters, SSH keys, storage volumes and GitHub repositories, private networks, monitoring, buying and selling capacity (Reserve, Market, Spot, and Relist), and billing. API keys are scoped to one organization and act with their creator's access there; account, team, and API-key management stay in the console. Most operations require an approved organization. See https://docs.ornn.com/api-keys to create a key and https://docs.ornn.com/guides/kubernetes-api for an end-to-end Kubernetes integration. Examples use fictional IDs and credentials. The info.version field identifies the contract revision, not a shared API path version. contact: email: support@ornn.com servers: - url: https://api.ornn.com description: Production security: - OrnnApiKey: [] tags: - name: Authentication - name: Reservations - name: GPU nodes - name: Clusters - name: Workers - name: Virtual machines description: >- Choose a VM disk, launch VM access on a reservation, and read each VM's status, launch progress, and SSH connection details. - name: Bare Metal description: >- Launch Bare Metal access on a reservation, read a host's readiness and SSH connection details, and reboot or hard reset it. - name: SSH keys description: >- Register public keys for your organization, choose which keys a VM or Bare Metal reservation uses, and queue key delivery to machines. Slurm clusters take organization key IDs at launch. Kubernetes API access does not use SSH keys. - name: Reserve description: >- Browse reserved-capacity listings and their terms, and post, cancel, or accept offers. Reserve listings are visible to approved organizations. - name: Market description: >- Browse relisted capacity and buy windows at the asking price, paid up front. Open to every member of your organization. - name: Spot description: >- Hourly order books for VMs with 1, 2, 4, or 8 GPUs on one node: read books, trades, and quotes, place and cancel bids, and follow fills. - name: Relist description: >- Sell whole nodes from a reservation you hold at your asking price, and manage those listings. - name: Storage description: >- Managed volumes, their files, and GitHub repository pulls. Volumes belong to the API key's creator in the key's organization. - name: Networks description: >- Organization private networks and the WireGuard configs you use to reach private machines and clusters. - name: Monitoring description: >- Machine telemetry and console logs for capacity your organization holds. Reads are limited to your reservation window. - name: Billing description: >- Invoices, billing summary, usage cost, Ornn credits, and account statements. Saving a card and paying invoices stay in the console. externalDocs: description: REST integration walkthrough url: >- https://docs.ornn.com/guides/kubernetes-access#provision-and-manage-through-rest paths: /v1/markets/schedules/{listingId}/offers: post: tags: - Reserve summary: Post a Reserve offer description: >- Offers a price for a whole Reserve listing: every node, starting at the later of the listing's start and now, for the chosen duration. The listing owner accepts or declines. Your organization must be approved. When the listing has terms, send listingTermId for a reserved term and durationSeconds within its bounds (optional when the minimum equals the maximum). The offer is open until it is accepted, you cancel it, or another trade takes the window. Relisted (Market) capacity does not take offers. Requires Idempotency-Key. operationId: capacityPostOffer parameters: - name: listingId in: path required: true description: Listing ID (capacityListingId or listingId). schema: type: string format: uuid example: 77777777-7777-4777-8777-777777777777 - name: Idempotency-Key in: header required: true description: >- 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. schema: type: string minLength: 1 maxLength: 200 example: 3f1c2a9e-6b1d-4c55-9a77-0d2b8f1e4c10 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CapacityOfferRequest' example: listingTermId: 88888888-8888-4888-8888-888888888888 durationSeconds: 2592000 pricePerGpuHourMicroUsd: 2400000 downPaymentCents: 500000 responses: '200': description: >- A retry with the same Idempotency-Key and body; returns the original offer. content: application/json: schema: $ref: '#/components/schemas/CapacityOfferEnvelope' example: offer: offerId: 99999999-9999-4999-8999-999999999999 listingId: 77777777-7777-4777-8777-777777777777 listingTermId: 88888888-8888-4888-8888-888888888888 startsAt: '2026-10-15T00:00:00.000Z' endsAt: '2026-11-14T00:00:00.000Z' pricePerGpuHourMicroUsd: 2400000 downPaymentCents: 500000 status: open cancelReason: null createdAt: '2026-10-14T18:30:00.000Z' acceptedAt: null isMine: true onMyListing: false '201': description: Offer posted. content: application/json: schema: $ref: '#/components/schemas/CapacityOfferEnvelope' example: offer: offerId: 99999999-9999-4999-8999-999999999999 listingId: 77777777-7777-4777-8777-777777777777 listingTermId: 88888888-8888-4888-8888-888888888888 startsAt: '2026-10-15T00:00:00.000Z' endsAt: '2026-11-14T00:00:00.000Z' pricePerGpuHourMicroUsd: 2400000 downPaymentCents: 500000 status: open cancelReason: null createdAt: '2026-10-14T18:30:00.000Z' acceptedAt: null isMine: true onMyListing: false '400': description: Missing Idempotency-Key or invalid body. content: application/json: schema: $ref: '#/components/schemas/Error' example: detail: code: idempotency_key_required message: Send an Idempotency-Key header with this request. '401': $ref: '#/components/responses/Unauthorized' '403': description: The listing belongs to your organization. content: application/json: schema: $ref: '#/components/schemas/Error' example: detail: code: cannot_offer_on_own_listing message: You cannot make an offer on your own listing. '404': description: The listing does not exist, or your organization is not approved. content: application/json: schema: $ref: '#/components/schemas/Error' example: detail: code: schedule_not_found message: Ornn could not find that listing. '409': description: >- The window is already sold, the listing closed, or the key was reused. content: application/json: schema: $ref: '#/components/schemas/Error' example: detail: code: window_unavailable message: Part of this window is already reserved. '422': description: >- The term, duration, price, or down payment is not valid. Codes include invalid_listing_term, invalid_duration, offer_below_minimum, invalid_price, invalid_down_payment, and secondary_sells_at_ask. content: application/json: schema: $ref: '#/components/schemas/Error' example: detail: code: invalid_listing_term message: Choose an available listing term. default: $ref: '#/components/responses/Error' components: schemas: CapacityOfferRequest: type: object required: - pricePerGpuHourMicroUsd additionalProperties: false properties: listingTermId: type: string format: uuid description: Required when the listing has terms. Choose a reserved term. durationSeconds: type: integer minimum: 1 description: >- Whole seconds within the term's minDurationSeconds and maxDurationSeconds. Required unless the term's minimum equals its maximum. pricePerGpuHourMicroUsd: type: integer format: int64 minimum: 1 description: >- Your offer per GPU-hour in integer micro-USD. It can be below or above the term price. downPaymentCents: type: integer format: int64 minimum: 0 description: >- The down payment you offer, in whole cents. Omitted means 0. The console sends the selected term's downPaymentCents. CapacityOfferEnvelope: type: object required: - offer properties: offer: $ref: '#/components/schemas/CapacityOffer' Error: type: object properties: code: type: string detail: oneOf: - type: string - type: object required: - code - message properties: code: type: string message: type: string CapacityOffer: type: object required: - offerId - listingId - status - isMine - onMyListing properties: offerId: type: string format: uuid description: Offer ID. An accepted offer's reservation has this same ID. listingId: type: string format: uuid listingTermId: type: - string - 'null' format: uuid startsAt: type: - string - 'null' format: date-time description: >- Window start. Acceptance moves it to the acceptance time if that is later. endsAt: type: - string - 'null' format: date-time pricePerGpuHourMicroUsd: type: - integer - 'null' format: int64 downPaymentCents: type: - integer - 'null' format: int64 status: type: string description: open, accepted, or cancelled. Handle unrecognized values. cancelReason: type: - string - 'null' description: >- For example cancelled_by_author, cancelled_by_seller, conflict_with_trade (another offer or purchase took the window), or listing_cancelled. createdAt: type: - string - 'null' format: date-time acceptedAt: type: - string - 'null' format: date-time isMine: type: boolean description: True when your organization posted the offer. onMyListing: type: boolean description: True when the offer is on a listing your organization owns. responses: Unauthorized: description: >- The credential is missing, invalid, revoked, or no longer belongs to a current organization member. Check the HTTP status before parsing the body. content: application/json: schema: $ref: '#/components/schemas/Error' Error: 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 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: $ref: '#/components/schemas/Error' securitySchemes: 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. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.