Alerts / List

List alert channels for the authenticated account, including the built-in email channel. Use channel_key values when assigning channels to monitors and heartbeats.

Endpoint

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

Request

{}

Response

Top level

ok Always true on success.
alert_channels Array of alert channel summary objects.
capacity Alert channel quota for the account.
rate_limit Rate limit state for the tier this endpoint consumes. Present on every successful response.

alert_channels[]

guid Alert channel id. The built-in email channel always uses 00000000-0000-0000-0000-000000000001.
channel_type email (built-in) or discord, slack, teams, telegram, webhook.
channel_key Key for monitor and heartbeat alert_channel_keys. Built-in email is always email; custom channels use {type}:{guid}.
name Channel name. For built-in email, this is the account owner address.
system true for the platform email channel. Omitted on custom channels you create.
paused true when delivery is paused. Always false for built-in email.
monitor_count Monitors linked to this channel.
heartbeat_count Heartbeats linked to this channel.

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_channels": [ { "guid": "00000000-0000-0000-0000-000000000001", "channel_type": "email", "channel_key": "email", "name": "owner@example.com", "system": true, "paused": false, "monitor_count": 2, "heartbeat_count": 0 }, { "guid": "550e8400-e29b-41d4-a716-446655440000", "channel_type": "discord", "channel_key": "discord:550e8400-e29b-41d4-a716-446655440000", "name": "Ops Discord", "paused": false, "monitor_count": 3, "heartbeat_count": 1 } ], "capacity": { "limit": 10, "used": 1, "remaining": 9 }, "rate_limit": { "tier": 2, "cost": 1, "timeframe": "minute", "limit": 120, "used": 73, "remaining": 47 } }