Skip to main content
POST
/
v1
/
remediation
/
{remediationId}
/
feedback
Submit remediation feedback
curl --request POST \
  --url https://api.example.com/v1/remediation/{remediationId}/feedback \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "outcome": "<string>",
  "rating": 123,
  "timeToResolutionMinutes": 123,
  "comment": "<string>"
}
'

Overview

Submits feedback on a completed remediation action. This helps CauseFlow’s AI improve the quality and precision of future remediation proposals for similar incidents. Required role: admin or member

Request headers

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

Path parameters

remediationId
string
required
The unique identifier of the remediation. Example: rem_01HX9VTPQR3KF8MZWBYD5N6JCE.

Request body

outcome
string
required
The actual outcome. One of: resolved, partial, no_effect, made_worse.
rating
integer
required
Overall quality rating from 1 (poor) to 5 (excellent).
timeToResolutionMinutes
integer
How many minutes after executing the remediation the incident was fully resolved.
comment
string
Optional free-text feedback describing what worked, what didn’t, and any corrections.

Response

Returns 201 Created.
{
  "feedbackId": "fbk_01HX9VTPQR3KF8MZWBYD5N6JCF",
  "remediationId": "rem_01HX9VTPQR3KF8MZWBYD5N6JCE",
  "submittedAt": "2024-04-01T15:30:00Z"
}
FieldTypeDescription
feedbackIdstringUnique identifier for this feedback record
remediationIdstringThe remediation this feedback applies to
submittedAtstringISO 8601 timestamp

Error responses

StatusError codeDescription
401unauthorizedMissing or invalid JWT
403forbiddenCaller lacks required role
404remediation_not_foundNo remediation with the given ID
409feedback_already_submittedFeedback already submitted for this remediation

Examples

curl https://api.causeflow.ai/v1/remediation/rem_01HX9VTPQR3KF8MZWBYD5N6JCE/feedback \
  -X POST \
  -H "Authorization: Bearer eyJhbGc..." \
  -H "Content-Type: application/json" \
  -d '{
    "outcome": "resolved",
    "rating": 5,
    "timeToResolutionMinutes": 12,
    "comment": "Scaling the connection pool immediately resolved the 503 errors"
  }'

Get remediation detail

View full remediation plan and execution log

List remediations

Browse all remediations for your tenant