List action runs in a space

GET

/spaces/:spaceId/runs

GET

/spaces/:spaceId/runs

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

200Retrieved

1 {
2   "data": [
3     {
4       "id": "run_01J8K9L0M1N2O3P4Q5R6",
5       "spaceId": "space_9a8b7c6d5e4f3g2h1i0j",
6       "actionSlug": "extract-structured",
7       "actionVersion": 3,
8       "installedActionId": "action_1234567890abcdef",
9       "playbookRunId": "playbook_abcdef1234567890",
10       "status": "running",
11       "error": null,
12       "artifacts": [
13         {
14           "id": "artifact_0011223344556677",
15           "kind": "link",
16           "title": "Extracted Data JSON",
17           "url": "https://storage.cloudraker.com/artifacts/0011223344556677",
18           "open": "tab"
19         }
20       ],
21       "awaitingInput": [
22         {
23           "id": "input_9988776655443322",
24           "title": "Confirm extraction parameters",
25           "url": "https://app.cloudraker.com/spaces/space_9a8b7c6d5e4f3g2h1i0j/runs/run_01J8K9L0M1N2O3P4Q5R6/input/input_9988776655443322",
26           "resolved": false
27         }
28       ],
29       "documents": [
30         {
31           "fileId": "file_abcdef1234567890",
32           "name": "source_document.pdf",
33           "contentType": "application/pdf"
34         }
35       ],
36       "outputs": [
37         {
38           "fileId": "file_output_1234abcd",
39           "kind": "json",
40           "key": "extracted_data.json",
41           "size": 24576.5
42         }
43       ],
44       "timeoutSeconds": 300,
45       "lastEventAt": "2024-01-15T09:30:00Z",
46       "createdAt": "2024-01-15T09:00:00Z",
47       "createdBy": "user_7f6e5d4c3b2a1f0e",
48       "finishedAt": null
49     }
50   ],
51   "has_more": true
52 }

Lists the space’s action runs, newest first. Requires space:read (denied → 404, which also hides the space’s existence). Query: limit (1–100) and starting_after (a run id, cursor pagination). Returns 200 { data: ActionRun[], has_more: boolean } — keep paging with starting_after set to the last returned id while has_more is true. Callers who lack space:contribute get capability fields (download and storage references, plus the artifacts array) redacted from each run.

Lists the space's action runs, newest first. Requires `space:read` (denied → 404, which also hides the space's existence). Query: `limit` (1–100) and `starting_after` (a run id, cursor pagination). Returns 200 `{ data: ActionRun[], has_more: boolean }` — keep paging with `starting_after` set to the last returned id while `has_more` is true. Callers who lack `space:contribute` get capability fields (download and storage references, plus the `artifacts` array) redacted from each run.

Authentication

AuthorizationBearer

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

Path parameters

spaceIdstringRequired

Query parameters

limitintegerOptional1-100Defaults to 20

Page size, 1–100. Defaults to 20.

starting_afterstringOptional>=1 character

Cursor: the id of the last run on the previous page.

Response

One page of runs, newest first.

datalist of objects

has_moreboolean