Skip to main content
GET
/
v1
/
notifications
/
approvals
/
pending
Pending approvals
curl --request GET \
  --url https://api.example.com/v1/notifications/approvals/pending \
  --header 'Authorization: <authorization>'

​
Overview

Returns all remediation proposals that require your approval before execution. Each item includes the proposed action, affected incident, and the deadline for response. Required role: admin or member

​
Request headers

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

​
Response

Returns 200 OK. 
{
  "items": [
    {
      "approvalId": "apr_01HX9VTPQR3KF8MZWBYD5N6JCE",
      "remediationId": "rem_01HX9VTPQR3KF8MZWBYD5N6JCE",
      "incidentId": "inc_EXAMPLE_01JX",
      "incidentTitle": "Checkout service returning 503 for EU customers",
      "remediationTitle": "Scale payment processor connection pool from 50 to 150",
      "steps": [
        "Update ECS task definition: set DB_POOL_SIZE=150",
        "Trigger rolling deploy of checkout-service"
      ],
      "requestedAt": "2024-04-01T14:35:00Z",
      "expiresAt": "2024-04-01T16:35:00Z"
    }
  ],
  "total": 1
}
FieldTypeDescription
approvalIdstringUnique approval request identifier
remediationIdstringRemediation plan awaiting approval
incidentIdstringRelated incident
remediationTitlestringShort description of the proposed action
stepsstring[]Ordered list of steps to be executed on approval
requestedAtstringISO 8601 timestamp when approval was requested
expiresAtstringISO 8601 deadline — approval auto-expires after this time

​
Error responses

StatusError codeDescription
401unauthorizedMissing or invalid JWT
403forbiddenCaller lacks required role

​
Examples

curl https://api.causeflow.ai/v1/notifications/approvals/pending \
  -H "Authorization: Bearer eyJhbGc..."

Respond to approval

Approve or reject a pending remediation

Get remediation detail

View the full remediation plan before deciding