Query Runs

POST /api/v1/runs/query

Error

A valid request URL is required to generate request examples

200

{
  "runs": [
    {
      "name": "<string>",
      "trace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "dotted_order": "<string>",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "<string>",
      "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "app_path": "<string>",
      "inputs": {},
      "inputs_preview": "<string>",
      "start_time": "2023-11-07T05:31:56Z",
      "end_time": "2023-11-07T05:31:56Z",
      "extra": {},
      "error": "<string>",
      "execution_order": 1,
      "serialized": {},
      "outputs": {},
      "outputs_preview": "<string>",
      "parent_run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "manifest_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "manifest_s3_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "events": [
        {}
      ],
      "tags": [
        "<string>"
      ],
      "inputs_s3_urls": {},
      "outputs_s3_urls": {},
      "s3_urls": {},
      "trace_min_start_time": "2023-11-07T05:31:56Z",
      "trace_max_start_time": "2023-11-07T05:31:56Z",
      "child_run_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "direct_child_run_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "parent_run_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "feedback_stats": {},
      "reference_example_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "total_tokens": 0,
      "prompt_tokens": 0,
      "completion_tokens": 0,
      "prompt_token_details": {},
      "completion_token_details": {},
      "total_cost": "<string>",
      "prompt_cost": "<string>",
      "completion_cost": "<string>",
      "prompt_cost_details": {},
      "completion_cost_details": {},
      "price_model_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "first_token_time": "2023-11-07T05:31:56Z",
      "messages": [
        {}
      ],
      "last_queued_at": "2023-11-07T05:31:56Z",
      "in_dataset": true,
      "share_token": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "trace_first_received_at": "2023-11-07T05:31:56Z",
      "ttl_seconds": 123,
      "trace_upgrade": false,
      "reference_dataset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "thread_id": "<string>"
    }
  ],
  "cursors": {},
  "search_cursors": {},
  "parsed_query": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

API KeyTenant IDBearer Auth

X-API-Key · string · header · required

Body

application/json

Query params for runs query endpoint.

id · string<uuid>[] | null

trace · string<uuid> | null

Filter runs by trace ID. When set, limit and cursor-based pagination are not applied — all runs in the trace are returned in a single response.

parent_run · string<uuid> | null

run_type · enum<string> | null

Enum for run types.

Available options: tool, chain, llm, retriever, embedding, prompt, parser

session · string<uuid>[] | null

reference_example · string<uuid>[] | null

execution_order · integer | null

Required range: 1 <= x <= 1

start_time · string<date-time> | null

end_time · string<date-time> | null

error · boolean | null

query · string | null

filter · string | null

trace_filter · string | null

tree_filter · string | null

is_root · boolean | null

data_source_type · enum<string> | null

Enum for run data source types.

Available options: current, historical, lite, root_lite, runs_feedbacks_rmt_wide

skip_pagination · boolean | null

search_filter · string | null

use_experimental_search · boolean · default: false

cursor · string | null

limit · integer · default: 100

Maximum number of runs to return. Not applied when trace is set — all runs in the trace are returned in a single response.

Required range: 1 <= x <= 100

select · enum<string>[]

Enum for available run columns.

Available options: id, name, run_type, start_time, end_time, status, error, extra, events, inputs, inputs_preview, inputs_s3_urls, inputs_or_signed_url, outputs, outputs_preview, outputs_s3_urls, outputs_or_signed_url, s3_urls, error_or_signed_url, events_or_signed_url, extra_or_signed_url, serialized_or_signed_url, parent_run_id, manifest_id, manifest_s3_id, manifest, session_id, serialized, reference_example_id, reference_dataset_id, total_tokens, prompt_tokens, prompt_token_details, completion_tokens, completion_token_details, total_cost, prompt_cost, prompt_cost_details, completion_cost, completion_cost_details, price_model_id, first_token_time, trace_id, dotted_order, last_queued_at, feedback_stats, child_run_ids, parent_run_ids, tags, in_dataset, app_path, share_token, trace_tier, trace_first_received_at, ttl_seconds, trace_upgrade, thread_id, trace_min_max_start_time, messages, inserted_at

order · enum<string> · default: desc

Enum for run start date order.

Available options: asc, desc

skip_prev_cursor · boolean · default: false

Response

200

application/json

Successful Response

runs · RunSchema · object[] · required

Show child attributes

cursors · Cursors · object · required

Show child attributes

search_cursors · Search Cursors · object | null

Show child attributes

parsed_query · string | null