All requests below will use this key. Your API key is sent directly to api.cueapi.ai and never stored by the docs site.
GET
/v1/alertsList Alerts
Query alert history with optional filters.
alert_typestringqueryFilter by alert type: consecutive_failure, missed_window, outcome_timeout.
cue_idstringqueryFilter alerts for a specific cue.
acknowledgedbooleanqueryFilter by acknowledgment status.
limitintegerdefault: 50queryResults per page (1-100).
offsetintegerdefault: 0queryPagination offset.
CueAPI fires alerts when:
- consecutive_failure: A cue fails N times in a row (configurable via
alerts.consecutive_failures, default 3) - missed_window: A cue hasn't succeeded within its expected schedule window (configurable via
alerts.missed_window_multiplier, default 2x) - outcome_timeout: An execution's outcome deadline passed without a report
Returns an empty array (not 404) when no alerts match.
Request
bash
curl https://api.cueapi.ai/v1/alerts \
-H "Authorization: Bearer YOUR_API_KEY"bash
curl "https://api.cueapi.ai/v1/alerts?alert_type=consecutive_failure" \
-H "Authorization: Bearer YOUR_API_KEY"Response
json
{
"alerts": [
{
"id": "alert-uuid",
"cue_id": "cue_abc123",
"alert_type": "consecutive_failure",
"severity": "warning",
"message": "morning-brief has failed 3 times consecutively",
"acknowledged": false,
"created_at": "2026-03-23T09:00:00Z"
}
],
"total": 1,
"limit": 50,
"offset": 0
}