Withdraw a capacity request
Withdraws a capacity request that is open, and returns it in
status withdrawn. Repeats, and calls on an expired request,
return it unchanged.
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:write
id*stringThe capacity request id.
^[a-z0-9]([-a-z0-9]*[a-z0-9])?$1 <= length <= 63Idempotency-Key?stringOptional. With a key, a repeat of this request is a replay, marked
with Idempotent-Replayed: true. 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 <= 500The capacity request, withdrawn, or unchanged if it was already closed.
application/json- response
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.
id*CapacityRequestIdOpaque. Starts with cq-; otherwise as instance ids.
^cq-[a-z0-9]([-a-z0-9]*[a-z0-9])?$length <= 63displayName?stringThe display name the request gave. Absent if none.
status*CapacityRequestStatusOpen set; accept values not listed. open: with us, and yours to
withdraw. granted: we reserved the GPUs for you, as reservation,
whose invoice confirms it. withdrawn: you withdrew it. expired:
it stayed open until expiresAt.
statusChangedAt*stringdate-timegpu*GPUs, whole and passed through to the guest. Each instance gets its count of the host's GPUs, which the host's device plugin picks, and only those GPUs are passed to it. With 8 GPUs the guest has the whole board and can attest its NVSwitch topology. With 1, 2 or 4, it shares the board's NVSwitches with other instances on the host, which the guest cannot verify, and separation between instances over NVLink is not yet verified.
term*TermA whole number of days, as an ISO 8601 duration, from P7D to P365D.
^P([7-9]|[1-9][0-9]|[12][0-9]{2}|3[0-5][0-9]|36[0-5])D$start?stringThe start the request asked for. Absent if it asked for as soon as possible.
date-timelocations?array<>The locations the request would take. Absent if any.
tees?array<>The TEEs the request would take. Absent if any.
note?stringThe note the request gave. Absent if none.
requestedBy*Who made a change, by the credential it came with. Exactly one of
apiKey, userId, workload and operator is present.
createdAt*stringdate-timeexpiresAt*stringWhen an open request becomes expired, 90 days after it was made.
date-timereservation?ReservationIdThe reservation we made for a granted request, which holds its
GPUs and is invoiced. Absent otherwise.
^r-[a-z0-9]([-a-z0-9]*[a-z0-9])?$length <= 63curl -X DELETE 'https://api.cloud.confidential.ai/v1/capacity-requests/cq-7hd2m4x9qk' \ -H 'Idempotency-Key: 6f1c2e4a-8d3b-4f9e-b7a2-1c5d9e0f3a68' \ -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'{ "id": "cq-7hd2m4x9qk", "displayName": "Spring training run", "status": "withdrawn", "statusChangedAt": "2026-11-20T09:15:40Z", "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"}Get a capacity request GET
Returns the capacity request.
Query your instances' metrics at one time GET
Evaluates a PromQL query at one time, as Prometheus's `GET /api/v1/query` does, over your org's instance metrics and nothing else. A query that names another org's series, or any metric not listed under Metrics above, reads nothing. The response is Prometheus's own: `status`, `data` with its `resultType` and `result`, and any `warnings`. Errors are this API's problem documents; a query that does not parse or cannot run returns `400 invalid_request` with a violation of `query`.