Skip to main content
POST
/
v1
/
investigation
/
{incidentId}
/
known-solution
Respond to known solution
curl --request POST \
  --url https://api.example.com/v1/investigation/{incidentId}/known-solution \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "action": "<string>",
  "patternId": "<string>",
  "notes": "<string>"
}
'

​
Overview

When the investigation pipeline finds a matching prior incident or runbook, it emits an investigation.known_solution_found event and pauses for confirmation. Use this endpoint to accept the suggested solution (and fast-track remediation) or dismiss it (and continue full investigation). Required role: admin or member

​
Request headers

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

​
Path parameters

​
incidentId
string
required
The incident ID for which a known solution was found. Example: inc_EXAMPLE_01JX.

​
Request body

​
action
string
required
One of accept or dismiss. Accepting fast-tracks remediation based on the matched solution. Dismissing continues the full investigation pipeline.
​
patternId
string
required
The ID of the matched pattern or runbook, from the investigation.known_solution_found event payload.
​
notes
string
Optional notes explaining why you accepted or dismissed the suggestion. Stored in the incident audit log.

​
Response

Returns 200 OK. 
{
  "incidentId": "inc_EXAMPLE_01JX",
  "action": "accept",
  "patternId": "ptn_01HX9VTPQR3KF8MZWBYD5N6JCE",
  "nextStatus": "awaiting_approval"
}
FieldTypeDescription
incidentIdstringThe incident ID
actionstringThe action taken: accept or dismiss
patternIdstringThe matched pattern ID
nextStatusstringResulting incident status after the action

​
Error responses

StatusError codeDescription
401unauthorizedMissing or invalid JWT
403forbiddenCaller lacks required role
404incident_not_foundNo incident with the given ID
404pattern_not_foundThe patternId does not match a known pattern
409no_pending_decisionNo known-solution match is awaiting a response for this incident

​
Examples

curl https://api.causeflow.ai/v1/investigation/inc_EXAMPLE_01JX/known-solution \
  -X POST \
  -H "Authorization: Bearer eyJhbGc..." \
  -H "Content-Type: application/json" \
  -d '{
    "action": "accept",
    "patternId": "ptn_01HX9VTPQR3KF8MZWBYD5N6JCE",
    "notes": "Pattern matches exactly — same pool exhaustion we saw in March"
  }'

Start investigation

Start the full AI investigation pipeline

Approve remediation

Approve the proposed remediation plan