interface TraceQueryParamsHeader param: application/json, or text/event-stream (required when ai_search is set)
Body param: ai_search is a plain-language criterion evaluated against the
messages from the agent trajectory scoped to the trace. AND-ed with the ordinary
filters. Requires semantic filtering enabled for the deployment. Must contain
nonempty text of at most 2000 UTF-8 bytes.
Body param: max_start_time is the exclusive upper bound for the root-run start
time scan (RFC3339). Defaults to the request time when omitted.
Body param: min_start_time is the inclusive lower bound for the root-run start
time scan (RFC3339). Defaults to 24 hours before the request when omitted.
Body param: project_id is the UUID of the tracing project that owns the
traces. Required.
Body param: selects lists which properties to include on each returned trace.
Properties listed here are routed to the appropriate sub-object on each item:
total_tokens, total_cost, and first_token_time appear under
trace_aggregates; everything else appears under root_run. If omitted, only
id is returned on root_run.
Body param: trace_filter narrows results to traces whose root run matches this
LangSmith filter expression. This filter targets root runs only —
is_root = true is implied. See
https://docs.langchain.com/langsmith/trace-query-syntax#filter-query-language
for syntax.
Body param: trace_ids is an optional fast-path restriction to a known set of
trace UUIDs. Equivalent in result to including each UUID in a trace_filter,
but more efficient at scale.
Body param: tree_filter narrows results to traces containing at least one run
anywhere in the run tree (root or descendant) that matches this LangSmith filter
expression.