List remediations

View all proposed remediations for an incident.

GET /v1/remediation/{incidentId}

List remediations

cURL

curl --request GET \
  --url https://api.example.com/v1/remediation/{incidentId}

Overview

Returns all proposed remediations for a given incident. Each remediation includes a description of what will be done, its current status, and the individual steps involved.

Required role: Any authenticated user (viewer or above)

Path parameters

incidentId · string · required

The unique identifier of the incident whose remediations you want to list. Example: inc_01HX9VTPQR3KF8MZWBYD5N6JCE.

Response

Returns 200 OK with an array of remediations for the incident.

{
  "remediations": [
    {
      "remediationId": "rem_01HX9VTPQR3KF8MZWBYD5N6JCE",
      "status": "awaiting_approval",
      "description": "Create a composite index on the orders table to resolve the full table scan causing the latency spike.",
      "steps": [
        {
          "type": "sql_migration",
          "status": "pending",
          "description": "CREATE INDEX CONCURRENTLY idx_orders_tenant_created ON orders (tenant_id, created_at DESC);"
        },
        {
          "type": "verification",
          "status": "pending",
          "description": "Verify query execution plan uses new index and P99 latency returns below 100ms."
        }
      ]
    },
    {
      "remediationId": "rem_01HX9VTPQR3KF8MZWBYD5N6JCF",
      "status": "awaiting_approval",
      "description": "Roll back deploy d9f3a21 to restore the index hint removed in the OrderRepository query builder.",
      "steps": [
        {
          "type": "deployment_rollback",
          "status": "pending",
          "description": "Roll back checkout-service to v2.4.0 (commit a8b3c2d)."
        }
      ]
    }
  ]
}

Field	Type	Description
remediations	array	All proposed remediations for the incident
remediations[].remediationId	string	Unique identifier for this remediation
remediations[].status	string	Current status: awaiting_approval, approved, rejected, executing, completed, failed
remediations[].description	string	Summary of what this remediation does
remediations[].steps	array	Ordered list of individual steps within this remediation
steps[].type	string	Step type, e.g. sql_migration, deployment_rollback, verification
steps[].status	string	Step status: pending, running, completed, failed
steps[].description	string	What this step does

Returns 404 Not Found if the incident does not exist.

Examples

curl

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