v54

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-08-05308532588.0 KB
Spans

Get spans by project_name or project_id and optionally by trace_id and/or type

Get spans by project_name or project_id and optionally by trace_id and/or type

get/v1/private/spans

Query parameters

pageinteger
sizeinteger
project_namestring
project_idstring uuid
trace_idstring uuid
type'general' | 'tool' | 'llm' | 'guardrail'
filtersstring
truncateboolean

Truncate input, output and metadata to slim payloads

strip_attachmentsboolean

If true, returns attachment references like [file.png]; if false, downloads and reinjects stripped attachments

sortingstring
excludestring
searchstring

Full-text search across span fields

from_timestring date-time

Filter spans created from this time (ISO-8601 format).

to_timestring date-time

Filter spans created up to this time (ISO-8601 format). If not provided, defaults to current time. Must be after 'from_time'.

Response

Spans resource

pageinteger
sizeinteger
totalinteger
sortableBystring[]