Alerts API

Alert incident object

{
  "id": "inc_01HXZ3M...",
  "monitor_id": "mon_01HXZ3M...",
  "monitor_name": "Production API",
  "status": "firing",
  "severity": "critical",
  "message": "HTTP 503 from all locations for 3+ minutes",
  "started_at": "2025-01-15T09:14:00Z",
  "resolved_at": null,
  "duration_seconds": null,
  "notifications_sent": [
    { "channel": "slack", "sent_at": "2025-01-15T09:14:05Z" },
    { "channel": "email", "sent_at": "2025-01-15T09:14:06Z" }
  ]
}

List alert incidents

GET /v1/alerts

Query parameters:

Parameter	Type	Description
`status`	string	`firing`, `resolved`, `silenced`
`severity`	string	`critical`, `warning`, `info`
`from`	ISO 8601	Start date
`to`	ISO 8601	End date
`limit`	integer	Max results

curl "https://api.securecheap.com/v1/alerts?status=firing" \
  -H "Authorization: Bearer sc_live_xxxx"

Acknowledge an alert

POST /v1/alerts/{id}/acknowledge

Marks the alert as acknowledged — useful for silencing notification spam while you investigate.

Resolve an alert manually

POST /v1/alerts/{id}/resolve

Marks the incident as resolved (normally done automatically when the condition clears).

Servers Error Reference