Skip to main content

Incidents

Space-scoped endpoints for managing quality incidents — auto-correlated alert groups with blast radius visualization, root cause tracking, and downstream notification.

Feature Gate

Incident endpoints require the quality.incidents feature to be enabled.

Base Path​

/spaces/{slug}/incidents

Authentication​

All endpoints require an authenticated user session.

Endpoints​

List Incidents​

GET /spaces/{slug}/incidents

Query Parameters

ParameterTypeDefaultDescription
statusstringnullFilter: open, investigating, resolved
skipint0Pagination offset
limitint50Page size (max 200)

Response 200 OK

{
  "items": [
    {
      "id": "...",
      "title": "Correlated quality failures in finance pipeline",
      "status": "open",
      "severity": "critical",
      "alert_count": 5,
      "root_cause": null,
      "root_product_id": null,
      "blast_radius_snapshot": ["product-a", "product-b", "product-c"],
      "created_at": "2026-02-27T14:00:00Z"
    }
  ],
  "total": 3
}

Get Incident​

GET /spaces/{slug}/incidents/{incident_id}

Retrieve full incident detail including associated alerts and blast radius.

Get Incident Timeline​

GET /spaces/{slug}/incidents/{incident_id}/timeline

Chronological timeline of all alerts added to the incident.

Response 200 OK

[
  {
    "alert_id": "...",
    "alert_type": "quality_check_failed",
    "added_at": "2026-02-27T14:00:00Z",
    "severity": "critical"
  }
]

Update Incident​

PATCH /spaces/{slug}/incidents/{incident_id}

Update root cause, status, severity, or description.

Request Body

{
  "root_cause": "Upstream ETL pipeline failure in source system",
  "status": "investigating",
  "severity": "high",
  "root_product_id": "..."
}

Resolve Incident​

POST /spaces/{slug}/incidents/{incident_id}/resolve

Mark an incident as resolved. Sets the resolved_at timestamp.

Notify Downstream​

POST /spaces/{slug}/incidents/{incident_id}/notify-downstream

Send notifications to owners and stewards of all data products in the blast radius. Notifications are sent via email and in-platform notification center.

Response 200 OK

{
  "notified_users": 8,
  "affected_products": 5
}
POST /spaces/{slug}/incidents/{incident_id}/link-ticket

Link an existing issue tracker ticket to the incident for coordinated resolution.

Request Body

{
  "ticket_id": "..."
}
  • Alerts — Alert management and acknowledgement
  • Quality Checks — Quality check execution and history