v1

latestOpenAPI 3.1.02026-07-26231646860.9 KB

trace

Query Partial Sessions

post/v2/projects/{project_id}/sessions/partial_search

Path parameters

project_idstring uuid4 required

Request body

starting_tokeninteger

limitinteger

previous_last_row_idstring uuid4 nullable

log_stream_idstring uuid4 nullable

Log stream id associated with the traces.

experiment_idstring uuid4 nullable

Experiment id associated with the traces.

metrics_testing_idstring uuid4 nullable

Metrics testing id associated with the traces.

truncate_fieldsboolean

include_countsboolean

If True, include computed child counts (e.g., num_traces for sessions, num_spans for traces).

include_code_metric_metadataboolean

If True, include per-row scorer metadata (the dict returned alongside the score by code-based scorers via the (score, metadata) tuple-return contract) on each MetricSuccess in the response. Off by default to keep payloads small for callers that don't need it.

Example request

{
  "filters": [
    {
      "case_sensitive": true,
      "name": "input",
      "operator": "eq",
      "type": "text",
      "value": "example input"
    }
  ],
  "log_stream_id": "00000000-0000-0000-0000-000000000000",
  "pagination": {
    "limit": 5,
    "starting_token": 0
  },
  "select_columns": {
    "column_ids": [
      "id",
      "metrics/agentic_session_success",
      "metrics/completeness_gpt"
    ],
    "include_all_feedback": false,
    "include_all_metrics": false,
    "includes_metric_columns": true,
    "metric_columns_names": [
      "agentic_session_success",
      "completeness_gpt"
    ]
  },
  "sort": {
    "ascending": false,
    "name": "updated_at",
    "sort_type": "column"
  }
}

Response

Successful Response

starting_tokeninteger

limitinteger

paginatedboolean

next_starting_tokeninteger nullable

last_row_idstring uuid4 nullable

num_recordsinteger required

number of records

Example response

{
  "next_starting_token": 2,
  "num_rows": 2,
  "paginated": true,
  "records": [
    {
      "annotation_aggregates": {},
      "annotation_agreement": {},
      "annotation_queue_ids": [],
      "annotations": {},
      "created_at": "2026-07-20T08:46:30.235284Z",
      "dataset_metadata": {},
      "error_message": "",
      "feedback_rating_info": {},
      "file_ids": [],
      "file_modalities": [],
      "id": "1a0939d1-8b43-4fe3-a91c-196e2d9847e3",
      "input": "Who is a smart LLM?",
      "is_complete": true,
      "metrics": {},
      "name": "",
      "progress_message": "",
      "tags": [],
      "type": "trace",
      "user_metadata": {}
    },
    {
      "annotation_aggregates": {},
      "annotation_agreement": {},
      "annotation_queue_ids": [],
      "annotations": {},
      "created_at": "2026-07-20T08:46:30.235533Z",
      "dataset_metadata": {},
      "error_message": "",
      "feedback_rating_info": {},
      "file_ids": [],
      "file_modalities": [],
      "id": "1edc2401-24b4-448c-a392-b36932293061",
      "input": [
        {
          "content": "Who is a smart LLM?",
          "role": "user"
        }
      ],
      "is_complete": true,
      "metrics": {},
      "name": "",
      "output": {
        "content": "",
        "role": "assistant"
      },
      "progress_message": "",
      "tags": [],
      "type": "llm",
      "user_metadata": {}
    }
  ]
}