Alerts / Create

Create an alert channel. Do not send guid; the server assigns one. Include the config fields required for the chosen channel_type.

Endpoint

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

Request

Fields

channel_type req discord, slack, teams, telegram, webhook
name req String, max 255 characters.
paused opt Boolean. Defaults to false.
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_type": "discord", "name": "Ops Discord", "webhook_url": "https://discord.com/api/webhooks/1234567890/example-token" }

Response

Top level

ok Always true on success.
alert_channel Created 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.

alert_channel

guid Alert channel id.
channel_type Channel type.
channel_key Key for alert_channel_keys on monitors and heartbeats.
name Channel name.
paused true when delivery is paused.
monitor_count Monitors linked to this channel.
heartbeat_count Heartbeats linked to this channel.
webhook_url Present for discord, slack, teams, and webhook.
bot_token Present for telegram.
chat_id Present for telegram.
auth_bearer Optional bearer token for webhook.
signing_secret Optional signing secret for webhook.

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": { "guid": "550e8400-e29b-41d4-a716-446655440000", "channel_type": "discord", "channel_key": "discord:550e8400-e29b-41d4-a716-446655440000", "name": "Ops Discord", "paused": false, "monitor_count": 0, "heartbeat_count": 0, "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 } }