List Runtime Runs

GET

/v1/spaces/:id/runtimes/:runtimeId/runs

GET

/v1/spaces/:id/runtimes/:runtimeId/runs

1 curl https://api.bctrl.ai/v1/spaces/id/runtimes/runtimeId/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": "9f8c7d6e-5b4a-3c2d-1e0f-123456789abc",
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         "commitHash": "a1b2c3d4",
20         "branch": "main",
21         "triggeredBy": "push"
22       }
23     }
24   ]
25 }

List the execution history for one runtime. Runs are the timeline of work produced by a runtime over its lifetime.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

idstringRequired

runtimeIdstringRequired

Query parameters

cursorstringOptional>=1 character

limitintegerOptional<=200

statusstring or list of stringsOptional

Response

Default Response

nextCursorstring or null

runslist of objects