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
| Param | Type | Notes |
|---|---|---|
id | UUID | The channel id |
Response
200 OK
{
"success": true,
"data": {
"deleted": true
}
}Error responses
| Status | error.code | When |
|---|---|---|
| 400 | VALIDATION_ERROR | id is not a UUID |
| 401 | UNAUTHORIZED | Missing or invalid API key |
| 403 | FORBIDDEN | Key lacks config:write |
| 404 | NOT_FOUND | No 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_..."