API Reference
Traces
REST API endpoints for managing traces.
Create a trace
POST /api/traces{
"name": "answer-question",
"tags": ["production", "gpt-4o"]
}Both fields are optional. Response:
{
"id": "01J...",
"name": "answer-question",
"tags": ["production", "gpt-4o"],
"started_at": "2024-06-15T12:00:00Z",
"ended_at": null
}List traces
GET /api/tracesQuery params: limit (default 50), cursor (opaque string from previous response).
{
"traces": [
{
"id": "01J...",
"name": "answer-question",
"tags": ["production"],
"started_at": "2024-06-15T12:00:00Z",
"ended_at": "2024-06-15T12:00:02Z"
}
],
"count": 1
}Get a trace
GET /api/traces/:trace_idReturns all spans belonging to this trace:
{
"spans": [ ... ],
"count": 3
}Delete a trace
DELETE /api/traces/:trace_idDeletes the trace and all its spans. Returns:
{
"trace_id": "01J...",
"spans_deleted": 3
}Clear all traces
DELETE /api/tracesDeletes everything. Returns:
{
"message": "All traces cleared"
}