List a cluster's node pools
Lists the cluster's pools by name. Deleted pools are left out.
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: clusters:read
id*stringThe cluster id.
^[a-z0-9]([-a-z0-9]*[a-z0-9])?$1 <= length <= 63Api-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 cluster's pools, by name.
application/json- response
items*array<>curl -X GET 'https://api.cloud.confidential.ai/v1/clusters/cl-0123456789abcdef/node-pools' \ -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": []}Get credentials for a cluster GET
Returns a token the cluster's API server takes for an hour, with the server's address, its CA and a kubeconfig that uses them. The token signs in as you, or as the API key, in the group `cloud:cluster-admins`, bound to `cluster-admin`, when the credential holds `clusters:write`, and in `cloud:cluster-viewers`, bound to `view`, when it holds only `clusters:read`. It is for this cluster only. Every call mints a new token and is in the audit log; none is stored, and none can be revoked before it expires. A cluster that is still `provisioning`, with no CA yet, or `terminating` returns `409 invalid_state`.
Add a node pool POST
Adds a pool of nodes to the cluster, and returns it `provisioning`. Requires `Idempotency-Key`. Its nodes are instances that Cluster API creates, replaces and deletes; change them through the pool.