Incidents

List Incidents

List incidents across the active organization's monitors, filtered by status, cause, period.

get/v1/incidents

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

monitor_idstring uuid nullable
status'open' | 'resolved'

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.

cause'TIMEOUT' | 'DNS_FAILURE' | 'CONNECTION_REFUSED' | 'TLS_INVALID' | 'HTTP_4XX' | 'HTTP_5XX' | 'HTTP_UNEXPECTED_STATUS' | 'KEYWORD_MISSING' | 'TOO_MANY_REDIRECTS' | 'TARGET_BLOCKED' | 'PORT_STATE_MISMATCH' | 'INVALID_TARGET' | 'HEARTBEAT_MISSED' | 'HEARTBEAT_FAILED' | 'UNKNOWN'

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.

period_daysinteger nullable

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.

pageinteger
sizeinteger

Headers

X-Organization-Idstring uuid nullable

Response

Successful Response

totalinteger required
pageinteger required
sizeinteger required
pagesinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.