List sizes
Lists every instance size, CPU and GPU, with its vCPUs, memory, the
TEEs it is offered on and its hourly price: what your org pays, with
any deal on its subscription, or the list price before it has one. Sizes
are a fixed catalog of shapes: a create names one by id and takes
no vCPU, memory or GPU count of its own.
An id is a family, a dot and a count. The family is a letter for
what it is for and a digit for the hardware generation: c1
(compute) has 2 GiB of memory per vCPU, s1 (standard) 4 GiB and
m1 (memory) 8 GiB, and a GPU family adds its GPU model, as in
g1-b300. The count is of vCPUs, or of GPUs in a GPU family:
s1.4x has 4 vCPUs and 16 GiB, and g1-b300.2x two B300 GPUs.
Read ids from this list rather than building them; sizes and
families can be added at any time.
GPU sizes, which carry gpu, are offered only through a reservation
(POST /v1/reservations) and never on demand. nodePool marks the
sizes a managed Kubernetes node pool can run.
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.
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 sizes.
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/sizes?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": "c1.2x", "family": "c1", "vcpus": 2, "memoryGiB": 4, "tees": [ "tdx" ], "locations": [ { "id": "us-west-1", "tees": [ "tdx" ], "onDemandAvailable": true } ], "nodePool": false, "purchaseOptions": [ "on-demand" ], "onDemandAvailable": true }, { "id": "s1.4x", "family": "s1", "vcpus": 4, "memoryGiB": 16, "tees": [ "tdx" ], "locations": [ { "id": "us-west-1", "tees": [ "tdx" ], "onDemandAvailable": true } ], "nodePool": true, "purchaseOptions": [ "on-demand" ], "onDemandAvailable": true, "price": { "currency": "USD", "perHour": "0.24" } }, { "id": "m1.8x", "family": "m1", "vcpus": 8, "memoryGiB": 64, "tees": [ "tdx" ], "locations": [ { "id": "us-west-1", "tees": [ "tdx" ], "onDemandAvailable": true } ], "nodePool": true, "purchaseOptions": [ "on-demand" ], "onDemandAvailable": true }, { "id": "g1-b300.2x", "family": "g1-b300", "vcpus": 16, "memoryGiB": 128, "tees": [ "tdx" ], "locations": [ { "id": "us-west-1", "tees": [ "tdx" ], "spotAvailable": true } ], "nodePool": false, "gpu": { "model": "b300", "count": 2 }, "purchaseOptions": [ "reservation", "spot" ], "spotPrice": { "currency": "USD", "perHour": "9.00" }, "spotAvailable": true } ]}List images GET
Lists the image versions your org can create instances from, by family and then newest version first: those that are `active` or `deprecated`. Each version has one artifact per TEE, with its digest, the sizes it runs on and its signed reference manifest, and a launch contract that says what a create must supply: the disks, the access mode, the init-data formats and the minimum memory. An artifact appears once it passes the platform's boot test on its TEE, and it lists a GPU size only once its image passes GPU acceptance with that many GPUs. `image: "<family>"` in a create resolves to the family's newest `active` version; `image: "<family>@<version>"` pins one. Until a new version has passed the boot test on a TEE, creates on that TEE that name the family get the newest active version that has, or if none has, the newest deprecated version still accepting creates that has; when no host with room has booted that one, the version before it. Among those versions, the newest that sells the create's size comes first, so a version that does not sell the size yet leaves its creates on the one before it. A version none of whose artifacts has passed is not listed. A `deprecated` version still runs its instances and accepts creates until `createsEndAt`; after that it is retired and no longer listed. A version withdrawn for a security flaw is retired the same day, and every org with an instance on it is told. Those instances keep running unless the flaw endangers their host or other tenants; then the platform stops them after notice, and they become `failed` with reason `image_unavailable`. A version that is not yet active does not exist for your org: a create that names it returns `400 invalid_request` with violation `not_found` at `/image`. A create that names a retired version returns the same error with violation `retired`, and its message names the family's newest version.
List locations GET
Lists the locations you can create instances in, and what each offers: TEEs, public IP modes, IPv6 and private networks. Every create names its location; `defaultFor` is the location a client offers first for a TEE.