TraceQueryParams

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.

cursor is the opaque string returned in a previous response's next_cursor.

max_start_time is the exclusive upper bound for the root-run start time scan (RFC3339). Defaults to the request time when omitted.

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.

page_size is the maximum number of traces to return per page.

Defaults to 20; must be between 1 and 100 when set.

project_id is the UUID of the tracing project that owns the traces. Required.

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.

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.

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.