v48

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-275867561.6 MB
run

Validate Runs Query

Validate runs query syntax, returns errors for broken queries.

post/api/v1/runs/query/validate

Request body

idstring[] nullable
tracestring uuid nullable
parent_runstring uuid nullable
run_type'tool' | 'chain' | 'llm' | 'retriever' | 'embedding' | 'prompt' | 'parser'

Enum for run types.

sessionstring[] nullable
reference_examplestring[] nullable
execution_orderinteger nullable
start_timestring date-time nullable
end_timestring date-time nullable
errorboolean nullable
querystring nullable
filterstring nullable
trace_filterstring nullable
tree_filterstring nullable
is_rootboolean nullable
data_source_type'current' | 'historical' | 'lite' | 'root_lite' | 'runs_feedbacks_rmt_wide'

Enum for run data source types.

skip_paginationboolean nullable
search_filterstring nullable
use_experimental_searchboolean
cursorstring nullable
limitinteger
selectRunSelect[]
order'asc' | 'desc'

Enum for run start date order.

skip_prev_cursorboolean

Response

Successful Response

validboolean required