Docs
Catalog

List sizes

GET
/v1/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.

Authorization

headerAuthorizationBearer <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.

Query Parameters

pageSize?integer

The most items to return.

Range1 <= value <= 100
Default50
pageToken?string

The nextPageToken of the previous page, unchanged. Send the same filters with it.

Length1 <= length <= 2048

Header Parameters

Api-Version*string

The 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?string

An 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.

Match^[A-Za-z0-9._:-]+$
Length1 <= length <= 128
Org-Context?string

Admin 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.

Match^org-[a-z0-9]([-a-z0-9]*[a-z0-9])?$
Length5 <= length <= 63
Access-Reason?string

Admin 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.

Match^[^\x00-\x1F\x7F]+$
Length10 <= length <= 500

Response Body

A page of sizes.

application/json
  1. response
items*array<>
nextPageToken?NextPageToken

Pass it back as pageToken for the next page. Absent on the last page.

Example Request
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'
Example Response
{  "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.