Send a test notification
Sends the channel a notification of type test now, once, and
returns it with the delivery: the receiver's HTTP status, how long it
took, or why it failed. Requires alerts:write. A retry with the
same Idempotency-Key returns the first answer without sending
again.
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 notification channel id.
^[a-z0-9]([-a-z0-9]*[a-z0-9])?$1 <= length <= 63Idempotency-Key*stringA unique key for this intent, such as a UUID. Reuse it for every
retry of the same request. A missing key returns
400 idempotency_key_required. 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 test notification and its delivery.
application/json- response
One thing that happened, as every channel gets it: a webhook as this JSON, Slack as a message.
id*stringDeliveries of one notification carry its id in Cloud-Notification-Id; use it to drop repeats.
type*stringAn AlertEvent, or test. Open set; accept values not listed.
occurredAt*stringdate-timeinstance?The instance it is about, as it was then.
cluster?The cluster it is about.
message*stringWhat happened, in a sentence or two.
deliveries?array<>One per channel it went to. Not part of what a webhook receives.
curl -X POST 'https://api.cloud.confidential.ai/v1/notification-channels/nc-abcdefghijklmnopqrstuvwxyz/test' \ -H 'Idempotency-Key: 0b9d6c1e-5f8a-4c2e-9a51-2f7e0c3d4b18' \ -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": "ntf-abcdefghijklmnopqrstuvwxyz", "type": "test", "occurredAt": "2026-10-23T03:00:00Z", "message": "A test notification from Confidential Cloud.", "deliveries": [ { "channel": "nc-abcdefghijklmnopqrstuvwxyz", "status": "delivered", "attempts": 1, "lastAttemptAt": "2026-10-23T03:00:01Z", "httpStatus": 200, "latencyMs": 180 } ]}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.
Rotate a webhook channel's signing secret POST
Makes a new signing secret for a webhook channel and returns it once. Deliveries are signed with the new secret from now on, retries of earlier notifications included. Requires `alerts:write`. A Slack channel has no secret: `409 invalid_state`.