Delete an alert channel

⚠️ Android only.

Permanently deletes an alert channel identified by its integer alert_id. This action is irreversible. Any alarm rules that were linked to this channel will lose their association with it — verify the channel's linked_alerts before deleting to avoid silently disrupting alert delivery for active alarm rules.

Common use cases

Removing a channel whose destination email address is no longer valid or monitored

Cleaning up duplicate or test channels created during setup

Decommissioning a channel as part of a notification infrastructure reorganization

Best practices

Check linked_alerts by calling GET /v1/enterprise/{enterprise_id}/alertchannels/{alert_id} before deleting — if the channel is actively linked to alarm rules, update or delete those rules first, or reassign them to a different channel, to avoid broken alert delivery

Confirm the correct alert_id before issuing the delete — this action cannot be undone and alert_id is an integer, not a UUID

Use GET /v1/enterprise/{enterprise_id}/alertchannels/ with the name filter to locate the correct channel if the alert_id is not already known