--- title: "Query Spans" method: POST path: "/public/v2/projects/{project_id}/spans/search" tags: ["trace"] --- # Query Spans `POST /public/v2/projects/{project_id}/spans/search` ## Request - Base URL: `https://api.galileo.ai` - URL: `https://api.galileo.ai/public/v2/projects/{project_id}/spans/search` - Auth: one of: - API key in header `Splunk-AO-API-Key` - API key in header `Galileo-API-Key` - OAuth 2 - Password - Token URL: `https://api.galileo.ai/login` - HTTP basic ## Path parameters - `project_id` string, uuid4, required ## Request body - LogRecordsQueryRequest - `starting_token` integer - `limit` integer: Records per page, at most 1000. Page through larger result sets with starting_token or previous_last_row_id. - `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. ## Response `200` Successful Response - LogRecordsQueryResponse - `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 - ExtendedTraceRecord - `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, uuid4, required: Galileo ID of the trace - `session_id` string, uuid4, required: Galileo ID of the session containing the trace (or the same value as id for a trace) - `trace_id` string, uuid4, required: Galileo ID of the trace containing the span (or the same value as id for a trace) - `project_id` string, uuid4, required: Galileo ID of the project associated with this trace or span - `run_id` string, uuid4, required: 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 - `annotation_status` 'NOT_STARTED' | 'IN_PROGRESS' | 'DONE' - `annotated_members` string[], nullable: Emails of tracked queue members who rated the record - `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 - `dataset_generated_output` string, nullable: Generated output from the dataset associated with this trace - `is_complete` boolean: Whether the trace is complete or not - `num_spans` integer, nullable - ExtendedAgentSpanRecord - `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, uuid4, required: Galileo ID of the session, trace or span - `session_id` string, uuid4, required: 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, uuid4, required: Galileo ID of the project associated with this trace or span - `run_id` string, uuid4, required: 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 - `annotation_status` 'NOT_STARTED' | 'IN_PROGRESS' | 'DONE' - `annotated_members` string[], nullable: Emails of tracked queue members who rated the record - `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, uuid4, required: 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. - ExtendedWorkflowSpanRecord - `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, uuid4, required: Galileo ID of the session, trace or span - `session_id` string, uuid4, required: 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, uuid4, required: Galileo ID of the project associated with this trace or span - `run_id` string, uuid4, required: 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 - `annotation_status` 'NOT_STARTED' | 'IN_PROGRESS' | 'DONE' - `annotated_members` string[], nullable: Emails of tracked queue members who rated the record - `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, uuid4, required: 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. - ExtendedLlmSpanRecord - `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, uuid4, required: Galileo ID of the session, trace or span - `session_id` string, uuid4, required: 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, uuid4, required: Galileo ID of the project associated with this trace or span - `run_id` string, uuid4, required: 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 - `annotation_status` 'NOT_STARTED' | 'IN_PROGRESS' | 'DONE' - `annotated_members` string[], nullable: Emails of tracked queue members who rated the record - `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, uuid4, required: 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. - `provider` string, nullable: Provider used for this span. - `temperature` number, nullable: Temperature used for generation. - `finish_reason` string, nullable: Reason for finishing. - ExtendedToolSpanRecord - `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, uuid4, required: Galileo ID of the session, trace or span - `session_id` string, uuid4, required: 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, uuid4, required: Galileo ID of the project associated with this trace or span - `run_id` string, uuid4, required: 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 - `annotation_status` 'NOT_STARTED' | 'IN_PROGRESS' | 'DONE' - `annotated_members` string[], nullable: Emails of tracked queue members who rated the record - `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, uuid4, required: 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. - ExtendedRetrieverSpanRecord - `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, uuid4, required: Galileo ID of the session, trace or span - `session_id` string, uuid4, required: 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, uuid4, required: Galileo ID of the project associated with this trace or span - `run_id` string, uuid4, required: 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 - `annotation_status` 'NOT_STARTED' | 'IN_PROGRESS' | 'DONE' - `annotated_members` string[], nullable: Emails of tracked queue members who rated the record - `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, uuid4, required: 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. - ExtendedControlSpanRecord - `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, uuid4, required: Galileo ID of the session, trace or span - `session_id` string, uuid4, required: 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, uuid4, required: Galileo ID of the project associated with this trace or span - `run_id` string, uuid4, required: 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 - `annotation_status` 'NOT_STARTED' | 'IN_PROGRESS' | 'DONE' - `annotated_members` string[], nullable: Emails of tracked queue members who rated the record - `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, uuid4, required: 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' | 'retriever_call' | 'trace_call' | 'session_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. - ExtendedHttpSpanRecord - `type` 'http': 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, uuid4, required: Galileo ID of the session, trace or span - `session_id` string, uuid4, required: 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, uuid4, required: Galileo ID of the project associated with this trace or span - `run_id` string, uuid4, required: 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 - `annotation_status` 'NOT_STARTED' | 'IN_PROGRESS' | 'DONE' - `annotated_members` string[], nullable: Emails of tracked queue members who rated the record - `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, uuid4, required: 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. - ExtendedSessionRecord - `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, uuid4, required: 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, uuid4, required: Galileo ID of the project associated with this trace or span - `run_id` string, uuid4, required: 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 - `annotation_status` 'NOT_STARTED' | 'IN_PROGRESS' | 'DONE' - `annotated_members` string[], nullable: Emails of tracked queue members who rated the record - `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 ## Changes > 34 revisions in range; 2 not diffed. - **2026-10-26** `a289cea1b504`: 2 warning - the `limit` request property's max was set to `1000.00` - the `limit` request property's min was set to `0.00` - **2026-10-20** `2faf55b03616`: 18 warning, 18 info - added the new `DONE` enum value to the `records/items/oneOf[subschema #1: ExtendedTraceRecord]/annotation_status/anyOf[subschema #1: AnnotationStatus]/` response property for the response status `200` - added the new `DONE` enum value to the `records/items/oneOf[subschema #2: ExtendedAgentSpanRecord]/annotation_status/anyOf[subschema #1: AnnotationStatus]/` response property for the response status `200` - added the new `DONE` enum value to the `records/items/oneOf[subschema #3: ExtendedWorkflowSpanRecord]/annotation_status/anyOf[subschema #1: AnnotationStatus]/` response property for the response status `200` - added the new `DONE` enum value to the `records/items/oneOf[subschema #4: ExtendedLlmSpanRecord]/annotation_status/anyOf[subschema #1: AnnotationStatus]/` response property for the response status `200` - …32 more - …earlier changes not shown [Operation history](https://skmtc.dev/galileo/apis/galileo-api-server/changes/public/v2/projects/:project_id/spans/search/post.md) --- [API](https://skmtc.dev/galileo/apis/galileo-api-server.md) - [All operations](https://skmtc.dev/galileo/apis/galileo-api-server/llms.txt) - [OpenAPI document](https://skmtc.dev/galileo/apis/galileo-api-server/revisions/a289cea1b504?raw)