Delete an alert subscription
Deletes a subscription. Notifications already written are still
delivered. Requires alerts:write. Safe to repeat.
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:write
id*stringThe alert subscription id.
^[a-z0-9]([-a-z0-9]*[a-z0-9])?$1 <= length <= 63Idempotency-Key?stringOptional. With a key, a repeat of this request is a replay, marked
with Idempotent-Replayed: true. See Idempotency above.
^[!-~]+$1 <= length <= 255Api-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 deleted subscription.
application/json- response
id*stringevents*array<>filter?Narrows a subscription; every field given must match. Without a
filter, every instance and cluster of your org matches. instances
matches only instances, and clusters only clusters.
channels*array<string>Notification channel ids.
createdAt*stringdate-timedeletedAt?stringdate-timecurl -X DELETE 'https://api.cloud.confidential.ai/v1/alert-subscriptions/as-abcdefghijklmnopqrstuvwxyz' \ -H 'Idempotency-Key: 6f1c2e4a-8d3b-4f9e-b7a2-1c5d9e0f3a68' \ -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'{ "id": "as-abcdefghijklmnopqrstuvwxyz", "events": [ "instance.failed" ], "channels": [ "nc-abcdefghijklmnopqrstuvwxyz" ], "createdAt": "2026-10-23T03:00:00Z", "deletedAt": "2026-10-23T04:00:00Z"}Subscribe to alerts POST
Sends the events named in `events`, of the instances `filter` matches, to each of `channels`. Requires `alerts:write`. Without a filter, every instance in your org matches; each field of a filter narrows it, and all must match. An org may have 50 subscriptions. A change that matches several subscriptions with the same channel is sent to it once.
List notifications GET
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`.