Skip to main content
GET
/
v1
/
incidents
/
{incidentId}
Get incident
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"
}
FieldTypeDescription
incidentIdstringUnique identifier for the incident
titlestringShort description of the incident
severitystringSeverity level: critical, high, medium, or low
statusstringCurrent lifecycle status of the incident
sourcestringHow the incident was created: automated or manual
assignedAgentsstring[]AI agents currently assigned to investigate this incident
rootCausestringRoot cause summary from investigation. null if not yet determined.
recommendedActionsstring[]Suggested remediation steps. Empty array if investigation is pending.
createdAtstringISO 8601 timestamp when the incident was created
updatedAtstringISO 8601 timestamp when the incident was last updated
Returns 404 Not Found if no incident exists with the given ID.

​
Examples

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