v64

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-03124241726.5 KB

Traces

List project traces

Returns a cursor-paginated page of traces in the project. Combine filters with query (free-text semantic search) to narrow the result set. Trace list rows exclude per-message LLM content — use getTrace for the full conversation view.

post/v1/projects/{projectSlug}/traces/list

Path parameters

projectSlugstring required

Project slug (human-readable identifier)

Request body

cursorstring

Opaque cursor returned in a previous response's nextCursor. Omit on the first page.

limitinteger

Page size. Defaults to 50; max 200.

Field to sort by. Defaults to startTime. Pass relevance together with query to rank by semantic match (best match first, then most recent).

sortDirection'asc' | 'desc'

Sort direction. Defaults to desc (most recent first).

querystring

Free-text semantic search across the trace's input and output messages. Combined with filters via AND.

filtersTraceFilterSet

Filter set keyed by trace field. Each entry holds an array of conditions ANDed together for that field; field-level groups are ANDed across the set. Valid fields: status, name, traceId, sessionId, simulationId, userId, tags, models, providers, serviceNames, tools, definedTools, duration, ttft, cost, spanCount, errorCount, tokensInput, tokensOutput, cacheHitRate, startTime, endTime; score-derived keys (score.passed, score.errored, score.value, score.source, score.sourceId, score.annotatorId, score.signalId, score.simulationId); and arbitrary metadata via metadata.<key>. startTime/endTime take ISO-8601 values (a trace's first span start / last span end). gtePercentile is only supported on duration/ttft/cost — not on time fields. Unknown fields are rejected rather than ignored.

Response

Page of traces

nextCursorstring nullable required

Opaque cursor for fetching the next page. null when there are no more pages. Pass it back in cursor to continue.

hasMoreboolean required

true when there is at least one more page after this one.