List notifications
Lists what your org was sent in the last 30 days, newest first, with
each channel's delivery: pending while it is retried, delivered
once the receiver answered 2xx, failed after a day of retries.
Requires alerts:read.
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: alerts:read
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 <= 500Notifications, newest first.
application/json- response
items*array<>nextPageToken?stringPresent when another page follows. Send it unchanged as pageToken.
curl -X GET 'https://api.cloud.confidential.ai/v1/notifications?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": "ntf-abcdefghijklmnopqrstuvwxyz", "type": "instance.failed", "occurredAt": "2026-10-22T23:12:00Z", "instance": { "id": "i-fyctgkwljvqx", "project": "default", "status": "failed", "reason": "launch_failed" }, "message": "The instance's host could not start it. Delete it, and create a new one.", "deliveries": [ { "channel": "nc-abcdefghijklmnopqrstuvwxyz", "status": "delivered", "attempts": 1, "lastAttemptAt": "2026-10-22T23:12:02Z", "httpStatus": 200, "latencyMs": 210 } ] }, { "id": "ntf-bcdefghijklmnopqrstuvwxyz2", "type": "cluster.unavailable", "occurredAt": "2026-10-22T22:40:00Z", "cluster": { "id": "cl-0123456789abcdef", "name": "prod", "project": "default", "reason": "NotAvailable" }, "message": "The cluster has not been available for 10 minutes.", "deliveries": [ { "channel": "nc-abcdefghijklmnopqrstuvwxyz", "status": "delivered", "attempts": 1, "lastAttemptAt": "2026-10-22T22:50:01Z", "httpStatus": 200, "latencyMs": 190 } ] } ]}Delete an alert subscription DELETE
Deletes a subscription. Notifications already written are still delivered. Requires `alerts:write`. Safe to repeat.
Get your limits GET
Returns the org's quotas, with what is in use against each, and the caller's explicitly configured limits, which only an agent credential has in this version. An org's quotas cap its live on-demand instances and their vCPUs, stopped ones included, and not GPU instances, which are reserved or spot, and its instances with a dedicated IPv4, GPU instances included; one with no quota, such as the platform's own, has `inUse` and no `limit`. Creates still need available host resources. `org.clusters` is present only for an org with managed Kubernetes. It also says whether the caller counts as an agent, whose GPU reservations wait for an owner's approval. Any valid credential can read it. Plan a create from it, rather than retrying one that returned `403 quota_exceeded`.