Traces

GET /traces

List all traces with pagination.

Query parameters:

Param	Type	Default
page	int	1
limit	int	20

Response:

{
  "data": [
    {
      "traceId": "tr_abc123",
      "startTime": "2026-03-31T12:00:00Z",
      "endTime": "2026-03-31T12:00:01Z",
      "eventCount": 5,
      "errorCount": 0,
      "agents": ["researcher", "writer"]
    }
  ],
  "meta": { "total": 50, "page": 1, "limit": 20, "totalPages": 3 }
}

GET /traces/:traceId/events

Get all events for a trace, ordered by timestamp.

GET /traces/:traceId/summary

Get a summary of a trace.

Response:

{
  "traceId": "tr_abc123",
  "eventCount": 12,
  "agents": ["researcher", "writer"],
  "eventTypes": ["agent.start", "agent.tool_call.start", "agent.end"],
  "startTime": "2026-03-31T12:00:00Z",
  "endTime": "2026-03-31T12:00:01Z",
  "duration": 1340,
  "errorCount": 0,
  "toolCallCount": 3,
  "handoffCount": 1
}