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

​
Overview

Dispatches a team of specialist AI agents to investigate an incident. Each agent analyzes the incident from a different angle (infrastructure, code changes, dependencies, etc.) and contributes evidence to the root cause analysis. Starting an investigation consumes 1 investigation from your monthly plan quota. Required role: admin, owner, or operator

​
Path parameters

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

​
Response

Returns 200 OK when the investigation has been started successfully. 
{
  "incidentId": "inc_01HX9VTPQR3KF8MZWBYD5N6JCE",
  "status": "investigating",
  "agentsDispatched": [
    "database-specialist",
    "performance-analyzer",
    "deployment-tracker"
  ],
  "message": "Investigation started. Results will be available once agents complete their analysis."
}
FieldTypeDescription
incidentIdstringThe incident being investigated
statusstringAlways "investigating" after a successful dispatch
agentsDispatchedstring[]The specialist agents that have been dispatched for this investigation
messagestringHuman-readable confirmation message
Investigation results are available asynchronously. Poll GET /v1/investigation/ or listen for the investigation.completed webhook event to know when results are ready.
Starting an investigation consumes 1 investigation from your monthly quota. To check your remaining allowance, see the investigationsRemaining field in the Get incident response.

​
Examples

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