Skip to main content
POST
/
v1
/
triage
/
{incidentId}
Classify incident
curl --request POST \
  --url https://api.example.com/v1/triage/{incidentId}

​
Overview

Triggers the AI triage pipeline for an incident. The triage agent analyzes the incident title, description, and any available signals to classify severity, produce a summary, and recommend which specialist agents should investigate. Required role: admin or member

​
Path parameters

​
incidentId
string
required
The unique identifier of the incident to classify. Example: inc_01HX9VTPQR3KF8MZWBYD5N6JCE.

​
Response

Returns 200 OK with the triage classification result. 
{
  "incidentId": "inc_01HX9VTPQR3KF8MZWBYD5N6JCE",
  "priority": "critical",
  "summary": "A latency spike on prod-db-01 is likely caused by a slow query introduced in a recent deployment. Immediate database and performance analysis is recommended.",
  "confidence": 0.91,
  "suggestedAgents": [
    "database-specialist",
    "performance-analyzer",
    "deployment-tracker"
  ]
}
FieldTypeDescription
incidentIdstringThe incident that was classified
prioritystringAI-determined priority: critical, high, medium, or low
summarystringBrief human-readable summary of the incident and recommended next steps
confidencenumberModel confidence score from 0.0 to 1.0. Values above 0.85 are high confidence.
suggestedAgentsstring[]List of specialist agent IDs recommended for the investigation phase
To view the full triage evidence including model details and token usage, use GET /v1/triage//evidence.

​
Examples

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