Get one action run

GET

/spaces/:spaceId/runs/:runId

GET

/spaces/:spaceId/runs/:runId

$ curl https://api.cloudraker.com/spaces/spaceId/runs/runId \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json"

200Retrieved

1 {
2   "data": {
3     "id": "run_01J8K9L0M1N2O3P4Q5R6",
4     "spaceId": "space_123abc456def",
5     "actionSlug": "extract-structured",
6     "actionVersion": 3,
7     "installedActionId": "action_789xyz123uvw",
8     "playbookRunId": "playbook_456def789ghi",
9     "status": "running",
10     "error": null,
11     "artifacts": [
12       {
13         "id": "artifact_001",
14         "kind": "link",
15         "title": "Run Summary Report",
16         "url": "https://app.cloudraker.com/reports/run_01J8K9L0M1N2O3P4Q5R6/summary",
17         "open": "tab"
18       }
19     ],
20     "awaitingInput": [
21       {
22         "id": "input_123",
23         "title": "Confirm Data Extraction Parameters",
24         "url": "https://app.cloudraker.com/runs/run_01J8K9L0M1N2O3P4Q5R6/input/123",
25         "resolved": false
26       }
27     ],
28     "documents": [
29       {
30         "fileId": "file_abc123xyz",
31         "name": "invoice_2024_01.pdf",
32         "contentType": "application/pdf"
33       }
34     ],
35     "outputs": [
36       {
37         "fileId": "output_file_789",
38         "kind": "json",
39         "key": "extracted_data.json",
40         "size": 24576
41       }
42     ],
43     "timeoutSeconds": 3600,
44     "lastEventAt": "2024-01-15T09:30:00Z",
45     "createdAt": "2024-01-15T08:45:00Z",
46     "createdBy": "user_987654321",
47     "finishedAt": null
48   }
49 }

Fetches a single run by id within the space. Requires space:read (denied → 404); a runId belonging to another space also 404s. Returns 200 { data: ActionRun } with the run’s status (running | awaiting_input | done | failed), error, output, documents (input files), outputs (downloadable byproducts — each fileId streams via getRunOutput), artifacts (rendered links) and awaitingInput. Callers who lack space:contribute get capability fields (URLs, storage references, and artifacts) redacted.

Fetches a single run by id within the space. Requires `space:read` (denied → 404); a `runId` belonging to another space also 404s. Returns 200 `{ data: ActionRun }` with the run's `status` (`running` | `awaiting_input` | `done` | `failed`), `error`, `output`, `documents` (input files), `outputs` (downloadable byproducts — each `fileId` streams via `getRunOutput`), `artifacts` (rendered links) and `awaitingInput`. Callers who lack `space:contribute` get capability fields (URLs, storage references, and `artifacts`) redacted.

Authentication

AuthorizationBearer

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

Path parameters

spaceIdstringRequired

runIdstringRequired

Response

The run.

dataobject