Skip to content

List recent incidents

GET
/api/v1/incidents

Returns paginated list of recent incidents.

Authorizations

Parameters

Query Parameters

tenant_id
required

Tenant identifier

string

Tenant identifier

limit

Maximum incidents to return

integer
default: 20 >= 1 <= 100

Maximum incidents to return

offset

Number of incidents to skip

integer

Number of incidents to skip

severity
Any of:
string

Filter by severity (SEV1-SEV4)

status
Any of:
string

Filter by status

Responses

200

Successful Response

Response for incident list endpoint.

object
incidents
Array<object>

A classified incident record.

Args: incident_id: Unique incident identifier. tenant_id: Tenant where the incident occurred. severity: Severity level (SEV1, SEV2, SEV3, SEV4). category: Incident category (infrastructure, agent, billing, security, integration). title: Short incident title. description: Detailed incident description. source: Detection source (health_check, error_spike, latency_anomaly, tenant_complaint). status: Current status (detected, investigating, mitigating, resolved). detected_at: ISO timestamp when the incident was detected. resolved_at: ISO timestamp when resolved (None if ongoing). runbook_executed: Whether a runbook was executed. escalated: Whether the incident was escalated.

object
category
string
default: infrastructure
description
string
""
detected_at
string
escalated
boolean
incident_id
string
resolved_at
Any of:
string
runbook_executed
boolean
severity
string
default: SEV4
source
string
default: health_check
status
string
default: detected
tenant_id
string
""
title
string
""
total
integer

422

Validation Error

object
detail
Array<object>
object
ctx
object
input
loc
required
Array
msg
required
string
type
required
string