interface TraceQueryParamsHeader param: application/json, or text/event-stream (required for semantic matching)
Body param: ai_search translates natural language into structured filters,
semantic criteria and time bounds. Cannot be combined with sem_filter. With full
AI search enabled, also cannot be combined with explicit filter expressions;
otherwise retains legacy semantic-only behavior. Must contain nonempty text of
at most 2000 UTF-8 bytes.
Body param: max_feedback_modified_at is the exclusive upper bound (RFC3339) on
feedback modified_at, applied to the feedback conditions in trace_filter or
tree_filter (for example eq(feedback_key, "correctness")). Requires at least
one feedback condition. Root runs must still fall within the start_time
window.
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_feedback_modified_at is the inclusive lower bound (RFC3339) on
feedback modified_at, applied to the feedback conditions in trace_filter or
tree_filter (for example eq(feedback_key, "correctness")). Requires at least
one feedback condition. Root runs must still fall within the start_time
window.
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: SemFilter evaluates a plain-language criterion against trajectory messages, AND-ed with structured filters.
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.