Get one playbook run

GET

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

GET

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

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

{
  "data": {
    "id": "string",
    "spaceId": "string",
    "playbookId": "string",
    "playbookVersion": 1,
    "playbookName": "string",
    "status": "running",
    "fileScope": {
      "mode": "string"
    },
    "taskProgress": {
      "total": 1,
      "completed": 1
    },
    "pendingApproval": {
      "id": "string",
      "kind": "pre",
      "actionName": "string",
      "requestedAt": "2024-01-15T09:30:00Z"
    },
    "result": "string",
    "error": "string",
    "startedBy": "string",
    "createdAt": "2024-01-15T09:30:00Z",
    "updatedAt": "2024-01-15T09:30:00Z",
    "finishedAt": "2024-01-15T09:30:00Z",
    "currentActivity": "string",
    "snapshot": {
      "playbookId": "string",
      "version": 1,
      "name": "string",
      "description": "string",
      "tasks": [
        {
          "id": "string",
          "title": "string",
          "dependsOn": [
            "string"
          ],
          "status": "pending",
          "summary": "string",
          "completedAt": "2024-01-15T09:30:00Z",
          "instructions": "string",
          "executor": "agent",
          "assignee": "string",
          "claimedBy": "string",
          "completedBy": "string",
          "note": "string",
          "fileIds": [
            "string"
          ]
        }
      ],
      "actions": [
        {
          "installedActionId": "string",
          "preApproval": true,
          "postApproval": true,
          "dependsOn": [
            "string"
          ],
          "actionSlug": "string",
          "actionName": "string",
          "trigger": "agent",
          "browserSession": {
            "status": "pairing",
            "createdAt": "2024-01-15T09:30:00Z"
          }
        }
      ],
      "fileScope": {
        "mode": "string"
      }
    }
  }
}

Fetches one playbook run with full detail: current status, task progress, any pending approval, current activity, result/error, and the immutable snapshot of the playbook (tasks + actions + fileScope) captured at launch. Authorization: space:read (org admins bypass); missing → 404; 404 also when the run does not exist in this space. Returns { data: PlaybookRunDetail }.

Authentication

AuthorizationBearer

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

Path parameters

spaceIdstringRequired

runIdstringRequired

Response

The playbook run, with its launch snapshot.

dataobject

Errors

404

Not Found Error