v64

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

List traces matching a saved search

Returns a cursor-paginated page of traces that match the saved search's query + filters. Each row uses the same Trace shape as listTraces — use the trace point-lookup endpoints (getTrace, listTraceSpans, getTraceSpan, listTraceAnnotations) to drill into individual traces.

get/v1/projects/{projectSlug}/searches/{searchSlug}/traces

Path parameters

projectSlugstring required

Project slug (human-readable identifier)

Project slug (human-readable identifier)

searchSlugstring required

Saved-search slug (human-readable identifier within the project).

Saved-search slug (human-readable identifier within the project).

Query parameters

cursorstring

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

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

limitinteger

Page size. Defaults to 50; max 200.

Page size. Defaults to 50; max 200.

sortBy'relevance' | 'startTime' | 'endTime' | 'durationNs' | 'tokensTotal' | 'costTotalMicrocents'

Field to sort by. Defaults to startTime. Pass relevance to rank by semantic match against the saved search's query (best match first, then most recent).

Field to sort by. Defaults to startTime. Pass relevance to rank by semantic match against the saved search's query (best match first, then most recent).

sortDirection'asc' | 'desc'

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

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

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.