usage:read.
List runs
Get one Run
runId. The response includes up to 100 events and a hasMoreEvents flag.
Page through events
WhenhasMoreEvents is true, request:
nextCursor unchanged:
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
List runs and page through event timelines.
usage:read.
GET /openapi/v1/runs?limit=25&status=FAILED
X-API-Key: YOUR_WORKSPACE_API_KEY
| Parameter | Description |
|---|---|
limit | 1 to 100. Defaults to 25. |
cursor | Opaque nextCursor from the previous response. |
agentId | Internal Lynx Agent UUID filter. |
status | RUNNING, COMPLETED, FAILED, or CANCELLED. |
{
"items": [
{
"id": "ebd7c740-e284-4db1-86c0-6c1a78eb30f8",
"runId": "run_01JZQ3VY4K",
"status": "FAILED",
"startedAt": "2026-07-23T08:00:00.000Z",
"endedAt": "2026-07-23T08:00:02.120Z",
"agent": {
"id": "aa971534-cce6-4ca8-a950-99f8e779ae0a",
"name": "support-agent"
},
"usage": {
"promptTokens": 240,
"completionTokens": 32,
"totalTokens": 272,
"cost": 0.0021
}
}
],
"nextCursor": null
}
GET /openapi/v1/runs/run_01JZQ3VY4K
runId. The response includes up to 100 events and a hasMoreEvents flag.
hasMoreEvents is true, request:
GET /openapi/v1/runs/run_01JZQ3VY4K/events?limit=100
nextCursor unchanged:
{
"items": [
{
"id": "63782fe2-11ed-49a7-869e-4da55a445641",
"eventId": "evt_llm_01",
"eventType": "LLM_CALL",
"label": "Choose payment action",
"timestamp": "2026-07-23T08:00:01.000Z",
"payload": {
"model": "model-name"
}
}
],
"nextCursor": null
}
Was this page helpful?