List Run Events | BCTRL Docs

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

{
  "events": [
    {
      "id": "evt-001",
      "kind": "command",
      "runId": "9b2d6f4e-3c4a-4f1a-9a2b-1d2e3f4a5b6c",
      "runtimeId": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "runtimeKind": "browser",
      "source": "platform",
      "spaceId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "time": "2024-06-15T10:15:30Z",
      "type": "shell_command",
      "artifactId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "commandId": "cmd-12345",
      "connectionId": "7e57d004-2b97-0e7a-b45f-5387367791cd",
      "contextId": "ctx-98765",
      "correlationId": "corr-54321",
      "data": {
        "command": "npm install",
        "exitCode": 0,
        "output": "Installation completed successfully."
      },
      "name": "Execute npm install",
      "pageId": "page-001",
      "status": "completed",
      "toolCallId": "tool-7890"
    }
  ],
  "nextCursor": "cursor-abcdef123456"
}

List the canonical machine-readable event stream for a run. Use this to analyze commands, connection traffic, runtime signals, network events, artifacts, tool calls, and lifecycle facts in timestamp order.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

idstringRequired

Query parameters

cursorstringOptional>=1 character

limitintegerOptional<=500

typestring or list of stringsOptional

kindstring or list of stringsOptional

sourcestring or list of stringsOptional

connectionIdstringOptionalformat: "uuid"

pageIdstringOptional

contextIdstringOptional

Response

Default Response

eventslist of objects

nextCursorstring or null