v52

OpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-08-03308532588.7 KB

Traces

Get trace by id

get/v1/private/traces/{id}

Path parameters

idstring uuid required

Query parameters

strip_attachmentsboolean

If true, returns attachment references like [file.png]; if false, downloads and reinjects attachment content from S3 (default: false for backward compatibility)

Response

Trace resource

idstring uuid

project_idstring uuid

namestring

start_timestring date-time required

end_timestring date-time

inputJsonListStringPublic

outputJsonListStringPublic

metadataJsonListStringPublic

tagsstring[]

usageobject

created_atstring date-time

last_updated_atstring date-time

created_bystring

last_updated_bystring

total_estimated_costnumber

span_countinteger

durationnumber double

Duration in milliseconds as a decimal number to support sub-millisecond precision

ttftnumber double

Time to first token in milliseconds

thread_idstring

visibility_mode'default' | 'hidden'

llm_span_countinteger

has_tool_spansboolean

providersstring[]

List of unique provider names from all spans in this trace, sorted alphabetically

source'sdk' | 'experiment' | 'playground' | 'optimization' | 'evaluator'

environmentstring