--- title: "Query Partial Traces" method: POST path: "/public/v2/projects/{project_id}/traces/partial_search" tags: ["trace"] --- # Query Partial Traces `POST /public/v2/projects/{project_id}/traces/partial_search` ## Path parameters - `project_id` string, uuid4, required ## Request body - LogRecordsPartialQueryRequest — Request to query a genai project run (log stream or experiment) with partial results. - `starting_token` integer - `limit` integer - `previous_last_row_id` string, uuid4, nullable - `log_stream_id` string, uuid4, nullable — Log stream id associated with the traces. - `experiment_id` string, uuid4, nullable — Experiment id associated with the traces. - `metrics_testing_id` string, uuid4, nullable — Metrics testing id associated with the traces. - `filters` union[] - union - LogRecordsIDFilter - `column_id` string, required — ID of the column to filter. - `operator` 'eq' | 'ne' | 'one_of' | 'not_in' | 'contains' - `value` union, required - string, uuid4 - union[] - union - … - string - `type` 'id' - LogRecordsDateFilter - `column_id` string, required — ID of the column to filter. - `operator` 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte', required - `value` string, date-time, required - `type` 'date' - LogRecordsNumberFilter - `column_id` string, required — ID of the column to filter. - `operator` 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'between', required - `value` union, required - integer - number - integer[] - number[] - `type` 'number' - LogRecordsBooleanFilter - `column_id` string, required — ID of the column to filter. - `operator` 'eq' | 'ne' - `value` boolean, required - `type` 'boolean' - LogRecordsCollectionFilter - `column_id` string, required — ID of the column to filter. - `operator` 'eq' | 'contains' | 'one_of' | 'not_in', required - `value` union, required - string - string[] - `case_sensitive` boolean - `type` 'collection' - LogRecordsTextFilter - `column_id` string, required — ID of the column to filter. - `operator` 'eq' | 'ne' | 'contains' | 'one_of' | 'not_in', required - `value` union, required - string - string[] - `case_sensitive` boolean - `type` 'text' - LogRecordsFullyAnnotatedFilter — Queue-scoped filter for records rated across all queue templates. - `column_id` 'fully_annotated' — Queue-scoped filter identifier. This filter only works for annotation-queue searches that provide queue context. - `type` 'fully_annotated' - `user_ids` string[], nullable — Optional queue member IDs to require for full annotation in a queue-scoped search. If omitted, all tracked queue members visible to the requester are used. - `filter_tree` union - FilterLeafAnnotatedUnionLogRecordsIDFilterLogRecordsDateFilterLogRecordsNumberFilterLogRecordsBooleanFilterLogRecordsCollectionFilterLogRecordsTextFilterLogRecordsFullyAnnotatedFilterFieldInfoAnnotationNoneTypeRequiredTrueDiscriminatorType - `filter` union, required - LogRecordsIDFilter - `column_id` string, required — ID of the column to filter. - `operator` 'eq' | 'ne' | 'one_of' | 'not_in' | 'contains' - `value` union, required - string, uuid4 - union[] - … - string - `type` 'id' - LogRecordsDateFilter - `column_id` string, required — ID of the column to filter. - `operator` 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte', required - `value` string, date-time, required - `type` 'date' - LogRecordsNumberFilter - `column_id` string, required — ID of the column to filter. - `operator` 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'between', required - `value` union, required - integer - number - integer[] - number[] - `type` 'number' - LogRecordsBooleanFilter - `column_id` string, required — ID of the column to filter. - `operator` 'eq' | 'ne' - `value` boolean, required - `type` 'boolean' - LogRecordsCollectionFilter - `column_id` string, required — ID of the column to filter. - `operator` 'eq' | 'contains' | 'one_of' | 'not_in', required - `value` union, required - string - string[] - `case_sensitive` boolean - `type` 'collection' - LogRecordsTextFilter - `column_id` string, required — ID of the column to filter. - `operator` 'eq' | 'ne' | 'contains' | 'one_of' | 'not_in', required - `value` union, required - string - string[] - `case_sensitive` boolean - `type` 'text' - LogRecordsFullyAnnotatedFilter — Queue-scoped filter for records rated across all queue templates. - `column_id` 'fully_annotated' — Queue-scoped filter identifier. This filter only works for annotation-queue searches that provide queue context. - `type` 'fully_annotated' - `user_ids` string[], nullable — Optional queue member IDs to require for full annotation in a queue-scoped search. If omitted, all tracked queue members visible to the requester are used. - AndNodeAnnotatedUnionLogRecordsIDFilterLogRecordsDateFilterLogRecordsNumberFilterLogRecordsBooleanFilterLogRecordsCollectionFilterLogRecordsTextFilterLogRecordsFullyAnnotatedFilterFieldInfoAnnotationNoneTypeRequiredTrueDiscriminatorTypeInput - `and` union[], required - union - FilterLeafAnnotatedUnionLogRecordsIDFilterLogRecordsDateFilterLogRecordsNumberFilterLogRecordsBooleanFilterLogRecordsCollectionFilterLogRecordsTextFilterLogRecordsFullyAnnotatedFilterFieldInfoAnnotationNoneTypeRequiredTrueDiscriminatorType - `filter` union, required - … - AndNodeAnnotatedUnionLogRecordsIDFilterLogRecordsDateFilterLogRecordsNumberFilterLogRecordsBooleanFilterLogRecordsCollectionFilterLogRecordsTextFilterLogRecordsFullyAnnotatedFilterFieldInfoAnnotationNoneTypeRequiredTrueDiscriminatorTypeInput — recursive - OrNodeAnnotatedUnionLogRecordsIDFilterLogRecordsDateFilterLogRecordsNumberFilterLogRecordsBooleanFilterLogRecordsCollectionFilterLogRecordsTextFilterLogRecordsFullyAnnotatedFilterFieldInfoAnnotationNoneTypeRequiredTrueDiscriminatorTypeInput - `or` union[], required - … - NotNodeAnnotatedUnionLogRecordsIDFilterLogRecordsDateFilterLogRecordsNumberFilterLogRecordsBooleanFilterLogRecordsCollectionFilterLogRecordsTextFilterLogRecordsFullyAnnotatedFilterFieldInfoAnnotationNoneTypeRequiredTrueDiscriminatorTypeInput - `not` union, required - … - OrNodeAnnotatedUnionLogRecordsIDFilterLogRecordsDateFilterLogRecordsNumberFilterLogRecordsBooleanFilterLogRecordsCollectionFilterLogRecordsTextFilterLogRecordsFullyAnnotatedFilterFieldInfoAnnotationNoneTypeRequiredTrueDiscriminatorTypeInput - `or` union[], required - union - FilterLeafAnnotatedUnionLogRecordsIDFilterLogRecordsDateFilterLogRecordsNumberFilterLogRecordsBooleanFilterLogRecordsCollectionFilterLogRecordsTextFilterLogRecordsFullyAnnotatedFilterFieldInfoAnnotationNoneTypeRequiredTrueDiscriminatorType - `filter` union, required - … - AndNodeAnnotatedUnionLogRecordsIDFilterLogRecordsDateFilterLogRecordsNumberFilterLogRecordsBooleanFilterLogRecordsCollectionFilterLogRecordsTextFilterLogRecordsFullyAnnotatedFilterFieldInfoAnnotationNoneTypeRequiredTrueDiscriminatorTypeInput - `and` union[], required - … - OrNodeAnnotatedUnionLogRecordsIDFilterLogRecordsDateFilterLogRecordsNumberFilterLogRecordsBooleanFilterLogRecordsCollectionFilterLogRecordsTextFilterLogRecordsFullyAnnotatedFilterFieldInfoAnnotationNoneTypeRequiredTrueDiscriminatorTypeInput — recursive - NotNodeAnnotatedUnionLogRecordsIDFilterLogRecordsDateFilterLogRecordsNumberFilterLogRecordsBooleanFilterLogRecordsCollectionFilterLogRecordsTextFilterLogRecordsFullyAnnotatedFilterFieldInfoAnnotationNoneTypeRequiredTrueDiscriminatorTypeInput - `not` union, required - … - NotNodeAnnotatedUnionLogRecordsIDFilterLogRecordsDateFilterLogRecordsNumberFilterLogRecordsBooleanFilterLogRecordsCollectionFilterLogRecordsTextFilterLogRecordsFullyAnnotatedFilterFieldInfoAnnotationNoneTypeRequiredTrueDiscriminatorTypeInput - `not` union, required - FilterLeafAnnotatedUnionLogRecordsIDFilterLogRecordsDateFilterLogRecordsNumberFilterLogRecordsBooleanFilterLogRecordsCollectionFilterLogRecordsTextFilterLogRecordsFullyAnnotatedFilterFieldInfoAnnotationNoneTypeRequiredTrueDiscriminatorType - `filter` union, required - LogRecordsIDFilter - … - LogRecordsDateFilter - … - LogRecordsNumberFilter - … - LogRecordsBooleanFilter - … - LogRecordsCollectionFilter - … - LogRecordsTextFilter - … - LogRecordsFullyAnnotatedFilter — Queue-scoped filter for records rated across all queue templates. - … - AndNodeAnnotatedUnionLogRecordsIDFilterLogRecordsDateFilterLogRecordsNumberFilterLogRecordsBooleanFilterLogRecordsCollectionFilterLogRecordsTextFilterLogRecordsFullyAnnotatedFilterFieldInfoAnnotationNoneTypeRequiredTrueDiscriminatorTypeInput - `and` union[], required - union - … - OrNodeAnnotatedUnionLogRecordsIDFilterLogRecordsDateFilterLogRecordsNumberFilterLogRecordsBooleanFilterLogRecordsCollectionFilterLogRecordsTextFilterLogRecordsFullyAnnotatedFilterFieldInfoAnnotationNoneTypeRequiredTrueDiscriminatorTypeInput - `or` union[], required - union - … - NotNodeAnnotatedUnionLogRecordsIDFilterLogRecordsDateFilterLogRecordsNumberFilterLogRecordsBooleanFilterLogRecordsCollectionFilterLogRecordsTextFilterLogRecordsFullyAnnotatedFilterFieldInfoAnnotationNoneTypeRequiredTrueDiscriminatorTypeInput — recursive - `sort` LogRecordsSortClause - `column_id` string, required — ID of the column to sort. - `ascending` boolean - `sort_type` 'column' - `truncate_fields` boolean - `include_counts` boolean — If True, include computed child counts (e.g., num_traces for sessions, num_spans for traces). - `include_code_metric_metadata` boolean — 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. - `select_columns` SelectColumns, required - `column_ids` string[] - `include_all_metrics` boolean - `include_all_feedback` boolean ## Response `200` Successful Response - LogRecordsPartialQueryResponse - `starting_token` integer - `limit` integer - `paginated` boolean - `next_starting_token` integer, nullable - `last_row_id` string, uuid4, nullable - `records` union[] — records matching the query - union - PartialExtendedTraceRecord - `type` 'trace' — Type of the trace, span or session. - `input` union — Input to the trace or span. - string - union[] - union - … - `redacted_input` union — Redacted input of the trace or span. - string - union[] - union - … - `output` union — Output of the trace or span. - string - union[] - union - … - `redacted_output` union — Redacted output of the trace or span. - string - union[] - union - … - `name` string — Name of the trace, span or session. - `created_at` string, date-time — Timestamp of the trace or span's creation. - `user_metadata` object — Metadata associated with this trace or span. - `tags` string[] — Tags associated with this trace or span. - `status_code` integer, nullable — Status code of the trace or span. Used for logging failure or error states. - `metrics` Metrics - `duration_ns` integer, nullable — Duration of the trace or span in nanoseconds. Displayed as 'Latency' in Galileo. - `external_id` string, nullable — A user-provided session, trace or span ID. - `dataset_input` string, nullable — Input to the dataset associated with this trace - `dataset_output` string, nullable — Output from the dataset associated with this trace - `dataset_metadata` object — Metadata from the dataset associated with this trace - `id` string, uuid, nullable — Galileo ID of the trace - `session_id` string, uuid, nullable — Galileo ID of the session containing the trace (or the same value as id for a trace) - `trace_id` string, uuid, nullable — Galileo ID of the trace containing the span (or the same value as id for a trace) - `project_id` string, uuid, nullable — Galileo ID of the project associated with this trace or span - `run_id` string, uuid, nullable — Galileo ID of the run (log stream or experiment) associated with this trace or span - `updated_at` string, date-time, nullable — Timestamp of the session or trace or span's last update - `has_children` boolean, nullable — Whether or not this trace or span has child spans - `metrics_batch_id` string, uuid4, nullable — Galileo ID of the metrics batch associated with this trace or span - `session_batch_id` string, uuid4, nullable — Galileo ID of the metrics batch associated with this trace or span - `feedback_rating_info` object — Feedback information related to the record - `annotations` object — Annotations keyed by template ID and annotator ID - `file_ids` string[] — IDs of files associated with this record - `file_modalities` ContentModality[] — Modalities of files associated with this record - `annotation_aggregates` object — Annotation aggregate information keyed by template ID - `annotation_agreement` object — Annotation agreement scores keyed by template ID - `overall_annotation_agreement` number, nullable — Average annotation agreement across all templates in the queue - `annotation_queue_ids` string[] — IDs of annotation queues this record is in - `fully_annotated` boolean, nullable — Whether every field is annotated by every annotator in the queue - `progress_message` string — Runner progress text written directly to CH span - `error_message` string — Runner error text written directly to CH span - `metric_info` object, nullable — Detailed information about the metrics associated with this trace or span - `files` object, nullable — File metadata keyed by file ID for files associated with this record - `is_complete` boolean — Whether the trace is complete or not - `num_spans` integer, nullable - PartialExtendedAgentSpanRecord - `type` 'agent' — Type of the trace, span or session. - `input` union — Input to the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - union[] - union - … - `redacted_input` union — Redacted input of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - union[] - union - … - `output` union — Output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - DocumentOutput[] - `content` string, required — Content of the document. - `metadata` object - union[] - union - … - ControlResult - `action` 'deny' | 'steer' | 'observe', required - `matched` boolean, required — Whether the control matched. False covers both non-match and error cases; use error_message to distinguish errors. - `confidence` number, nullable — Confidence score reported by the control evaluation result. - `error_message` string, nullable — Error text when control evaluation failed. This should be null for normal matches and non-matches. - `redacted_output` union — Redacted output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - DocumentOutput[] - `content` string, required — Content of the document. - `metadata` object - union[] - union - … - ControlResult - `action` 'deny' | 'steer' | 'observe', required - `matched` boolean, required — Whether the control matched. False covers both non-match and error cases; use error_message to distinguish errors. - `confidence` number, nullable — Confidence score reported by the control evaluation result. - `error_message` string, nullable — Error text when control evaluation failed. This should be null for normal matches and non-matches. - `name` string — Name of the trace, span or session. - `created_at` string, date-time — Timestamp of the trace or span's creation. - `user_metadata` object — Metadata associated with this trace or span. - `tags` string[] — Tags associated with this trace or span. - `status_code` integer, nullable — Status code of the trace or span. Used for logging failure or error states. - `metrics` Metrics - `duration_ns` integer, nullable — Duration of the trace or span in nanoseconds. Displayed as 'Latency' in Galileo. - `external_id` string, nullable — A user-provided session, trace or span ID. - `dataset_input` string, nullable — Input to the dataset associated with this trace - `dataset_output` string, nullable — Output from the dataset associated with this trace - `dataset_metadata` object — Metadata from the dataset associated with this trace - `id` string, uuid, nullable — Galileo ID of the session, trace or span - `session_id` string, uuid, nullable — Galileo ID of the session containing the trace (or the same value as id for a trace) - `trace_id` string, uuid4, nullable — Galileo ID of the trace containing the span (or the same value as id for a trace) - `project_id` string, uuid, nullable — Galileo ID of the project associated with this trace or span - `run_id` string, uuid, nullable — Galileo ID of the run (log stream or experiment) associated with this trace or span - `updated_at` string, date-time, nullable — Timestamp of the session or trace or span's last update - `has_children` boolean, nullable — Whether or not this trace or span has child spans - `metrics_batch_id` string, uuid4, nullable — Galileo ID of the metrics batch associated with this trace or span - `session_batch_id` string, uuid4, nullable — Galileo ID of the metrics batch associated with this trace or span - `feedback_rating_info` object — Feedback information related to the record - `annotations` object — Annotations keyed by template ID and annotator ID - `file_ids` string[] — IDs of files associated with this record - `file_modalities` ContentModality[] — Modalities of files associated with this record - `annotation_aggregates` object — Annotation aggregate information keyed by template ID - `annotation_agreement` object — Annotation agreement scores keyed by template ID - `overall_annotation_agreement` number, nullable — Average annotation agreement across all templates in the queue - `annotation_queue_ids` string[] — IDs of annotation queues this record is in - `fully_annotated` boolean, nullable — Whether every field is annotated by every annotator in the queue - `progress_message` string — Runner progress text written directly to CH span - `error_message` string — Runner error text written directly to CH span - `metric_info` object, nullable — Detailed information about the metrics associated with this trace or span - `files` object, nullable — File metadata keyed by file ID for files associated with this record - `parent_id` string, uuid, nullable — Galileo ID of the parent of this span - `is_complete` boolean — Whether the parent trace is complete or not - `step_number` integer, nullable — Topological step number of the span. - `agent_type` 'default' | 'planner' | 'react' | 'reflection' | 'router' | 'classifier' | 'supervisor' | 'judge' - `agent_name` string, nullable — Name of the agent. - PartialExtendedWorkflowSpanRecord - `type` 'workflow' — Type of the trace, span or session. - `input` union — Input to the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - union[] - union - … - `redacted_input` union — Redacted input of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - union[] - union - … - `output` union — Output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - DocumentOutput[] - `content` string, required — Content of the document. - `metadata` object - union[] - union - … - ControlResult - `action` 'deny' | 'steer' | 'observe', required - `matched` boolean, required — Whether the control matched. False covers both non-match and error cases; use error_message to distinguish errors. - `confidence` number, nullable — Confidence score reported by the control evaluation result. - `error_message` string, nullable — Error text when control evaluation failed. This should be null for normal matches and non-matches. - `redacted_output` union — Redacted output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - DocumentOutput[] - `content` string, required — Content of the document. - `metadata` object - union[] - union - … - ControlResult - `action` 'deny' | 'steer' | 'observe', required - `matched` boolean, required — Whether the control matched. False covers both non-match and error cases; use error_message to distinguish errors. - `confidence` number, nullable — Confidence score reported by the control evaluation result. - `error_message` string, nullable — Error text when control evaluation failed. This should be null for normal matches and non-matches. - `name` string — Name of the trace, span or session. - `created_at` string, date-time — Timestamp of the trace or span's creation. - `user_metadata` object — Metadata associated with this trace or span. - `tags` string[] — Tags associated with this trace or span. - `status_code` integer, nullable — Status code of the trace or span. Used for logging failure or error states. - `metrics` Metrics - `duration_ns` integer, nullable — Duration of the trace or span in nanoseconds. Displayed as 'Latency' in Galileo. - `external_id` string, nullable — A user-provided session, trace or span ID. - `dataset_input` string, nullable — Input to the dataset associated with this trace - `dataset_output` string, nullable — Output from the dataset associated with this trace - `dataset_metadata` object — Metadata from the dataset associated with this trace - `id` string, uuid, nullable — Galileo ID of the session, trace or span - `session_id` string, uuid, nullable — Galileo ID of the session containing the trace (or the same value as id for a trace) - `trace_id` string, uuid4, nullable — Galileo ID of the trace containing the span (or the same value as id for a trace) - `project_id` string, uuid, nullable — Galileo ID of the project associated with this trace or span - `run_id` string, uuid, nullable — Galileo ID of the run (log stream or experiment) associated with this trace or span - `updated_at` string, date-time, nullable — Timestamp of the session or trace or span's last update - `has_children` boolean, nullable — Whether or not this trace or span has child spans - `metrics_batch_id` string, uuid4, nullable — Galileo ID of the metrics batch associated with this trace or span - `session_batch_id` string, uuid4, nullable — Galileo ID of the metrics batch associated with this trace or span - `feedback_rating_info` object — Feedback information related to the record - `annotations` object — Annotations keyed by template ID and annotator ID - `file_ids` string[] — IDs of files associated with this record - `file_modalities` ContentModality[] — Modalities of files associated with this record - `annotation_aggregates` object — Annotation aggregate information keyed by template ID - `annotation_agreement` object — Annotation agreement scores keyed by template ID - `overall_annotation_agreement` number, nullable — Average annotation agreement across all templates in the queue - `annotation_queue_ids` string[] — IDs of annotation queues this record is in - `fully_annotated` boolean, nullable — Whether every field is annotated by every annotator in the queue - `progress_message` string — Runner progress text written directly to CH span - `error_message` string — Runner error text written directly to CH span - `metric_info` object, nullable — Detailed information about the metrics associated with this trace or span - `files` object, nullable — File metadata keyed by file ID for files associated with this record - `parent_id` string, uuid, nullable — Galileo ID of the parent of this span - `is_complete` boolean — Whether the parent trace is complete or not - `step_number` integer, nullable — Topological step number of the span. - PartialExtendedLlmSpanRecord - `type` 'llm' — Type of the trace, span or session. - `input` GalileoCoreSchemasLoggingLlmMessage[] — Input to the trace or span. - `content` union, required - string - union[] - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - `id` string, required - `function` ToolCallFunction, required - … - `redacted_input` GalileoCoreSchemasLoggingLlmMessage[], nullable — Redacted input of the trace or span. - `content` union, required - string - union[] - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - `id` string, required - `function` ToolCallFunction, required - … - `output` GalileoCoreSchemasLoggingLlmMessage - `content` union, required - string - union[] - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - `id` string, required - `function` ToolCallFunction, required - … - `redacted_output` GalileoCoreSchemasLoggingLlmMessage - `content` union, required - string - union[] - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - `id` string, required - `function` ToolCallFunction, required - … - `name` string — Name of the trace, span or session. - `created_at` string, date-time — Timestamp of the trace or span's creation. - `user_metadata` object — Metadata associated with this trace or span. - `tags` string[] — Tags associated with this trace or span. - `status_code` integer, nullable — Status code of the trace or span. Used for logging failure or error states. - `metrics` LlmMetrics - `duration_ns` integer, nullable — Duration of the trace or span in nanoseconds. Displayed as 'Latency' in Galileo. - `num_input_tokens` integer, nullable — Number of input tokens. - `num_output_tokens` integer, nullable — Number of output tokens. - `num_total_tokens` integer, nullable — Total number of tokens. - `time_to_first_token_ns` integer, nullable — Time until the first token was generated in nanoseconds. - `num_image_input_tokens` integer, nullable — Number of image input tokens. - `num_audio_input_tokens` integer, nullable — Number of audio input tokens. - `num_audio_output_tokens` integer, nullable — Number of audio output tokens. - `num_image_output_tokens` integer, nullable — Number of image output tokens. - `external_id` string, nullable — A user-provided session, trace or span ID. - `dataset_input` string, nullable — Input to the dataset associated with this trace - `dataset_output` string, nullable — Output from the dataset associated with this trace - `dataset_metadata` object — Metadata from the dataset associated with this trace - `id` string, uuid, nullable — Galileo ID of the session, trace or span - `session_id` string, uuid, nullable — Galileo ID of the session containing the trace (or the same value as id for a trace) - `trace_id` string, uuid4, nullable — Galileo ID of the trace containing the span (or the same value as id for a trace) - `project_id` string, uuid, nullable — Galileo ID of the project associated with this trace or span - `run_id` string, uuid, nullable — Galileo ID of the run (log stream or experiment) associated with this trace or span - `updated_at` string, date-time, nullable — Timestamp of the session or trace or span's last update - `has_children` boolean, nullable — Whether or not this trace or span has child spans - `metrics_batch_id` string, uuid4, nullable — Galileo ID of the metrics batch associated with this trace or span - `session_batch_id` string, uuid4, nullable — Galileo ID of the metrics batch associated with this trace or span - `feedback_rating_info` object — Feedback information related to the record - `annotations` object — Annotations keyed by template ID and annotator ID - `file_ids` string[] — IDs of files associated with this record - `file_modalities` ContentModality[] — Modalities of files associated with this record - `annotation_aggregates` object — Annotation aggregate information keyed by template ID - `annotation_agreement` object — Annotation agreement scores keyed by template ID - `overall_annotation_agreement` number, nullable — Average annotation agreement across all templates in the queue - `annotation_queue_ids` string[] — IDs of annotation queues this record is in - `fully_annotated` boolean, nullable — Whether every field is annotated by every annotator in the queue - `progress_message` string — Runner progress text written directly to CH span - `error_message` string — Runner error text written directly to CH span - `metric_info` object, nullable — Detailed information about the metrics associated with this trace or span - `files` object, nullable — File metadata keyed by file ID for files associated with this record - `parent_id` string, uuid, nullable — Galileo ID of the parent of this span - `is_complete` boolean — Whether the parent trace is complete or not - `step_number` integer, nullable — Topological step number of the span. - `tools` object[], nullable — List of available tools passed to the LLM on invocation. - `events` union[], nullable — List of reasoning, internal tool call, or MCP events that occurred during the LLM span. - union - MessageEvent — An output message from the model. - … - ReasoningEvent — Internal reasoning/thinking from the model (e.g., OpenAI o1/o3 reasoning tokens). - … - InternalToolCall — A tool call executed internally by the model during reasoning. This represents internal tools like web search, code execution, file search, etc. that the model invokes (not user-defined functions or MCP tools). - … - WebSearchCallEvent — An OpenAI-style web search call event. - … - ImageGenerationEvent — An image generation event from the model. - … - MCPCallEvent — A Model Context Protocol (MCP) tool call. MCP is a protocol for connecting LLMs to external tools/data sources. This is distinct from internal tools because it involves external integrations. - … - MCPListToolsEvent — MCP list tools event - when the model queries available MCP tools. - … - MCPApprovalRequestEvent — MCP approval request - when human approval is needed for an MCP tool call. - … - `model` string, nullable — Model used for this span. - `temperature` number, nullable — Temperature used for generation. - `finish_reason` string, nullable — Reason for finishing. - PartialExtendedToolSpanRecord - `type` 'tool' — Type of the trace, span or session. - `input` string — Input to the trace or span. - `redacted_input` string, nullable — Redacted input of the trace or span. - `output` string, nullable — Output of the trace or span. - `redacted_output` string, nullable — Redacted output of the trace or span. - `name` string — Name of the trace, span or session. - `created_at` string, date-time — Timestamp of the trace or span's creation. - `user_metadata` object — Metadata associated with this trace or span. - `tags` string[] — Tags associated with this trace or span. - `status_code` integer, nullable — Status code of the trace or span. Used for logging failure or error states. - `metrics` Metrics - `duration_ns` integer, nullable — Duration of the trace or span in nanoseconds. Displayed as 'Latency' in Galileo. - `external_id` string, nullable — A user-provided session, trace or span ID. - `dataset_input` string, nullable — Input to the dataset associated with this trace - `dataset_output` string, nullable — Output from the dataset associated with this trace - `dataset_metadata` object — Metadata from the dataset associated with this trace - `id` string, uuid, nullable — Galileo ID of the session, trace or span - `session_id` string, uuid, nullable — Galileo ID of the session containing the trace (or the same value as id for a trace) - `trace_id` string, uuid4, nullable — Galileo ID of the trace containing the span (or the same value as id for a trace) - `project_id` string, uuid, nullable — Galileo ID of the project associated with this trace or span - `run_id` string, uuid, nullable — Galileo ID of the run (log stream or experiment) associated with this trace or span - `updated_at` string, date-time, nullable — Timestamp of the session or trace or span's last update - `has_children` boolean, nullable — Whether or not this trace or span has child spans - `metrics_batch_id` string, uuid4, nullable — Galileo ID of the metrics batch associated with this trace or span - `session_batch_id` string, uuid4, nullable — Galileo ID of the metrics batch associated with this trace or span - `feedback_rating_info` object — Feedback information related to the record - `annotations` object — Annotations keyed by template ID and annotator ID - `file_ids` string[] — IDs of files associated with this record - `file_modalities` ContentModality[] — Modalities of files associated with this record - `annotation_aggregates` object — Annotation aggregate information keyed by template ID - `annotation_agreement` object — Annotation agreement scores keyed by template ID - `overall_annotation_agreement` number, nullable — Average annotation agreement across all templates in the queue - `annotation_queue_ids` string[] — IDs of annotation queues this record is in - `fully_annotated` boolean, nullable — Whether every field is annotated by every annotator in the queue - `progress_message` string — Runner progress text written directly to CH span - `error_message` string — Runner error text written directly to CH span - `metric_info` object, nullable — Detailed information about the metrics associated with this trace or span - `files` object, nullable — File metadata keyed by file ID for files associated with this record - `parent_id` string, uuid, nullable — Galileo ID of the parent of this span - `is_complete` boolean — Whether the parent trace is complete or not - `step_number` integer, nullable — Topological step number of the span. - `tool_call_id` string, nullable — ID of the tool call. - PartialExtendedRetrieverSpanRecord - `type` 'retriever' — Type of the trace, span or session. - `input` string — Input to the trace or span. - `redacted_input` string, nullable — Redacted input of the trace or span. - `output` DocumentOutput[] — Output of the trace or span. - `content` string, required — Content of the document. - `metadata` object - `redacted_output` DocumentOutput[], nullable — Redacted output of the trace or span. - `content` string, required — Content of the document. - `metadata` object - `name` string — Name of the trace, span or session. - `created_at` string, date-time — Timestamp of the trace or span's creation. - `user_metadata` object — Metadata associated with this trace or span. - `tags` string[] — Tags associated with this trace or span. - `status_code` integer, nullable — Status code of the trace or span. Used for logging failure or error states. - `metrics` Metrics - `duration_ns` integer, nullable — Duration of the trace or span in nanoseconds. Displayed as 'Latency' in Galileo. - `external_id` string, nullable — A user-provided session, trace or span ID. - `dataset_input` string, nullable — Input to the dataset associated with this trace - `dataset_output` string, nullable — Output from the dataset associated with this trace - `dataset_metadata` object — Metadata from the dataset associated with this trace - `id` string, uuid, nullable — Galileo ID of the session, trace or span - `session_id` string, uuid, nullable — Galileo ID of the session containing the trace (or the same value as id for a trace) - `trace_id` string, uuid4, nullable — Galileo ID of the trace containing the span (or the same value as id for a trace) - `project_id` string, uuid, nullable — Galileo ID of the project associated with this trace or span - `run_id` string, uuid, nullable — Galileo ID of the run (log stream or experiment) associated with this trace or span - `updated_at` string, date-time, nullable — Timestamp of the session or trace or span's last update - `has_children` boolean, nullable — Whether or not this trace or span has child spans - `metrics_batch_id` string, uuid4, nullable — Galileo ID of the metrics batch associated with this trace or span - `session_batch_id` string, uuid4, nullable — Galileo ID of the metrics batch associated with this trace or span - `feedback_rating_info` object — Feedback information related to the record - `annotations` object — Annotations keyed by template ID and annotator ID - `file_ids` string[] — IDs of files associated with this record - `file_modalities` ContentModality[] — Modalities of files associated with this record - `annotation_aggregates` object — Annotation aggregate information keyed by template ID - `annotation_agreement` object — Annotation agreement scores keyed by template ID - `overall_annotation_agreement` number, nullable — Average annotation agreement across all templates in the queue - `annotation_queue_ids` string[] — IDs of annotation queues this record is in - `fully_annotated` boolean, nullable — Whether every field is annotated by every annotator in the queue - `progress_message` string — Runner progress text written directly to CH span - `error_message` string — Runner error text written directly to CH span - `metric_info` object, nullable — Detailed information about the metrics associated with this trace or span - `files` object, nullable — File metadata keyed by file ID for files associated with this record - `parent_id` string, uuid, nullable — Galileo ID of the parent of this span - `is_complete` boolean — Whether the parent trace is complete or not - `step_number` integer, nullable — Topological step number of the span. - PartialExtendedControlSpanRecord - `type` 'control' — Type of the trace, span or session. - `input` union — Input to the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - union[] - union - … - `redacted_input` union — Redacted input of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - union[] - union - … - `output` ControlResult - `action` 'deny' | 'steer' | 'observe', required - `matched` boolean, required — Whether the control matched. False covers both non-match and error cases; use error_message to distinguish errors. - `confidence` number, nullable — Confidence score reported by the control evaluation result. - `error_message` string, nullable — Error text when control evaluation failed. This should be null for normal matches and non-matches. - `redacted_output` ControlResult - `action` 'deny' | 'steer' | 'observe', required - `matched` boolean, required — Whether the control matched. False covers both non-match and error cases; use error_message to distinguish errors. - `confidence` number, nullable — Confidence score reported by the control evaluation result. - `error_message` string, nullable — Error text when control evaluation failed. This should be null for normal matches and non-matches. - `name` string — Name of the trace, span or session. - `created_at` string, date-time — Timestamp of the trace or span's creation. - `user_metadata` object — Metadata associated with this trace or span. - `tags` string[] — Tags associated with this trace or span. - `status_code` integer, nullable — Status code of the trace or span. Used for logging failure or error states. - `metrics` Metrics - `duration_ns` integer, nullable — Duration of the trace or span in nanoseconds. Displayed as 'Latency' in Galileo. - `external_id` string, nullable — A user-provided session, trace or span ID. - `dataset_input` string, nullable — Input to the dataset associated with this trace - `dataset_output` string, nullable — Output from the dataset associated with this trace - `dataset_metadata` object — Metadata from the dataset associated with this trace - `id` string, uuid, nullable — Galileo ID of the session, trace or span - `session_id` string, uuid, nullable — Galileo ID of the session containing the trace (or the same value as id for a trace) - `trace_id` string, uuid4, nullable — Galileo ID of the trace containing the span (or the same value as id for a trace) - `project_id` string, uuid, nullable — Galileo ID of the project associated with this trace or span - `run_id` string, uuid, nullable — Galileo ID of the run (log stream or experiment) associated with this trace or span - `updated_at` string, date-time, nullable — Timestamp of the session or trace or span's last update - `has_children` boolean, nullable — Whether or not this trace or span has child spans - `metrics_batch_id` string, uuid4, nullable — Galileo ID of the metrics batch associated with this trace or span - `session_batch_id` string, uuid4, nullable — Galileo ID of the metrics batch associated with this trace or span - `feedback_rating_info` object — Feedback information related to the record - `annotations` object — Annotations keyed by template ID and annotator ID - `file_ids` string[] — IDs of files associated with this record - `file_modalities` ContentModality[] — Modalities of files associated with this record - `annotation_aggregates` object — Annotation aggregate information keyed by template ID - `annotation_agreement` object — Annotation agreement scores keyed by template ID - `overall_annotation_agreement` number, nullable — Average annotation agreement across all templates in the queue - `annotation_queue_ids` string[] — IDs of annotation queues this record is in - `fully_annotated` boolean, nullable — Whether every field is annotated by every annotator in the queue - `progress_message` string — Runner progress text written directly to CH span - `error_message` string — Runner error text written directly to CH span - `metric_info` object, nullable — Detailed information about the metrics associated with this trace or span - `files` object, nullable — File metadata keyed by file ID for files associated with this record - `parent_id` string, uuid, nullable — Galileo ID of the parent of this span - `is_complete` boolean — Whether the parent trace is complete or not - `step_number` integer, nullable — Topological step number of the span. - `control_id` integer, nullable — Identifier of the control definition that produced this span. - `agent_name` string, nullable — Normalized agent name associated with this control execution. - `check_stage` 'pre' | 'post' - `applies_to` 'llm_call' | 'tool_call' - `evaluator_name` string, nullable — Representative evaluator name for this control span. For composite controls, this is the primary evaluator chosen for observability identity. - `selector_path` string, nullable — Representative selector path for this control span. For composite controls, this is the primary selector path chosen for observability identity. - PartialExtendedSessionRecord - `type` 'session' — Type of the trace, span or session. - `input` union - string - GalileoCoreSchemasLoggingLlmMessage[] - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - union[] - union - … - `redacted_input` union — Redacted input of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - union[] - union - … - `output` union — Output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - DocumentOutput[] - `content` string, required — Content of the document. - `metadata` object - union[] - union - … - ControlResult - `action` 'deny' | 'steer' | 'observe', required - `matched` boolean, required — Whether the control matched. False covers both non-match and error cases; use error_message to distinguish errors. - `confidence` number, nullable — Confidence score reported by the control evaluation result. - `error_message` string, nullable — Error text when control evaluation failed. This should be null for normal matches and non-matches. - `redacted_output` union — Redacted output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - DocumentOutput[] - `content` string, required — Content of the document. - `metadata` object - union[] - union - … - ControlResult - `action` 'deny' | 'steer' | 'observe', required - `matched` boolean, required — Whether the control matched. False covers both non-match and error cases; use error_message to distinguish errors. - `confidence` number, nullable — Confidence score reported by the control evaluation result. - `error_message` string, nullable — Error text when control evaluation failed. This should be null for normal matches and non-matches. - `name` string — Name of the trace, span or session. - `created_at` string, date-time — Timestamp of the trace or span's creation. - `user_metadata` object — Metadata associated with this trace or span. - `tags` string[] — Tags associated with this trace or span. - `status_code` integer, nullable — Status code of the trace or span. Used for logging failure or error states. - `metrics` Metrics - `duration_ns` integer, nullable — Duration of the trace or span in nanoseconds. Displayed as 'Latency' in Galileo. - `external_id` string, nullable — A user-provided session, trace or span ID. - `dataset_input` string, nullable — Input to the dataset associated with this trace - `dataset_output` string, nullable — Output from the dataset associated with this trace - `dataset_metadata` object — Metadata from the dataset associated with this trace - `id` string, uuid, nullable — Galileo ID of the session - `session_id` string, uuid4, nullable — Galileo ID of the session containing the trace or span or session - `trace_id` string, uuid4, nullable — Galileo ID of the trace containing the span (or the same value as id for a trace) - `project_id` string, uuid, nullable — Galileo ID of the project associated with this trace or span - `run_id` string, uuid, nullable — Galileo ID of the run (log stream or experiment) associated with this trace or span - `updated_at` string, date-time, nullable — Timestamp of the session or trace or span's last update - `has_children` boolean, nullable — Whether or not this trace or span has child spans - `metrics_batch_id` string, uuid4, nullable — Galileo ID of the metrics batch associated with this trace or span - `session_batch_id` string, uuid4, nullable — Galileo ID of the metrics batch associated with this trace or span - `feedback_rating_info` object — Feedback information related to the record - `annotations` object — Annotations keyed by template ID and annotator ID - `file_ids` string[] — IDs of files associated with this record - `file_modalities` ContentModality[] — Modalities of files associated with this record - `annotation_aggregates` object — Annotation aggregate information keyed by template ID - `annotation_agreement` object — Annotation agreement scores keyed by template ID - `overall_annotation_agreement` number, nullable — Average annotation agreement across all templates in the queue - `annotation_queue_ids` string[] — IDs of annotation queues this record is in - `fully_annotated` boolean, nullable — Whether every field is annotated by every annotator in the queue - `progress_message` string — Runner progress text written directly to CH span - `error_message` string — Runner error text written directly to CH span - `metric_info` object, nullable — Detailed information about the metrics associated with this trace or span - `files` object, nullable — File metadata keyed by file ID for files associated with this record - `previous_session_id` string, uuid4, nullable - `num_traces` integer, nullable - `num_records` integer, required — number of records ## Other responses - `422` — Validation Error --- [API](https://skmtc.net/galileo/apis/galileo-api-server.md) · [All operations](https://skmtc.net/galileo/apis/galileo-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/galileo/galileo-api-server/versions/933e8c8e6366/schema)