List Run Commands

GET

/v2/runs/:id/commands

GET

/v2/runs/:id/commands

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

200Retrieved

1 {
2   "data": [
3     {
4       "category": "command",
5       "id": "event-12345",
6       "runId": "7e57d004-2b97-0e7a-b45f-5387367791cd",
7       "runtimeId": "9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d",
8       "runtimeType": "browser",
9       "time": "2024-06-15T10:25:30Z",
10       "type": "click",
11       "commandId": "cmd-9f8b7a6d",
12       "connectionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
13       "data": {
14         "button": "submit",
15         "value": true,
16         "attempts": 1
17       },
18       "fileId": "1c2d3e4f-5a6b-7c8d-9e0f-123456789abc",
19       "invocationId": "inv-67890",
20       "name": "SubmitForm",
21       "status": "completed",
22       "toolCallId": "toolcall-001"
23     }
24   ],
25   "nextCursor": "cursor_abcdef123456"
26 }

List observed automation command events 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

connectionIdstringOptionalformat: "uuid"

Response

Default Response

datalist of objects

nextCursorstring or null