List approvals for a playbook run

GET

https://api.cloudraker.com/spaces/:spaceId/playbook-runs/:runId/approvals

GET

/spaces/:spaceId/playbook-runs/:runId/approvals

curl https://api.cloudraker.com/spaces/spaceId/playbook-runs/runId/approvals \
     -H "Authorization: Bearer <token>"

200Retrieved

{
  "data": [
    {
      "id": "string",
      "kind": "pre",
      "actionSlug": "string",
      "installedActionId": "string",
      "actionName": "string",
      "actionRunId": "string",
      "rationale": "string",
      "files": [
        {
          "id": "string",
          "name": "string"
        }
      ],
      "params": {},
      "artifacts": [
        {
          "id": "string",
          "kind": "string",
          "title": "string",
          "url": "string",
          "open": "tab"
        }
      ],
      "status": "pending",
      "requestedAt": "2024-01-15T09:30:00Z",
      "decidedBy": "string",
      "decidedAt": "2024-01-15T09:30:00Z",
      "note": "string",
      "editedParams": {},
      "editedFileIds": [
        "string"
      ]
    }
  ]
}

Lists the run’s action approval requests — both pre-action gates (approve before an action runs) and post-action gates (review the action output) — each with its status (pending, approved, rejected, void), the proposed action (slug, installedActionId, name), rationale, params, input files, output and artifacts, plus decision metadata (decidedBy, decidedAt, note, edited params/files/output). Authorization: space:read (org admins bypass); missing → 404. Returns { data: Approval[] } with no pagination. Capability redaction: callers without space:contribute get artifact URLs / storage keys stripped from the payload.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

spaceIdstringRequired

runIdstringRequired

Response

The run’s approval requests.

datalist of objects