List capacity requests
Lists the org's capacity requests, newest first, in every status.
AuthorizationBearer <cc_...>An API key of your org, sent as Authorization: Bearer cc_.... Keys
start with cc_ and are otherwise opaque. Treat a key as a password:
anyone holding it can act with its scopes until it expires or is
revoked. Each operation's security requirement lists the scopes it
needs; an empty list means any valid key. The MCP server at /mcp
accepts agent keys and no other kind.
Scope: reservations:read
pageSize?integerThe most items to return.
1 <= value <= 10050pageToken?stringThe nextPageToken of the previous page, unchanged. Send the same
filters with it.
1 <= length <= 2048Api-Version*stringThe API version the request is written against. This document
describes 2026-10-15. A missing header returns
400 api_version_required, and a version the API does not serve
returns 400 unsupported_api_version.
X-Correlation-ID?stringAn id of your own for this request, or for a group of requests, to
find them in our logs and yours. Logged with the request and returned
unchanged in X-Correlation-ID. The request id itself is always the
API's own, in X-Request-ID.
^[A-Za-z0-9._:-]+$1 <= length <= 128Org-Context?stringAdmin keys only: the id of the org to act in. Required with an admin
key, together with Access-Reason; with any other credential it
returns 400 invalid_request. Every request that carries it is
recorded in that org's operator-access log.
^org-[a-z0-9]([-a-z0-9]*[a-z0-9])?$5 <= length <= 63Access-Reason?stringAdmin keys only: why the operator is acting in the org, such as a
support ticket. Required with Org-Context. Recorded, verbatim, in
the org's operator-access log.
^[^\x00-\x1F\x7F]+$10 <= length <= 500A page of capacity requests, newest first.
application/json- response
items*array<>nextPageToken?NextPageTokenPass it back as pageToken for the next page. Absent on the last page.
curl -X GET 'https://api.cloud.confidential.ai/v1/capacity-requests?pageSize=50&pageToken=eyJjIjoiMjAyNi0xMC0yMlQxNzowMjoxMVoiLCJpIjoiaS03azJtOXE0eDFiZmEifQ' \ -H 'Api-Version: 2026-10-15' \ -H 'X-Correlation-ID: rollout-2026-10-22' \ -H 'Access-Reason: Support ticket 4821: customer asked why i-6d3f9h2k8mzr failed'{ "items": [ { "id": "cq-7hd2m4x9qk", "displayName": "Spring training run", "status": "open", "statusChangedAt": "2026-11-14T18:02:11Z", "gpu": { "model": "b300", "count": 16 }, "term": "P90D", "start": "2027-03-01T00:00:00Z", "locations": [ "us-west-1" ], "note": "Two full nodes on one fabric if you can.", "requestedBy": { "userId": "user_01JB2M5V9Q7X3K8N4T6W0YHZ", "agent": false }, "createdAt": "2026-11-14T18:02:11Z", "expiresAt": "2027-02-12T18:02:11Z" } ]}Grant a capacity request POST
Reserves the GPUs an `open` capacity request of any org asks for, for that org, and marks the request `granted`, together: the request is granted exactly when a reservation holds its GPUs. The reservation is an ordinary one in status `requested`, at the price of its location and term, whose emailed invoice confirms it; the org's `reservation` on the request names it. Requires `Idempotency-Key`. The GPUs come from any host in service that serves the org, whether or not it is open to self-serve reservation. Without GPUs free for the whole window where the request would take them, nothing changes and the answer is `409 insufficient_capacity`. A request that is no longer `open` returns `409 invalid_state`. Only an owner of our own org holds `capacity:grant`, and only with a token issued to our console.
Ask for GPU capacity POST
Tells us the GPUs your org wants: a model, a count, a term and, if you like, a start and the locations you would take. Use it when `GET /v1/reservation-offerings` has nothing that fits, or to ask ahead for a date. Requires `Idempotency-Key`. A capacity request holds no GPUs, has no price and is never invoiced, so it needs no payment method. It stays `open` for 90 days, until `expiresAt`, and you can withdraw it with `DELETE` at any time. An org may have 20 open requests.