Get a notification channel
Returns a channel, with how its last delivery went. 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
id*stringThe notification channel 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 channel.
application/json- response
Where your org's notifications go. Its URL and signing secret are
never returned; host and urlEnding say which it is.
id*stringname*stringlength <= 100type*NotificationChannelTypeOpen set; accept values not listed. slack: a Slack incoming
webhook. webhook: an https:// URL of yours, sent signed JSON.
host*stringThe URL's host.
urlEnding*stringThe URL's last four characters.
status*stringOpen set; accept values not listed. failing: every delivery
for the last 24 hours failed. A failing channel keeps receiving.
createdAt*stringdate-timedeletedAt?stringdate-timelastDelivery?The channel's latest delivery attempt. Absent before the first.
curl -X GET 'https://api.cloud.confidential.ai/v1/notification-channels/nc-abcdefghijklmnopqrstuvwxyz' \ -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": "nc-abcdefghijklmnopqrstuvwxyz", "name": "pager", "type": "webhook", "host": "alerts.example.com", "urlEnding": "loud", "status": "failing", "createdAt": "2026-10-22T03:00:00Z", "lastDelivery": { "at": "2026-10-23T03:12:09Z", "result": "failed" }}Create a notification channel POST
Adds a place your org's notifications go: a Slack incoming webhook (`type: slack`, a `https://hooks.slack.com/` URL) or a webhook of your own (`type: webhook`, any `https://` URL on port 443). Requires `alerts:write`. A webhook channel's signing secret is returned once, in this response and its replays; `POST /v1/notification-channels/{id}/rotate-secret` makes a new one. An org may have 20 channels. Nothing is sent until a subscription names the channel; `POST /v1/notification-channels/{id}/test` sends one notification now.
Delete a notification channel DELETE
Deletes a channel, takes it out of every subscription, and stops its pending deliveries. A subscription left with no channel is deleted too. Requires `alerts:write`. Safe to repeat.