channels

Delete a delivery channel

Changed on

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}

Request

  • Base URL
    https://api.timbal.ai
  • URL
    https://api.timbal.ai/orgs/{org_id}/channels/{channel_id}
  • Auth
    HTTP bearer

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

Changes