--- title: "Get Span" method: GET path: "/public/v2/projects/{project_id}/spans/{span_id}" tags: ["trace"] --- # Get Span `GET /public/v2/projects/{project_id}/spans/{span_id}` ## Request - Base URL: `https://api.galileo.ai` - URL: `https://api.galileo.ai/public/v2/projects/{project_id}/spans/{span_id}` - 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 - `span_id` string, uuid4, required - `project_id` string, uuid4, required ## Query parameters - `include_presigned_urls` boolean ## Response `200` Successful Response - union - ExtendedAgentSpanRecordWithChildren - `spans` union[] - union - ExtendedAgentSpanRecordWithChildren (recursive) - ExtendedWorkflowSpanRecordWithChildren - `spans` union[] - union - … - `type` 'workflow': Type of the trace, span or session. - `input` union: Input to the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - … - union[] - … - `redacted_input` union: Redacted input of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - … - union[] - … - `output` union: Output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - … - DocumentOutput[] - … - union[] - … - ControlResult - … - `redacted_output` union: Redacted output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - … - DocumentOutput[] - … - union[] - … - ControlResult - … - `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 - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - `redacted_input` GalileoCoreSchemasLoggingLlmMessage[], nullable: Redacted input of the trace or span. - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - `output` GalileoCoreSchemasLoggingLlmMessage - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - `redacted_output` GalileoCoreSchemasLoggingLlmMessage - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - `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 - … - `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. - ExtendedToolSpanRecordWithChildren - `spans` union[] - union - … - `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. - ExtendedRetrieverSpanRecordWithChildren - `spans` union[] - union - … - `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[] - … - union[] - … - `redacted_input` union: Redacted input of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - … - 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. - ExtendedHttpSpanRecordWithChildren - `spans` union[] - union - … - `type` 'http': Type of the trace, span or session. - `input` union: Input to the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - … - union[] - … - `redacted_input` union: Redacted input of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - … - union[] - … - `output` union: Output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - … - DocumentOutput[] - … - union[] - … - ControlResult - … - `redacted_output` union: Redacted output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - … - DocumentOutput[] - … - union[] - … - ControlResult - … - `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. - `type` 'agent': Type of the trace, span or session. - `input` union: Input to the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - `content` union, required - string - union[] - 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, required - `arguments` string, required - union[] - union - TextContentPart: A text segment within a message. - `type` 'text' - `text` string, required - FileContentPart: Reference to a file associated with this message. The file_id can be resolved via the ``files`` dict returned on trace/span detail responses, which contains metadata such as modality, MIME type, and a presigned download URL. - `type` 'file' - `file_id` string, uuid4, required - `redacted_input` union: Redacted input of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - `content` union, required - string - union[] - 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, required - `arguments` string, required - union[] - union - TextContentPart: A text segment within a message. - `type` 'text' - `text` string, required - FileContentPart: Reference to a file associated with this message. The file_id can be resolved via the ``files`` dict returned on trace/span detail responses, which contains metadata such as modality, MIME type, and a presigned download URL. - `type` 'file' - `file_id` string, uuid4, required - `output` union: Output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - `content` union, required - string - union[] - 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, required - `arguments` string, required - DocumentOutput[] - `content` string, required: Content of the document. - `metadata` object - union[] - union - TextContentPart: A text segment within a message. - `type` 'text' - `text` string, required - FileContentPart: Reference to a file associated with this message. The file_id can be resolved via the ``files`` dict returned on trace/span detail responses, which contains metadata such as modality, MIME type, and a presigned download URL. - `type` 'file' - `file_id` string, uuid4, required - 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 - string - union[] - 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, required - `arguments` string, required - DocumentOutput[] - `content` string, required: Content of the document. - `metadata` object - union[] - union - TextContentPart: A text segment within a message. - `type` 'text' - `text` string, required - FileContentPart: Reference to a file associated with this message. The file_id can be resolved via the ``files`` dict returned on trace/span detail responses, which contains metadata such as modality, MIME type, and a presigned download URL. - `type` 'file' - `file_id` string, uuid4, required - 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. - ExtendedWorkflowSpanRecordWithChildren - `spans` union[] - union - ExtendedAgentSpanRecordWithChildren - `spans` union[] - union - … - `type` 'agent': Type of the trace, span or session. - `input` union: Input to the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - … - union[] - … - `redacted_input` union: Redacted input of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - … - union[] - … - `output` union: Output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - … - DocumentOutput[] - … - union[] - … - ControlResult - … - `redacted_output` union: Redacted output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - … - DocumentOutput[] - … - union[] - … - ControlResult - … - `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. - ExtendedWorkflowSpanRecordWithChildren (recursive) - ExtendedLlmSpanRecord - `type` 'llm': Type of the trace, span or session. - `input` GalileoCoreSchemasLoggingLlmMessage[]: Input to the trace or span. - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - `redacted_input` GalileoCoreSchemasLoggingLlmMessage[], nullable: Redacted input of the trace or span. - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - `output` GalileoCoreSchemasLoggingLlmMessage - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - `redacted_output` GalileoCoreSchemasLoggingLlmMessage - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - `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 - … - `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. - ExtendedToolSpanRecordWithChildren - `spans` union[] - union - … - `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. - ExtendedRetrieverSpanRecordWithChildren - `spans` union[] - union - … - `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[] - … - union[] - … - `redacted_input` union: Redacted input of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - … - 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. - ExtendedHttpSpanRecordWithChildren - `spans` union[] - union - … - `type` 'http': Type of the trace, span or session. - `input` union: Input to the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - … - union[] - … - `redacted_input` union: Redacted input of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - … - union[] - … - `output` union: Output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - … - DocumentOutput[] - … - union[] - … - ControlResult - … - `redacted_output` union: Redacted output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - … - DocumentOutput[] - … - union[] - … - ControlResult - … - `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. - `type` 'workflow': Type of the trace, span or session. - `input` union: Input to the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - `content` union, required - string - union[] - 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, required - `arguments` string, required - union[] - union - TextContentPart: A text segment within a message. - `type` 'text' - `text` string, required - FileContentPart: Reference to a file associated with this message. The file_id can be resolved via the ``files`` dict returned on trace/span detail responses, which contains metadata such as modality, MIME type, and a presigned download URL. - `type` 'file' - `file_id` string, uuid4, required - `redacted_input` union: Redacted input of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - `content` union, required - string - union[] - 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, required - `arguments` string, required - union[] - union - TextContentPart: A text segment within a message. - `type` 'text' - `text` string, required - FileContentPart: Reference to a file associated with this message. The file_id can be resolved via the ``files`` dict returned on trace/span detail responses, which contains metadata such as modality, MIME type, and a presigned download URL. - `type` 'file' - `file_id` string, uuid4, required - `output` union: Output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - `content` union, required - string - union[] - 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, required - `arguments` string, required - DocumentOutput[] - `content` string, required: Content of the document. - `metadata` object - union[] - union - TextContentPart: A text segment within a message. - `type` 'text' - `text` string, required - FileContentPart: Reference to a file associated with this message. The file_id can be resolved via the ``files`` dict returned on trace/span detail responses, which contains metadata such as modality, MIME type, and a presigned download URL. - `type` 'file' - `file_id` string, uuid4, required - 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 - string - union[] - 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, required - `arguments` string, required - DocumentOutput[] - `content` string, required: Content of the document. - `metadata` object - union[] - union - TextContentPart: A text segment within a message. - `type` 'text' - `text` string, required - FileContentPart: Reference to a file associated with this message. The file_id can be resolved via the ``files`` dict returned on trace/span detail responses, which contains metadata such as modality, MIME type, and a presigned download URL. - `type` 'file' - `file_id` string, uuid4, required - 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[] - union - TextContentPart: A text segment within a message. - … - FileContentPart: Reference to a file associated with this message. The file_id can be resolved via the ``files`` dict returned on trace/span detail responses, which contains metadata such as modality, MIME type, and a presigned download URL. - … - `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, required - `arguments` string, required - `redacted_input` GalileoCoreSchemasLoggingLlmMessage[], nullable: Redacted input of the trace or span. - `content` union, required - string - union[] - union - TextContentPart: A text segment within a message. - … - FileContentPart: Reference to a file associated with this message. The file_id can be resolved via the ``files`` dict returned on trace/span detail responses, which contains metadata such as modality, MIME type, and a presigned download URL. - … - `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, required - `arguments` string, required - `output` GalileoCoreSchemasLoggingLlmMessage - `content` union, required - string - union[] - union - TextContentPart: A text segment within a message. - … - FileContentPart: Reference to a file associated with this message. The file_id can be resolved via the ``files`` dict returned on trace/span detail responses, which contains metadata such as modality, MIME type, and a presigned download URL. - … - `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, required - `arguments` string, required - `redacted_output` GalileoCoreSchemasLoggingLlmMessage - `content` union, required - string - union[] - union - TextContentPart: A text segment within a message. - … - FileContentPart: Reference to a file associated with this message. The file_id can be resolved via the ``files`` dict returned on trace/span detail responses, which contains metadata such as modality, MIME type, and a presigned download URL. - … - `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, required - `arguments` string, 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. - `type` 'message' - `id` string, nullable: Unique identifier for the event - `status` 'in_progress' | 'completed' | 'failed' | 'cancelled' | 'incomplete': Common status values for events. - `metadata` object, nullable: Provider-specific metadata and additional fields - `error_message` string, nullable: Error message if the event failed - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `content` string, nullable: Text content of the message - `content_parts` object[], nullable: Structured content items (text, audio, images, etc.) - ReasoningEvent: Internal reasoning/thinking from the model (e.g., OpenAI o1/o3 reasoning tokens). - `type` 'reasoning' - `id` string, nullable: Unique identifier for the event - `status` 'in_progress' | 'completed' | 'failed' | 'cancelled' | 'incomplete': Common status values for events. - `metadata` object, nullable: Provider-specific metadata and additional fields - `error_message` string, nullable: Error message if the event failed - `content` string, nullable: The reasoning/thinking content - `summary` union: Summary of the reasoning - string - object[] - … - 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). - `type` 'internal_tool_call' - `id` string, nullable: Unique identifier for the event - `status` 'in_progress' | 'completed' | 'failed' | 'cancelled' | 'incomplete': Common status values for events. - `metadata` object, nullable: Provider-specific metadata and additional fields - `error_message` string, nullable: Error message if the event failed - `name` string, required: Name of the internal tool (e.g., 'web_search', 'code_interpreter', 'file_search') - `input` object, nullable: Input/arguments to the tool call - `output` object, nullable: Output/results from the tool call - WebSearchCallEvent: An OpenAI-style web search call event. - `type` 'web_search_call' - `id` string, nullable: Unique identifier for the event - `status` 'in_progress' | 'completed' | 'failed' | 'cancelled' | 'incomplete': Common status values for events. - `metadata` object, nullable: Provider-specific metadata and additional fields - `error_message` string, nullable: Error message if the event failed - `action` WebSearchAction, required: Action payload for a web search call event. - `type` 'search', required: Type of web search action - `query` string, nullable: Search query string - `sources` unknown - ImageGenerationEvent: An image generation event from the model. - `type` 'image_generation' - `id` string, nullable: Unique identifier for the event - `status` 'in_progress' | 'completed' | 'failed' | 'cancelled' | 'incomplete': Common status values for events. - `metadata` object, nullable: Provider-specific metadata and additional fields - `error_message` string, nullable: Error message if the event failed - `prompt` string, nullable: The prompt used for image generation - `images` object[], nullable: Generated images with URLs or base64 data - `model` string, nullable: Image generation model used - 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. - `type` 'mcp_call' - `id` string, nullable: Unique identifier for the event - `status` 'in_progress' | 'completed' | 'failed' | 'cancelled' | 'incomplete': Common status values for events. - `metadata` object, nullable: Provider-specific metadata and additional fields - `error_message` string, nullable: Error message if the event failed - `tool_name` string, nullable: Name of the MCP tool being called - `server_name` string, nullable: Name of the MCP server - `arguments` object, nullable: Arguments for the MCP tool call - `result` object, nullable: Result from the MCP tool call - MCPListToolsEvent: MCP list tools event - when the model queries available MCP tools. - `type` 'mcp_list_tools' - `id` string, nullable: Unique identifier for the event - `status` 'in_progress' | 'completed' | 'failed' | 'cancelled' | 'incomplete': Common status values for events. - `metadata` object, nullable: Provider-specific metadata and additional fields - `error_message` string, nullable: Error message if the event failed - `server_name` string, nullable: Name of the MCP server - `tools` object[], nullable: List of available MCP tools - MCPApprovalRequestEvent: MCP approval request - when human approval is needed for an MCP tool call. - `type` 'mcp_approval_request' - `id` string, nullable: Unique identifier for the event - `status` 'in_progress' | 'completed' | 'failed' | 'cancelled' | 'incomplete': Common status values for events. - `metadata` object, nullable: Provider-specific metadata and additional fields - `error_message` string, nullable: Error message if the event failed - `tool_name` string, nullable: Name of the MCP tool requiring approval - `tool_invocation` object, nullable: Details of the tool invocation requiring approval - `approved` boolean, nullable: Whether the request was approved - `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. - ExtendedToolSpanRecordWithChildren - `spans` union[] - union - ExtendedAgentSpanRecordWithChildren - `spans` union[] - union - … - `type` 'agent': Type of the trace, span or session. - `input` union: Input to the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - … - union[] - … - `redacted_input` union: Redacted input of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - … - union[] - … - `output` union: Output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - … - DocumentOutput[] - … - union[] - … - ControlResult - … - `redacted_output` union: Redacted output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - … - DocumentOutput[] - … - union[] - … - ControlResult - … - `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. - ExtendedWorkflowSpanRecordWithChildren - `spans` union[] - union - … - `type` 'workflow': Type of the trace, span or session. - `input` union: Input to the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - … - union[] - … - `redacted_input` union: Redacted input of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - … - union[] - … - `output` union: Output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - … - DocumentOutput[] - … - union[] - … - ControlResult - … - `redacted_output` union: Redacted output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - … - DocumentOutput[] - … - union[] - … - ControlResult - … - `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 - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - `redacted_input` GalileoCoreSchemasLoggingLlmMessage[], nullable: Redacted input of the trace or span. - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - `output` GalileoCoreSchemasLoggingLlmMessage - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - `redacted_output` GalileoCoreSchemasLoggingLlmMessage - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - `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 - … - `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. - ExtendedToolSpanRecordWithChildren (recursive) - ExtendedRetrieverSpanRecordWithChildren - `spans` union[] - union - … - `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[] - … - union[] - … - `redacted_input` union: Redacted input of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - … - 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. - ExtendedHttpSpanRecordWithChildren - `spans` union[] - union - … - `type` 'http': Type of the trace, span or session. - `input` union: Input to the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - … - union[] - … - `redacted_input` union: Redacted input of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - … - union[] - … - `output` union: Output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - … - DocumentOutput[] - … - union[] - … - ControlResult - … - `redacted_output` union: Redacted output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - … - DocumentOutput[] - … - union[] - … - ControlResult - … - `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. - `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. - ExtendedRetrieverSpanRecordWithChildren - `spans` union[] - union - ExtendedAgentSpanRecordWithChildren - `spans` union[] - union - … - `type` 'agent': Type of the trace, span or session. - `input` union: Input to the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - … - union[] - … - `redacted_input` union: Redacted input of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - … - union[] - … - `output` union: Output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - … - DocumentOutput[] - … - union[] - … - ControlResult - … - `redacted_output` union: Redacted output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - … - DocumentOutput[] - … - union[] - … - ControlResult - … - `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. - ExtendedWorkflowSpanRecordWithChildren - `spans` union[] - union - … - `type` 'workflow': Type of the trace, span or session. - `input` union: Input to the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - … - union[] - … - `redacted_input` union: Redacted input of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - … - union[] - … - `output` union: Output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - … - DocumentOutput[] - … - union[] - … - ControlResult - … - `redacted_output` union: Redacted output of the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage - … - DocumentOutput[] - … - union[] - … - ControlResult - … - `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 - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - `tool_call_id` string, nullable - `tool_calls` ToolCall[], nullable - … - `redacted_input` GalileoCoreSchemasLoggingLlmMessage[], nullable: Redacted input of the trace or span. - `content` union, required - … - `role` 'agent' | 'assistant' | 'developer' | 'function' | 'system' | 'tool' | 'user', required - … truncated; see the full OpenAPI document linked below ## Other responses - `422`: Validation Error ## Changes > 35 revisions in range; 2 not diffed. - **2026-10-20** `2faf55b03616`: 190 warning, 190 info - added the new `DONE` enum value to the `oneOf[subschema #1: ExtendedAgentSpanRecordWithChildren]/annotation_status/anyOf[subschema #1: AnnotationStatus]/` response property for the response status `200` - added the new `DONE` enum value to the `oneOf[subschema #1: ExtendedAgentSpanRecordWithChildren]/spans/items/oneOf[subschema #2: ExtendedWorkflowSpanRecordWithChildren]/annotation_status/anyOf[subschema #1: AnnotationStatus]/` response property for the response status `200` - added the new `DONE` enum value to the `oneOf[subschema #1: ExtendedAgentSpanRecordWithChildren]/spans/items/oneOf[subschema #2: ExtendedWorkflowSpanRecordWithChildren]/spans/items/oneOf[subschema #3: ExtendedLlmSpanRecord]/annotation_status/anyOf[subschema #1: AnnotationStatus]/` response property for the response status `200` - added the new `DONE` enum value to the `oneOf[subschema #1: ExtendedAgentSpanRecordWithChildren]/spans/items/oneOf[subschema #2: ExtendedWorkflowSpanRecordWithChildren]/spans/items/oneOf[subschema #4: ExtendedToolSpanRecordWithChildren]/annotation_status/anyOf[subschema #1: AnnotationStatus]/` response property for the response status `200` - …376 more - …earlier changes not shown [Operation history](https://skmtc.dev/galileo/apis/galileo-api-server/changes/public/v2/projects/:project_id/spans/:span_id/get.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/4cf49e96b632?raw)