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 57 revisions of this API.129

    • added the new CUSTOM_CLASSIFIER enum value to the guardrails_validations/items/checks/items/name response property for the response status 200

      response-property-enum-value-added

    • added the new LLM_JUDGE enum value to the guardrails_validations/items/checks/items/name response property for the response status 200

      response-property-enum-value-added

    • added the new PROMPT_INJECTION enum value to the guardrails_validations/items/checks/items/name response property for the response status 200

      response-property-enum-value-added

    • added the new evaluator enum value to the source response property for the response status 200

      response-property-enum-value-added

    • added the optional property feedback_scores/items/value_by_author/additionalProperties/author to the response with the 200 status

      response-optional-property-added

    • added the optional property feedback_scores/items/value_by_author/additionalProperties/source_queue_id to the response with the 200 status

      response-optional-property-added

    • added the optional property span_feedback_scores/items/value_by_author/additionalProperties/author to the response with the 200 status

      response-optional-property-added

    • added the optional property span_feedback_scores/items/value_by_author/additionalProperties/source_queue_id to the response with the 200 status

      response-optional-property-added

    • added the optional property comments/items/source_queue_id to the response with the 200 status

      response-optional-property-added

    • added the optional property feedback_scores/items/source_queue_id to the response with the 200 status

      response-optional-property-added

    • added the optional property span_feedback_scores/items/source_queue_id to the response with the 200 status

      response-optional-property-added

    • added the optional property environment to the response with the 200 status

      response-optional-property-added

    • removed the optional property comments/items/source_queue_id from the response with the 200 status

      response-optional-property-removed

    • removed the optional property environment from the response with the 200 status

      response-optional-property-removed

    • removed the optional property feedback_scores/items/source_queue_id from the response with the 200 status

      response-optional-property-removed

    • removed the optional property feedback_scores/items/value_by_author/additionalProperties/author from the response with the 200 status

      response-optional-property-removed

    • removed the optional property feedback_scores/items/value_by_author/additionalProperties/source_queue_id from the response with the 200 status

      response-optional-property-removed

    • removed the optional property span_feedback_scores/items/source_queue_id from the response with the 200 status

      response-optional-property-removed

    • removed the optional property span_feedback_scores/items/value_by_author/additionalProperties/author from the response with the 200 status

      response-optional-property-removed

    • removed the optional property span_feedback_scores/items/value_by_author/additionalProperties/source_queue_id from the response with the 200 status

      response-optional-property-removed

    • removed the evaluator enum value from the source response property for the response status 200

      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