Alerts / Update

Update an existing alert channel. Send the full config payload for the channel type. Use /alerts/pause to change the paused state.

Endpoint

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

Request

Key fields

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

Fields

name req String, max 255 characters.
webhook_url opt Required for discord, slack, teams, and webhook.
bot_token opt Required for telegram.
chat_id opt Required for telegram.
auth_bearer opt Optional bearer token for webhook.
signing_secret opt Optional signing secret for webhook.
{ "channel_key": "discord:550e8400-e29b-41d4-a716-446655440000", "name": "Ops Discord (renamed)", "webhook_url": "https://discord.com/api/webhooks/1234567890/example-token" }

Response

Top level

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

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": { "guid": "550e8400-e29b-41d4-a716-446655440000", "channel_type": "discord", "channel_key": "discord:550e8400-e29b-41d4-a716-446655440000", "name": "Ops Discord (renamed)", "paused": false, "monitor_count": 3, "heartbeat_count": 1, "webhook_url": "https://discord.com/api/webhooks/1234567890/example-token" }, "capacity": { "limit": 10, "used": 1, "remaining": 9 }, "rate_limit": { "tier": 1, "cost": 1, "timeframe": "minute", "limit": 60, "used": 12, "remaining": 48 } }