--- title: "Get Trace" method: GET path: "/v2/projects/{project_id}/traces/{trace_id}" tags: ["trace"] --- # Get Trace `GET /v2/projects/{project_id}/traces/{trace_id}` ## Path parameters - `trace_id` string, uuid4, required - `project_id` string, uuid4, required ## Query parameters - `include_presigned_urls` boolean ## Response `200` Successful Response - union - ExtendedTraceRecordWithChildren - `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 - `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` 'trace' — Type of the trace, span or session. - `input` union — Input to the trace or span. - string - 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 - 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 - 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_output` union — Redacted output of the trace or span. - string - 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 - `name` string — Name of the trace, span or session. - `created_at` string, date-time — Timestamp of the trace or span's creation. - `user_metadata` object — Metadata associated with this trace or span. - `tags` string[] — Tags associated with this trace or span. - `status_code` integer, nullable — Status code of the trace or span. Used for logging failure or error states. - `metrics` Metrics - `duration_ns` integer, nullable — Duration of the trace or span in nanoseconds. Displayed as 'Latency' in Galileo. - `external_id` string, nullable — A user-provided session, trace or span ID. - `dataset_input` string, nullable — Input to the dataset associated with this trace - `dataset_output` string, nullable — Output from the dataset associated with this trace - `dataset_metadata` object — Metadata from the dataset associated with this trace - `id` string, uuid4, required — Galileo ID of the trace - `session_id` string, uuid4, required — Galileo ID of the session containing the trace (or the same value as id for a trace) - `trace_id` string, uuid4, required — Galileo ID of the trace containing the span (or the same value as id for a trace) - `project_id` string, uuid4, required — Galileo ID of the project associated with this trace or span - `run_id` string, uuid4, required — Galileo ID of the run (log stream or experiment) associated with this trace or span - `updated_at` string, date-time, nullable — Timestamp of the session or trace or span's last update - `has_children` boolean, nullable — Whether or not this trace or span has child spans - `metrics_batch_id` string, uuid4, nullable — Galileo ID of the metrics batch associated with this trace or span - `session_batch_id` string, uuid4, nullable — Galileo ID of the metrics batch associated with this trace or span - `feedback_rating_info` object — Feedback information related to the record - `annotations` object — Annotations keyed by template ID and annotator ID - `file_ids` string[] — IDs of files associated with this record - `file_modalities` ContentModality[] — Modalities of files associated with this record - `annotation_aggregates` object — Annotation aggregate information keyed by template ID - `annotation_agreement` object — Annotation agreement scores keyed by template ID - `overall_annotation_agreement` number, nullable — Average annotation agreement across all templates in the queue - `annotation_queue_ids` string[] — IDs of annotation queues this record is in - `fully_annotated` boolean, nullable — Whether every field is annotated by every annotator in the queue - `progress_message` string — Runner progress text written directly to CH span - `error_message` string — Runner error text written directly to CH span - `metric_info` object, nullable — Detailed information about the metrics associated with this trace or span - `files` object, nullable — File metadata keyed by file ID for files associated with this record - `is_complete` boolean — Whether the trace is complete or not - `num_spans` integer, nullable - StubTraceRecord — Placeholder for a trace referenced by spans but not yet ingested. Synthesized when one or more spans declare trace_id=X but no TraceRecord with that id exists in storage. Holds the orphan spans together so the client can render them under a single root. Extends ExtendedRecordWithChildSpans so isinstance checks work uniformly for both real and stub traces. - `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 - `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` 'stub_trace' — Discriminator; identifies this as a synthesized placeholder, not a real trace. - `id` string, uuid4, required — ID of the missing trace, taken from span trace_id references. - `project_id` string, uuid4, nullable — Project ID inferred from child spans, if all agree; otherwise None. - `run_id` string, uuid4, nullable — Run ID inferred from child spans, if all agree; otherwise None. - `session_id` string, uuid4, nullable — Session ID inferred from child spans, if all agree; otherwise None. - `created_at` string, date-time, required — Earliest created_at among child spans; used to order under a session. ## 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)