Traces

Get trace by id

Changed on

Get trace by id

get/v1/private/traces/{id}

Request

  • Base URL
    http://localhost:5173/api
  • URL
    http://localhost:5173/api/v1/private/traces/{id}
  • Auth
    none declared

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

    • info

      added the optional property to the response with the status

    • warning

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

    • warning

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

    • warning

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