Docs
Alerts

List notifications

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

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.

Scope: alerts:read

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

Notifications, newest first.

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

Present when another page follows. Send it unchanged as pageToken.

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