v51

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01206322659.2 KB

channels

Delete a delivery channel

Delete a delivery channel for the organization.

Refused with 409 while alarms still reference the channel; force: true deletes anyway and unlinks them. The one case force will not do is strip the last channel from an enabled alarm — that alarm would go on evaluating and recording state transitions with nowhere to send them. Attach a replacement channel or disable the alarm first.

delete/orgs/{org_id}/channels/{channel_id}

Path parameters

org_idstring required

channel_idstring required

Request body

forceboolean nullable

When true, delete even if alarms reference this channel (cascading unlink). Still refused when it would leave an enabled alarm with no channels.

Response

Channel deleted