List images
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.
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 image versions.
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/images?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'The two v1 image families. Every artifact is TDX and lists CPU sizes only, because no image has passed GPU acceptance yet.
{ "items": [ { "family": "c8s-node", "version": "2026.10.1", "status": "active", "description": "A c8s Kubernetes node that joins the cluster its signed launch document names.", "releasedAt": "2026-10-14T09:00:00Z", "artifacts": [ { "tee": "tdx", "digest": "sha256:982a8305d97e901e472678751f00d86c5db63baf65386d815d00e0d6c5487ba1", "sizes": [ "c1.4x", "c1.8x", "c1.16x", "s1.2x", "s1.4x", "s1.8x", "s1.16x", "m1.2x", "m1.4x", "m1.8x" ], "referenceManifest": { "uri": "https://measurements.example/c8s-node/2026.10.1/tdx/manifest.json", "digest": "sha256:f39fd2c06953c22cc4f5c65815dc4aa5bc2dc24796969c5e8e5586c4e75761dd", "logEntry": "rekor:1293911" } } ], "launch": { "access": "launchKey", "initDataFormats": [ "c8s-launch/v1" ], "userData": false, "containers": false, "gpuMetrics": false, "attestationPort": 8443, "attestationPublic": false, "readiness": { "tcpPorts": [] }, "minMemoryGiB": 8, "disks": [ { "name": "data", "type": "scratch", "required": true, "minSizeGiB": 64, "encryption": "guest", "persistent": false }, { "name": "containerd", "type": "scratch", "required": false, "minSizeGiB": 20, "encryption": "guest", "persistent": false } ] } }, { "family": "confos-cpu", "version": "2026.10.2", "status": "active", "description": "General-purpose Linux with Docker and containerd, reached over SSH.", "releasedAt": "2026-10-20T09:00:00Z", "artifacts": [ { "tee": "tdx", "digest": "sha256:8c780b3655fc55a663ed38174927e149157c6d2bedf81b9ce60a0a6d8ec33947", "sizes": [ "c1.2x", "c1.4x", "c1.8x", "c1.16x", "s1.2x", "s1.4x", "s1.8x", "s1.16x", "m1.2x", "m1.4x", "m1.8x" ], "referenceManifest": { "uri": "https://measurements.example/confos-cpu/2026.10.2/tdx/manifest.json", "digest": "sha256:472d2826575f5b45c0b463738780a3200de086f98737e7b5bf5298b02a475308", "logEntry": "rekor:1293847" } } ], "launch": { "access": "sshKeys", "initDataFormats": [], "userData": false, "containers": false, "gpuMetrics": false, "attestationPort": 8400, "attestationPublic": true, "readiness": { "tcpPorts": [ 8400 ] }, "minMemoryGiB": 4, "disks": [ { "name": "data", "type": "scratch", "required": false, "minSizeGiB": 10, "encryption": "guest", "persistent": false }, { "name": "user-data", "type": "scratch", "required": true, "minSizeGiB": 10, "encryption": "none", "persistent": true } ] } }, { "family": "confos-cpu", "version": "2026.09.3", "status": "deprecated", "description": "General-purpose Linux with Docker and containerd, reached over SSH.", "releasedAt": "2026-09-29T09:00:00Z", "createsEndAt": "2026-11-20T00:00:00Z", "artifacts": [ { "tee": "tdx", "digest": "sha256:933b1d6f3ad2716e3dc325803660a8bef3107a0fdb3796fdeb858bc187d7bfdd", "sizes": [ "c1.2x", "c1.4x", "c1.8x", "c1.16x", "s1.2x", "s1.4x", "s1.8x", "s1.16x", "m1.2x", "m1.4x", "m1.8x" ], "referenceManifest": { "uri": "https://measurements.example/confos-cpu/2026.09.3/tdx/manifest.json", "digest": "sha256:c9a3168c6fd6431a3ee471c5ae5813e3f948cd15212188c5fd4fe0bd22950cf4", "logEntry": "rekor:1180234" } } ], "launch": { "access": "sshKeys", "initDataFormats": [], "userData": false, "containers": false, "gpuMetrics": false, "attestationPort": 8400, "attestationPublic": true, "readiness": { "tcpPorts": [ 8400 ] }, "minMemoryGiB": 4, "disks": [ { "name": "data", "type": "scratch", "required": false, "minSizeGiB": 10, "encryption": "guest", "persistent": false }, { "name": "user-data", "type": "scratch", "required": true, "minSizeGiB": 10, "encryption": "none", "persistent": true } ] } } ]}Delete a node pool DELETE
Deletes the pool and its nodes, drained by Cluster API. This cannot be undone. Returns `202` with the pool `terminating`, and the pool is `404` from then on. A retry with the Idempotency-Key returns the first answer.
List sizes GET
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.