Grant a capacity request
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.
oauth2 capacity:grantAuthorizationBearer <token>A person's access token, sent as Authorization: Bearer <token>,
from the authorization code flow with PKCE (S256). A CLI on a
machine without a browser can use the device flow (RFC 8628) at
https://auth.confidential.ai/oauth2/device_authorization
instead. Ask for the resource https://api.cloud.confidential.ai
(RFC 8707): a token issued for any other resource, the MCP server's
included, is refused. A token acts for one person in one org, with
the scopes of the person's role there whatever the client asks for,
so ask the authorization server for none of the scopes below; they
are listed so that each operation can name the ones it needs.
Access tokens last minutes, and a refresh token is replaced at every
use.
Scope: capacity:grant
id*stringThe capacity request id.
^[a-z0-9]([-a-z0-9]*[a-z0-9])?$1 <= length <= 63Idempotency-Key*stringA unique key for this intent, such as a UUID. Reuse it for every
retry of the same request. A missing key returns
400 idempotency_key_required. See Idempotency above.
^[!-~]+$1 <= length <= 255Api-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 <= 500application/json- body
Where and when to reserve the GPUs, where the request left it open or we choose otherwise.
start?stringThe start of the reservation, 00:00 UTC on a day. Without it, the start the request asked for, or else the first day that can still be invoiced.
date-timelocation?LocationIdThe location to reserve in. Without it, the first the request would take that has the GPUs free.
^[a-z0-9]([-a-z0-9]*[a-z0-9])?$1 <= length <= 63tee?TeeThe TEE to reserve on. Without it, the first the request would take that has the GPUs free.
The request, granted, with its reservation. A replay returns its current state.
application/json- response
A capacity request with the org that made it, as our own org's owners see it.
org*capacityRequest*An org's ask for whole GPUs over a term, made whether or not any are free. It holds no GPUs and has no price.
curl -X POST 'https://api.cloud.confidential.ai/v1/operator/capacity-requests/cq-7hd2m4x9qk/grant' \ -H 'Idempotency-Key: 0b9d6c1e-5f8a-4c2e-9a51-2f7e0c3d4b18' \ -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' \ -H 'Content-Type: application/json' \ -d '{}'{ "org": { "id": "org-acme", "name": "Acme" }, "capacityRequest": { "id": "cq-7hd2m4x9qk", "displayName": "Spring training run", "status": "granted", "statusChangedAt": "2026-11-15T17:00:00Z", "gpu": { "model": "b300", "count": 16 }, "term": "P90D", "start": "2027-03-01T00:00:00Z", "locations": [ "us-west-1" ], "requestedBy": { "userId": "user_01JB2M5V9Q7X3K8N4T6W0YHZ", "agent": false }, "createdAt": "2026-11-14T18:02:11Z", "expiresAt": "2027-02-12T18:02:11Z", "reservation": "r-4mz81qk7hd2x" }}File a capacity request for an org POST
Records a capacity request in another org, as that org's own `POST /v1/capacity-requests` would, for GPUs we agreed with it outside the console, such as under a contract. The request is `open` and holds nothing until it is granted. The org reads in its own audit log that we filed it. Requires `Idempotency-Key`. Only an owner of our own org holds `capacity:grant`, and only with a token issued to our console.
List capacity requests GET
Lists the org's capacity requests, newest first, in every status.