API V1 / Alerts / Delete

Delete an alert channel by channel_key. Monitor and heartbeat links to this channel are removed.

Endpoint

Method	`POST`
Url	`https://downdar.com/api/v1/alerts/delete`

Request

Key fields

channel_key key Alert channel key ({type}:{guid}).

{ "channel_key": "discord:550e8400-e29b-41d4-a716-446655440000" }

Response

Top level

`ok`	Always `true` on success.
`alert_channel`	Deleted alert channel reference.
`capacity`	Alert channel quota for the account.
`rate_limit`	Rate limit state for the tier this endpoint consumes. Present on every successful response.

alert_channel

`deleted`	Always `true` when the channel was removed.
`channel_key`	Deleted alert channel key.
`guid`	Deleted alert channel id.
`channel_type`	Deleted channel type.

capacity

`limit`	Maximum alert channels allowed on your plan.
`used`	Alert channels currently in use.
`remaining`	Alert channels you can still create.

rate_limit

`tier`	Rate tier this endpoint counts against (`1`-`5`).
`cost`	Units consumed by this request against the tier window.
`timeframe`	Rolling limit window: `second`, `minute`, `hour`, or `day`.
`limit`	Maximum units allowed in the timeframe for this tier on your plan.
`used`	Units already used in the current window.
`remaining`	Units left before this tier returns HTTP 429.

{ "ok": true, "alert_channel": { "deleted": true, "channel_key": "discord:550e8400-e29b-41d4-a716-446655440000", "guid": "550e8400-e29b-41d4-a716-446655440000", "channel_type": "discord" }, "capacity": { "limit": 10, "used": 0, "remaining": 10 }, "rate_limit": { "tier": 1, "cost": 1, "timeframe": "minute", "limit": 60, "used": 12, "remaining": 48 } }