Get incident

Get detailed information about a specific incident.

GET /v1/incidents/{incidentId}

Get incident

cURL

curl --request GET \
  --url https://api.example.com/v1/incidents/{incidentId}

Overview

Returns the full details for a single incident, including assigned agents, root cause analysis, and recommended actions if an investigation has completed.

Required role: Any authenticated user (viewer or above)

Path parameters

incidentId · string · required

The unique identifier of the incident. Example: inc_01HX9VTPQR3KF8MZWBYD5N6JCE.

Response

Returns 200 OK with the full incident object.

{
  "incidentId": "inc_01HX9VTPQR3KF8MZWBYD5N6JCE",
  "title": "Database latency spike on prod-db-01",
  "severity": "critical",
  "status": "investigating",
  "source": "automated",
  "assignedAgents": ["database-specialist", "performance-analyzer"],
  "rootCause": "Unindexed query introduced in deploy d9f3a21 causing full table scans on the orders table.",
  "recommendedActions": [
    "Add composite index on (tenant_id, created_at) for the orders table.",
    "Roll back deploy d9f3a21 if index migration cannot be applied within the SLA window."
  ],
  "createdAt": "2024-04-01T10:23:45Z",
  "updatedAt": "2024-04-01T10:31:12Z"
}

Field	Type	Description
incidentId	string	Unique identifier for the incident
title	string	Short description of the incident
severity	string	Severity level: critical, high, medium, or low
status	string	Current lifecycle status of the incident
source	string	How the incident was created: automated or manual
assignedAgents	string[]	AI agents currently assigned to investigate this incident
rootCause	string	Root cause summary from investigation. null if not yet determined.
recommendedActions	string[]	Suggested remediation steps. Empty array if investigation is pending.
createdAt	string	ISO 8601 timestamp when the incident was created
updatedAt	string	ISO 8601 timestamp when the incident was last updated

Returns 404 Not Found if no incident exists with the given ID.

Examples

curl

curl https://api.causeflow.ai/v1/incidents/inc_01HX9VTPQR3KF8MZWBYD5N6JCE \
  -H "Authorization: Bearer <token>"