SigSentrySigSentry
Notification Channels

DELETE /v1/config/notifications/{id}

Delete a notification channel

Permanently deletes a notification channel. After deletion, the channel no longer receives any deliveries; existing delivery history for the channel is also removed.

To stop deliveries without deleting (e.g. for a temporary mute), use PUT /v1/config/notifications/{id} with isActive: false instead.

Authentication

API key with config:write permission. The channel must belong to your tenant.

Endpoint

DELETE /v1/config/notifications/{id}

Path parameters

ParamTypeNotes
idUUIDThe channel id

Response

200 OK

{
  "success": true,
  "data": {
    "deleted": true
  }
}

Error responses

Statuserror.codeWhen
400VALIDATION_ERRORid is not a UUID
401UNAUTHORIZEDMissing or invalid API key
403FORBIDDENKey lacks config:write
404NOT_FOUNDNo channel with that id in your tenant

Example

curl -X DELETE https://api.sigsentry.com/v1/config/notifications/9b7a3b2c-2e6e-4f1f-8c5a-1b2c3d4e5f6a \
  -H "Authorization: Bearer ss_secret_..."