List Runs

GET

/v1/runs

GET

/v1/runs

1 curl https://api.bctrl.ai/v1/runs \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json"

200Retrieved

1 {
2   "nextCursor": "eyJwYWdlIjoyfQ==",
3   "runs": [
4     {
5       "createdAt": "2024-06-10T09:15:30Z",
6       "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
7       "runtimeId": "7e57d004-2b97-0e7a-b45f-5387367791cd",
8       "runtimeKind": "browser",
9       "spaceId": "9b2d7f3e-4c1a-4f2b-8d3e-1a2b3c4d5e6f",
10       "startedAt": "2024-06-10T09:15:30Z",
11       "status": "active",
12       "connector": "github-actions",
13       "durationMs": 12500,
14       "endedReason": "completed",
15       "failureReason": null,
16       "finishedAt": "2024-06-10T09:15:42Z",
17       "lastSeenAt": "2024-06-10T09:15:42Z",
18       "metadata": {
19         "branch": "main",
20         "commitHash": "a1b2c3d4e5f6g7h8i9j0"
21       }
22     }
23   ]
24 }

List runs across runtime work visible to the caller. Runs are the execution timelines that record activity, events, commands, and outputs.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Query parameters

cursorstringOptional>=1 character

limitintegerOptional<=200

statusstring or list of stringsOptional

spaceIdstringOptionalformat: "uuid"

runtimeIdstringOptionalformat: "uuid"

Response

Default Response

nextCursorstring or null

runslist of objects