Skip to main content
POST
/
v1
/
triage
/
{incidentId}
Start triage
curl --request POST \
  --url https://api.example.com/v1/triage/{incidentId} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "priority": "<string>",
  "context": "<string>"
}
'

​
Overview

Initiates the AI triage pipeline for an incident. Triage classifies severity, assigns specialist agents, and produces an initial evidence snapshot. If triage has already run for this incident, the request is idempotent — it returns the existing triage result without re-running. Required role: admin or member

​
Request headers

​
Authorization
string
required
JWT Bearer token. Format: Bearer <your-jwt>.

​
Path parameters

​
incidentId
string
required
The unique identifier of the incident to triage. Example: inc_EXAMPLE_01JX.

​
Request body

​
priority
string
Optional override for initial priority. One of: critical, high, medium, low. If omitted, severity is determined by the AI classifier.
​
context
string
Optional free-text context to seed the triage classifier. Useful for providing business impact or on-call notes before AI analysis begins.

​
Response

Returns 201 Created when triage is queued, or 200 OK when triage already ran. 
{
  "triageId": "tri_01HX9VTPQR3KF8MZWBYD5N6JCE",
  "incidentId": "inc_EXAMPLE_01JX",
  "status": "running",
  "classifiedSeverity": null,
  "assignedAgents": [],
  "startedAt": "2024-04-01T14:30:05Z"
}
FieldTypeDescription
triageIdstringUnique identifier for this triage run
incidentIdstringThe incident being triaged
statusstringOne of: running, completed, failed
classifiedSeveritystringAI-assigned severity once complete: critical, high, medium, low, info. null while running
assignedAgentsstring[]Specialist agents assigned. Populated when triage completes
startedAtstringISO 8601 timestamp when triage started

​
Error responses

StatusError codeDescription
401unauthorizedMissing or invalid JWT
403forbiddenCaller lacks admin or member role
404incident_not_foundNo incident with the given ID
409triage_already_runningTriage is already in progress for this incident
429quota_exceededInvestigation quota exhausted for this billing period
500triage_errorInternal error starting triage pipeline

​
Examples

curl https://api.causeflow.ai/v1/triage/inc_EXAMPLE_01JX \
  -X POST \
  -H "Authorization: Bearer eyJhbGc..." \
  -H "Content-Type: application/json" \
  -d '{
    "context": "On-call reports EU payment latency spike since 14:25 UTC deploy"
  }'

Get evidence

Retrieve evidence collected during triage

Start investigation

Kick off the full AI investigation pipeline