Traces

Get trace by id

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

Changes

Changed in 6 of the 67 revisions of this API.129

    • ●

      added the new CUSTOM_CLASSIFIER enum value to the //// response property for the response status

      response-property-enum-value-added

    • ●

      added the new LLM_JUDGE enum value to the //// response property for the response status

      response-property-enum-value-added

    • ●

      added the new PROMPT_INJECTION enum value to the //// response property for the response status

      response-property-enum-value-added

    • ●

      added the new evaluator enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the optional property //// to the response with the status

      response-optional-property-added

    • ○

      added the optional property //// to the response with the status

      response-optional-property-added

    • ○

      added the optional property //// to the response with the status

      response-optional-property-added

    • ○

      added the optional property //// to the response with the status

      response-optional-property-added

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ●

      removed the optional property // from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property // from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property //// from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property //// from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property // from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property //// from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property //// from the response with the status

      response-optional-property-removed

    • ○

      removed the evaluator enum value from the response property for the response status

      response-property-enum-value-removed

    This revision also has 40 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog