Docs
Alerts

Delete a notification channel

DELETE
/v1/notification-channels/{id}

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.

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:write

Path Parameters

id*string

The notification channel id.

Match^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
Length1 <= length <= 63

Header Parameters

Idempotency-Key?string

Optional. With a key, a repeat of this request is a replay, marked with Idempotent-Replayed: true. See Idempotency above.

Match^[!-~]+$
Length1 <= length <= 255
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

The channel.

application/json
  1. response

Where your org's notifications go. Its URL and signing secret are never returned; host and urlEnding say which it is.

id*string
name*string
Lengthlength <= 100
type*NotificationChannelType

Open set; accept values not listed. slack: a Slack incoming webhook. webhook: an https:// URL of yours, sent signed JSON.

host*string

The URL's host.

urlEnding*string

The URL's last four characters.

status*string

Open set; accept values not listed. failing: every delivery for the last 24 hours failed. A failing channel keeps receiving.

createdAt*string
Formatdate-time
deletedAt?string
Formatdate-time
lastDelivery?

The channel's latest delivery attempt. Absent before the first.

Example Request
curl -X DELETE 'https://api.cloud.confidential.ai/v1/notification-channels/nc-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'
Example Response
{  "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"  }}