--- title: "Get Span" method: GET path: "/projects/{project_id}/spans/{span_id}" tags: ["trace"] --- # Get Span `GET /projects/{project_id}/spans/{span_id}` ## 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 - `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 - `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. - `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 - `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 - `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 - `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' - `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. - `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 - `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 - `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 - `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. - `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 - `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 - `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 - `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' - `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. - `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 - `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 - `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. - `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 - `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 - `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 - `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. - `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 - `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 - `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' - `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. - `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 - `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 - `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 - `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 - `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. - `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 - `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 — recursive - 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 - `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' - `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. - `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 - `progress_message` string — Runner progress text written directly to CH span - `error_message` string — Runner error text written directly to CH span - `metric_info` object, nullable — Detailed information about the metrics associated with this trace or span - `files` object, nullable — File metadata keyed by file ID for files associated with this record - `parent_id` string, uuid4, required — Galileo ID of the parent of this span - `is_complete` boolean — Whether the parent trace is complete or not - `step_number` integer, nullable — Topological step number of the span. - ExtendedControlSpanRecord - `type` 'control' — Type of the trace, span or session. - `input` union — Input to the trace or span. - string - GalileoCoreSchemasLoggingLlmMessage[] - `content` union, required - 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 - … truncated; see the full OpenAPI document linked below ## Other responses - `422` — Validation Error --- [API](https://skmtc.net/galileo/apis/galileo-api-server.md) · [All operations](https://skmtc.net/galileo/apis/galileo-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/galileo/galileo-api-server/versions/933e8c8e6366/schema)