List Run Events

GET

/v2/runs/:id/events

GET

/v2/runs/:id/events

$ curl https://api.bctrl.ai/v2/runs/id/events \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json"

200Retrieved

1 {
2   "data": [
3     {
4       "category": "runtime",
5       "id": "evt-20240612-0001",
6       "runId": "7e4a1b2c-3d4e-5f6a-7b8c-9d0e1f2a3b4c",
7       "runtimeId": "9f8e7d6c-5b4a-3c2d-1e0f-123456789abc",
8       "runtimeType": "browser",
9       "time": "2024-06-12T14:22:35Z",
10       "type": "runtime.start",
11       "commandId": "cmd-9f8b7a6c",
12       "connectionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
13       "data": {
14         "eventDetail": "Runtime started successfully",
15         "memoryUsageMB": 512,
16         "cpuLoadPercent": 15.3,
17         "isActive": true
18       },
19       "fileId": "1c2d3e4f-5a6b-7c8d-9e0f-123456789abc",
20       "invocationId": "inv-20240612-01",
21       "name": "RuntimeStart",
22       "status": "success",
23       "toolCallId": "toolcall-7890"
24     }
25   ],
26   "nextCursor": "cursor_20240612_14_22_35"
27 }

List the canonical machine-readable event stream for a run using the simplified v2 response envelope.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

idstringRequired

Query parameters

cursorstringOptional>=1 character

limitintegerOptional<=500

typestring or list of stringsOptional

categoryenum or list of enumsOptional

connectionIdstringOptionalformat: "uuid"

Response

Default Response

datalist of objects

nextCursorstring or null