List Incidents
List incidents across the active organization's monitors, filtered by status, cause, period.
Request
- Base URL: https://api.fettle.sh (the document declares no server; this is the origin it was published from)
- URL: https://api.fettle.sh/v1/incidents
- Auth: API key in header Authorization
Query parameters
Status filter accepted by the incidents listing endpoint.
OPEN keeps only ongoing incidents (resolved_at IS NULL); RESOLVED keeps only closed ones. Omitting the filter returns both.
Filter by open or resolved; omit for both.
Structured cause of an incident, across both incident sources.
A superset of the worker's wire FailureKind: every value the worker can report is storable here, plus the causes only the core can observe (a heartbeat that never pinged, a client that reported its own failure). The two enums are declared separately so the worker contract does not grow values the worker never emits — test_enums.py guards the subset relation, which is what keeps process_check_result able to store any incoming failure_kind.
The raw human-readable reason lives in Incident.cause_detail.
Filter by structured failure cause.
Only incidents that were active within the last N days. An incident still open is always included, whenever it started. Combined with status=open this makes period_days a no-op, since every open incident already satisfies that arm — use status=resolved or omit status to see the window take effect.
Headers
Response
Successful Response
Changes
No recorded changes to this operation across all 1 revision of this API.