openapi: 3.1.0 info: title: Galileo API Server annotation trace API version: 1.1085.0 servers: - url: https://api.galileo.ai description: Galileo API Server - galileo-v2 tags: - name: trace paths: /projects/{project_id}/traces/aggregated: post: tags: - trace summary: Get Aggregated Trace View operationId: get_aggregated_trace_view_projects__project_id__traces_aggregated_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AggregatedTraceViewRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/AggregatedTraceViewResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/recompute-metrics: post: tags: - trace summary: Recompute Metrics operationId: recompute_metrics_projects__project_id__recompute_metrics_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/RecomputeLogRecordsMetricsRequest' responses: '200': description: Successful Response content: application/json: schema: {} '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/traces: post: tags: - trace summary: Log Traces operationId: log_traces_projects__project_id__traces_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogTracesIngestRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogTracesIngestResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/traces/{trace_id}: patch: tags: - trace summary: Update Trace description: Update a trace with the given ID. operationId: update_trace_projects__project_id__traces__trace_id__patch security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: trace_id in: path required: true schema: type: string format: uuid4 title: Trace Id - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogTraceUpdateRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogTraceUpdateResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' get: tags: - trace summary: Get Trace operationId: get_trace_projects__project_id__traces__trace_id__get security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: trace_id in: path required: true schema: type: string format: uuid4 title: Trace Id - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id - name: include_presigned_urls in: query required: false schema: type: boolean default: false title: Include Presigned Urls responses: '200': description: Successful Response content: application/json: schema: oneOf: - $ref: '#/components/schemas/ExtendedTraceRecordWithChildren' - $ref: '#/components/schemas/StubTraceRecord' discriminator: propertyName: type mapping: trace: '#/components/schemas/ExtendedTraceRecordWithChildren' stub_trace: '#/components/schemas/StubTraceRecord' title: Response Get Trace Projects Project Id Traces Trace Id Get '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/spans/{span_id}: patch: tags: - trace summary: Update Span description: Update a span with the given ID. operationId: update_span_projects__project_id__spans__span_id__patch security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: span_id in: path required: true schema: type: string format: uuid4 title: Span Id - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogSpanUpdateRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogSpanUpdateResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' get: tags: - trace summary: Get Span operationId: get_span_projects__project_id__spans__span_id__get security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: span_id in: path required: true schema: type: string format: uuid4 title: Span Id - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id - name: include_presigned_urls in: query required: false schema: type: boolean default: false title: Include Presigned Urls responses: '200': description: Successful Response content: application/json: schema: oneOf: - $ref: '#/components/schemas/ExtendedAgentSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedWorkflowSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedLlmSpanRecord' - $ref: '#/components/schemas/ExtendedToolSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedRetrieverSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedControlSpanRecord' discriminator: propertyName: type mapping: agent: '#/components/schemas/ExtendedAgentSpanRecordWithChildren' workflow: '#/components/schemas/ExtendedWorkflowSpanRecordWithChildren' llm: '#/components/schemas/ExtendedLlmSpanRecord' tool: '#/components/schemas/ExtendedToolSpanRecordWithChildren' retriever: '#/components/schemas/ExtendedRetrieverSpanRecordWithChildren' control: '#/components/schemas/ExtendedControlSpanRecord' title: Response Get Span Projects Project Id Spans Span Id Get '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/traces/available_columns: post: tags: - trace summary: Traces Available Columns operationId: traces_available_columns_projects__project_id__traces_available_columns_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsAvailableColumnsRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsAvailableColumnsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/metrics-testing/available_columns: post: tags: - trace summary: Metrics Testing Available Columns operationId: metrics_testing_available_columns_projects__project_id__metrics_testing_available_columns_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/MetricsTestingAvailableColumnsRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsAvailableColumnsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/spans/available_columns: post: tags: - trace summary: Spans Available Columns operationId: spans_available_columns_projects__project_id__spans_available_columns_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsAvailableColumnsRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsAvailableColumnsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/sessions/available_columns: post: tags: - trace summary: Sessions Available Columns operationId: sessions_available_columns_projects__project_id__sessions_available_columns_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsAvailableColumnsRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsAvailableColumnsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/traces/search: post: tags: - trace summary: Query Traces operationId: query_traces_projects__project_id__traces_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/traces/partial_search: post: tags: - trace summary: Query Partial Traces operationId: query_partial_traces_projects__project_id__traces_partial_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsPartialQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsPartialQueryResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/traces/count: post: tags: - trace summary: Count Traces description: This endpoint may return a slightly inaccurate count due to the way records are filtered before deduplication. operationId: count_traces_projects__project_id__traces_count_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryCountRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryCountResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/spans: post: tags: - trace summary: Log Spans operationId: log_spans_projects__project_id__spans_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogSpansIngestRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogSpansIngestResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/spans/search: post: tags: - trace summary: Query Spans operationId: query_spans_projects__project_id__spans_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/spans/partial_search: post: tags: - trace summary: Query Partial Spans operationId: query_partial_spans_projects__project_id__spans_partial_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsPartialQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsPartialQueryResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/spans/count: post: tags: - trace summary: Count Spans operationId: count_spans_projects__project_id__spans_count_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryCountRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryCountResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/metrics/search: post: tags: - trace summary: Query Metrics operationId: query_metrics_projects__project_id__metrics_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsMetricsQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsMetricsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/metrics/search/v2: post: tags: - trace summary: Query Metrics V2 description: 'Same as /metrics/search but returns metrics with node-type counts: trace (requests_count), session_count, and span_count in aggregate_metrics and in each bucket, similar to /metrics/custom_search.' operationId: query_metrics_v2_projects__project_id__metrics_search_v2_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsMetricsQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsMetricsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/metrics/custom_search: post: tags: - trace summary: Query Custom Metrics operationId: query_custom_metrics_projects__project_id__metrics_custom_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsCustomMetricsQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsMetricsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/sessions: post: tags: - trace summary: Create Session operationId: create_session_projects__project_id__sessions_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SessionCreateRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/SessionCreateResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/sessions/search: post: tags: - trace summary: Query Sessions operationId: query_sessions_projects__project_id__sessions_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/sessions/partial_search: post: tags: - trace summary: Query Partial Sessions operationId: query_partial_sessions_projects__project_id__sessions_partial_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsPartialQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsPartialQueryResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/sessions/count: post: tags: - trace summary: Count Sessions operationId: count_sessions_projects__project_id__sessions_count_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryCountRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryCountResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/sessions/{session_id}: get: tags: - trace summary: Get Session operationId: get_session_projects__project_id__sessions__session_id__get security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: session_id in: path required: true schema: type: string format: uuid4 title: Session Id - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id - name: include_presigned_urls in: query required: false schema: type: boolean default: false title: Include Presigned Urls responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ExtendedSessionRecordWithChildren' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/export_records: post: tags: - trace summary: Export Records operationId: export_records_projects__project_id__export_records_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsExportRequest' responses: '200': description: Successful Response content: application/json: schema: {} '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/export_records/url: post: tags: - trace summary: Export Records Url operationId: export_records_url_projects__project_id__export_records_url_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsExportRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ExportPresignedUrlResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/traces/delete: post: tags: - trace summary: Delete Traces description: Delete all trace records that match the provided filters. operationId: delete_traces_projects__project_id__traces_delete_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsDeleteRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsDeleteResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/spans/delete: post: tags: - trace summary: Delete Spans description: Delete all span records that match the provided filters. operationId: delete_spans_projects__project_id__spans_delete_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsDeleteRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsDeleteResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /projects/{project_id}/sessions/delete: post: tags: - trace summary: Delete Sessions description: Delete all session records that match the provided filters. operationId: delete_sessions_projects__project_id__sessions_delete_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsDeleteRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsDeleteResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /otel/traces: post: tags: - trace summary: Traces Open Telemetry operationId: traces_open_telemetry_otel_traces_post deprecated: true security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: content-type in: header required: false schema: type: string title: Content-Type - name: content-encoding in: header required: false schema: anyOf: - type: string - type: 'null' title: Content-Encoding - name: project in: header required: false schema: anyOf: - type: string - type: 'null' title: Project - name: projectid in: header required: false schema: anyOf: - type: string format: uuid4 - type: 'null' title: Projectid - name: logstreamid in: header required: false schema: anyOf: - type: string format: uuid4 - type: 'null' title: Logstreamid - name: logstream in: header required: false schema: anyOf: - type: string - type: 'null' title: Logstream - name: experimentid in: header required: false schema: anyOf: - type: string format: uuid4 - type: 'null' title: Experimentid - name: experiment in: header required: false schema: anyOf: - type: string - type: 'null' title: Experiment - name: sessionid in: header required: false schema: type: string default: 00000000-0000-0000-0000-000000000000 title: Sessionid responses: '200': description: Successful Response content: application/json: schema: {} '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /otel/v1/traces: post: tags: - trace summary: Traces Open Telemetry operationId: traces_open_telemetry_otel_v1_traces_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: content-type in: header required: false schema: type: string title: Content-Type - name: content-encoding in: header required: false schema: anyOf: - type: string - type: 'null' title: Content-Encoding - name: project in: header required: false schema: anyOf: - type: string - type: 'null' title: Project - name: projectid in: header required: false schema: anyOf: - type: string format: uuid4 - type: 'null' title: Projectid - name: logstreamid in: header required: false schema: anyOf: - type: string format: uuid4 - type: 'null' title: Logstreamid - name: logstream in: header required: false schema: anyOf: - type: string - type: 'null' title: Logstream - name: experimentid in: header required: false schema: anyOf: - type: string format: uuid4 - type: 'null' title: Experimentid - name: experiment in: header required: false schema: anyOf: - type: string - type: 'null' title: Experiment - name: sessionid in: header required: false schema: type: string default: 00000000-0000-0000-0000-000000000000 title: Sessionid responses: '200': description: Successful Response content: application/json: schema: {} '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/traces/aggregated: post: tags: - trace summary: Get Aggregated Trace View operationId: get_aggregated_trace_view_v2_projects__project_id__traces_aggregated_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AggregatedTraceViewRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/AggregatedTraceViewResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/recompute-metrics: post: tags: - trace summary: Recompute Metrics operationId: recompute_metrics_v2_projects__project_id__recompute_metrics_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/RecomputeLogRecordsMetricsRequest' responses: '200': description: Successful Response content: application/json: schema: {} '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/traces: post: tags: - trace summary: Log Traces operationId: log_traces_v2_projects__project_id__traces_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogTracesIngestRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogTracesIngestResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/traces/{trace_id}: patch: tags: - trace summary: Update Trace description: Update a trace with the given ID. operationId: update_trace_v2_projects__project_id__traces__trace_id__patch security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: trace_id in: path required: true schema: type: string format: uuid4 title: Trace Id - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogTraceUpdateRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogTraceUpdateResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' get: tags: - trace summary: Get Trace operationId: get_trace_v2_projects__project_id__traces__trace_id__get security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: trace_id in: path required: true schema: type: string format: uuid4 title: Trace Id - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id - name: include_presigned_urls in: query required: false schema: type: boolean default: false title: Include Presigned Urls responses: '200': description: Successful Response content: application/json: schema: oneOf: - $ref: '#/components/schemas/ExtendedTraceRecordWithChildren' - $ref: '#/components/schemas/StubTraceRecord' discriminator: propertyName: type mapping: trace: '#/components/schemas/ExtendedTraceRecordWithChildren' stub_trace: '#/components/schemas/StubTraceRecord' title: Response Get Trace V2 Projects Project Id Traces Trace Id Get '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/spans/{span_id}: patch: tags: - trace summary: Update Span description: Update a span with the given ID. operationId: update_span_v2_projects__project_id__spans__span_id__patch security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: span_id in: path required: true schema: type: string format: uuid4 title: Span Id - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogSpanUpdateRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogSpanUpdateResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' get: tags: - trace summary: Get Span operationId: get_span_v2_projects__project_id__spans__span_id__get security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: span_id in: path required: true schema: type: string format: uuid4 title: Span Id - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id - name: include_presigned_urls in: query required: false schema: type: boolean default: false title: Include Presigned Urls responses: '200': description: Successful Response content: application/json: schema: oneOf: - $ref: '#/components/schemas/ExtendedAgentSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedWorkflowSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedLlmSpanRecord' - $ref: '#/components/schemas/ExtendedToolSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedRetrieverSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedControlSpanRecord' discriminator: propertyName: type mapping: agent: '#/components/schemas/ExtendedAgentSpanRecordWithChildren' workflow: '#/components/schemas/ExtendedWorkflowSpanRecordWithChildren' llm: '#/components/schemas/ExtendedLlmSpanRecord' tool: '#/components/schemas/ExtendedToolSpanRecordWithChildren' retriever: '#/components/schemas/ExtendedRetrieverSpanRecordWithChildren' control: '#/components/schemas/ExtendedControlSpanRecord' title: Response Get Span V2 Projects Project Id Spans Span Id Get '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/traces/available_columns: post: tags: - trace summary: Traces Available Columns operationId: traces_available_columns_v2_projects__project_id__traces_available_columns_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsAvailableColumnsRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsAvailableColumnsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/metrics-testing/available_columns: post: tags: - trace summary: Metrics Testing Available Columns operationId: metrics_testing_available_columns_v2_projects__project_id__metrics_testing_available_columns_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/MetricsTestingAvailableColumnsRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsAvailableColumnsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/spans/available_columns: post: tags: - trace summary: Spans Available Columns operationId: spans_available_columns_v2_projects__project_id__spans_available_columns_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsAvailableColumnsRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsAvailableColumnsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/sessions/available_columns: post: tags: - trace summary: Sessions Available Columns operationId: sessions_available_columns_v2_projects__project_id__sessions_available_columns_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsAvailableColumnsRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsAvailableColumnsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/traces/search: post: tags: - trace summary: Query Traces operationId: query_traces_v2_projects__project_id__traces_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/traces/partial_search: post: tags: - trace summary: Query Partial Traces operationId: query_partial_traces_v2_projects__project_id__traces_partial_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsPartialQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsPartialQueryResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/traces/count: post: tags: - trace summary: Count Traces description: This endpoint may return a slightly inaccurate count due to the way records are filtered before deduplication. operationId: count_traces_v2_projects__project_id__traces_count_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryCountRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryCountResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/spans: post: tags: - trace summary: Log Spans operationId: log_spans_v2_projects__project_id__spans_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogSpansIngestRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogSpansIngestResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/spans/search: post: tags: - trace summary: Query Spans operationId: query_spans_v2_projects__project_id__spans_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/spans/partial_search: post: tags: - trace summary: Query Partial Spans operationId: query_partial_spans_v2_projects__project_id__spans_partial_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsPartialQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsPartialQueryResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/spans/count: post: tags: - trace summary: Count Spans operationId: count_spans_v2_projects__project_id__spans_count_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryCountRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryCountResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/metrics/search: post: tags: - trace summary: Query Metrics operationId: query_metrics_v2_projects__project_id__metrics_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsMetricsQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsMetricsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/metrics/search/v2: post: tags: - trace summary: Query Metrics V2 description: 'Same as /metrics/search but returns metrics with node-type counts: trace (requests_count), session_count, and span_count in aggregate_metrics and in each bucket, similar to /metrics/custom_search.' operationId: query_metrics_v2_v2_projects__project_id__metrics_search_v2_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsMetricsQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsMetricsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/metrics/custom_search: post: tags: - trace summary: Query Custom Metrics operationId: query_custom_metrics_v2_projects__project_id__metrics_custom_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsCustomMetricsQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsMetricsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/sessions: post: tags: - trace summary: Create Session operationId: create_session_v2_projects__project_id__sessions_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SessionCreateRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/SessionCreateResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/sessions/search: post: tags: - trace summary: Query Sessions operationId: query_sessions_v2_projects__project_id__sessions_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/sessions/partial_search: post: tags: - trace summary: Query Partial Sessions operationId: query_partial_sessions_v2_projects__project_id__sessions_partial_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsPartialQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsPartialQueryResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/sessions/count: post: tags: - trace summary: Count Sessions operationId: count_sessions_v2_projects__project_id__sessions_count_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryCountRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryCountResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/sessions/{session_id}: get: tags: - trace summary: Get Session operationId: get_session_v2_projects__project_id__sessions__session_id__get security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: session_id in: path required: true schema: type: string format: uuid4 title: Session Id - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id - name: include_presigned_urls in: query required: false schema: type: boolean default: false title: Include Presigned Urls responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ExtendedSessionRecordWithChildren' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/export_records: post: tags: - trace summary: Export Records operationId: export_records_v2_projects__project_id__export_records_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsExportRequest' responses: '200': description: Successful Response content: application/json: schema: {} '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/export_records/url: post: tags: - trace summary: Export Records Url operationId: export_records_url_v2_projects__project_id__export_records_url_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsExportRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ExportPresignedUrlResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/traces/delete: post: tags: - trace summary: Delete Traces description: Delete all trace records that match the provided filters. operationId: delete_traces_v2_projects__project_id__traces_delete_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsDeleteRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsDeleteResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/spans/delete: post: tags: - trace summary: Delete Spans description: Delete all span records that match the provided filters. operationId: delete_spans_v2_projects__project_id__spans_delete_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsDeleteRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsDeleteResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /v2/projects/{project_id}/sessions/delete: post: tags: - trace summary: Delete Sessions description: Delete all session records that match the provided filters. operationId: delete_sessions_v2_projects__project_id__sessions_delete_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsDeleteRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsDeleteResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/traces/aggregated: post: tags: - trace summary: Get Aggregated Trace View operationId: get_aggregated_trace_view_public_v2_projects__project_id__traces_aggregated_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AggregatedTraceViewRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/AggregatedTraceViewResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/recompute-metrics: post: tags: - trace summary: Recompute Metrics operationId: recompute_metrics_public_v2_projects__project_id__recompute_metrics_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/RecomputeLogRecordsMetricsRequest' responses: '200': description: Successful Response content: application/json: schema: {} '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/traces: post: tags: - trace summary: Log Traces operationId: log_traces_public_v2_projects__project_id__traces_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogTracesIngestRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogTracesIngestResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/traces/{trace_id}: patch: tags: - trace summary: Update Trace description: Update a trace with the given ID. operationId: update_trace_public_v2_projects__project_id__traces__trace_id__patch security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: trace_id in: path required: true schema: type: string format: uuid4 title: Trace Id - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogTraceUpdateRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogTraceUpdateResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' get: tags: - trace summary: Get Trace operationId: get_trace_public_v2_projects__project_id__traces__trace_id__get security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: trace_id in: path required: true schema: type: string format: uuid4 title: Trace Id - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id - name: include_presigned_urls in: query required: false schema: type: boolean default: false title: Include Presigned Urls responses: '200': description: Successful Response content: application/json: schema: oneOf: - $ref: '#/components/schemas/ExtendedTraceRecordWithChildren' - $ref: '#/components/schemas/StubTraceRecord' discriminator: propertyName: type mapping: trace: '#/components/schemas/ExtendedTraceRecordWithChildren' stub_trace: '#/components/schemas/StubTraceRecord' title: Response Get Trace Public V2 Projects Project Id Traces Trace Id Get '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/spans/{span_id}: patch: tags: - trace summary: Update Span description: Update a span with the given ID. operationId: update_span_public_v2_projects__project_id__spans__span_id__patch security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: span_id in: path required: true schema: type: string format: uuid4 title: Span Id - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogSpanUpdateRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogSpanUpdateResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' get: tags: - trace summary: Get Span operationId: get_span_public_v2_projects__project_id__spans__span_id__get security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: span_id in: path required: true schema: type: string format: uuid4 title: Span Id - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id - name: include_presigned_urls in: query required: false schema: type: boolean default: false title: Include Presigned Urls responses: '200': description: Successful Response content: application/json: schema: oneOf: - $ref: '#/components/schemas/ExtendedAgentSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedWorkflowSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedLlmSpanRecord' - $ref: '#/components/schemas/ExtendedToolSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedRetrieverSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedControlSpanRecord' discriminator: propertyName: type mapping: agent: '#/components/schemas/ExtendedAgentSpanRecordWithChildren' workflow: '#/components/schemas/ExtendedWorkflowSpanRecordWithChildren' llm: '#/components/schemas/ExtendedLlmSpanRecord' tool: '#/components/schemas/ExtendedToolSpanRecordWithChildren' retriever: '#/components/schemas/ExtendedRetrieverSpanRecordWithChildren' control: '#/components/schemas/ExtendedControlSpanRecord' title: Response Get Span Public V2 Projects Project Id Spans Span Id Get '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/traces/available_columns: post: tags: - trace summary: Traces Available Columns operationId: traces_available_columns_public_v2_projects__project_id__traces_available_columns_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsAvailableColumnsRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsAvailableColumnsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/metrics-testing/available_columns: post: tags: - trace summary: Metrics Testing Available Columns operationId: metrics_testing_available_columns_public_v2_projects__project_id__metrics_testing_available_columns_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/MetricsTestingAvailableColumnsRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsAvailableColumnsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/spans/available_columns: post: tags: - trace summary: Spans Available Columns operationId: spans_available_columns_public_v2_projects__project_id__spans_available_columns_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsAvailableColumnsRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsAvailableColumnsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/sessions/available_columns: post: tags: - trace summary: Sessions Available Columns operationId: sessions_available_columns_public_v2_projects__project_id__sessions_available_columns_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsAvailableColumnsRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsAvailableColumnsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/traces/search: post: tags: - trace summary: Query Traces operationId: query_traces_public_v2_projects__project_id__traces_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/traces/partial_search: post: tags: - trace summary: Query Partial Traces operationId: query_partial_traces_public_v2_projects__project_id__traces_partial_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsPartialQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsPartialQueryResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/traces/count: post: tags: - trace summary: Count Traces description: This endpoint may return a slightly inaccurate count due to the way records are filtered before deduplication. operationId: count_traces_public_v2_projects__project_id__traces_count_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryCountRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryCountResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/spans: post: tags: - trace summary: Log Spans operationId: log_spans_public_v2_projects__project_id__spans_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogSpansIngestRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogSpansIngestResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/spans/search: post: tags: - trace summary: Query Spans operationId: query_spans_public_v2_projects__project_id__spans_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/spans/partial_search: post: tags: - trace summary: Query Partial Spans operationId: query_partial_spans_public_v2_projects__project_id__spans_partial_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsPartialQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsPartialQueryResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/spans/count: post: tags: - trace summary: Count Spans operationId: count_spans_public_v2_projects__project_id__spans_count_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryCountRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryCountResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/metrics/search: post: tags: - trace summary: Query Metrics operationId: query_metrics_public_v2_projects__project_id__metrics_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsMetricsQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsMetricsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/metrics/search/v2: post: tags: - trace summary: Query Metrics V2 description: 'Same as /metrics/search but returns metrics with node-type counts: trace (requests_count), session_count, and span_count in aggregate_metrics and in each bucket, similar to /metrics/custom_search.' operationId: query_metrics_v2_public_v2_projects__project_id__metrics_search_v2_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsMetricsQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsMetricsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/metrics/custom_search: post: tags: - trace summary: Query Custom Metrics operationId: query_custom_metrics_public_v2_projects__project_id__metrics_custom_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsCustomMetricsQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsMetricsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/sessions: post: tags: - trace summary: Create Session operationId: create_session_public_v2_projects__project_id__sessions_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SessionCreateRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/SessionCreateResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/sessions/search: post: tags: - trace summary: Query Sessions operationId: query_sessions_public_v2_projects__project_id__sessions_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/sessions/partial_search: post: tags: - trace summary: Query Partial Sessions operationId: query_partial_sessions_public_v2_projects__project_id__sessions_partial_search_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsPartialQueryRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsPartialQueryResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/sessions/count: post: tags: - trace summary: Count Sessions operationId: count_sessions_public_v2_projects__project_id__sessions_count_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryCountRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsQueryCountResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/sessions/{session_id}: get: tags: - trace summary: Get Session operationId: get_session_public_v2_projects__project_id__sessions__session_id__get security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: session_id in: path required: true schema: type: string format: uuid4 title: Session Id - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id - name: include_presigned_urls in: query required: false schema: type: boolean default: false title: Include Presigned Urls responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ExtendedSessionRecordWithChildren' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/export_records: post: tags: - trace summary: Export Records operationId: export_records_public_v2_projects__project_id__export_records_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsExportRequest' responses: '200': description: Successful Response content: application/json: schema: {} '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/export_records/url: post: tags: - trace summary: Export Records Url operationId: export_records_url_public_v2_projects__project_id__export_records_url_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsExportRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ExportPresignedUrlResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/traces/delete: post: tags: - trace summary: Delete Traces description: Delete all trace records that match the provided filters. operationId: delete_traces_public_v2_projects__project_id__traces_delete_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsDeleteRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsDeleteResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/spans/delete: post: tags: - trace summary: Delete Spans description: Delete all span records that match the provided filters. operationId: delete_spans_public_v2_projects__project_id__spans_delete_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsDeleteRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsDeleteResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' /public/v2/projects/{project_id}/sessions/delete: post: tags: - trace summary: Delete Sessions description: Delete all session records that match the provided filters. operationId: delete_sessions_public_v2_projects__project_id__sessions_delete_post security: - ClassicAPIKeyHeader: [] - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] parameters: - name: project_id in: path required: true schema: type: string format: uuid4 title: Project Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LogRecordsDeleteRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LogRecordsDeleteResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: MCPCallEvent: properties: type: type: string const: mcp_call title: Type default: mcp_call id: anyOf: - type: string - type: 'null' title: Id description: Unique identifier for the event status: anyOf: - $ref: '#/components/schemas/EventStatus' - type: 'null' description: Status of the event metadata: anyOf: - additionalProperties: true type: object - type: 'null' title: Metadata description: Provider-specific metadata and additional fields error_message: anyOf: - type: string - type: 'null' title: Error Message description: Error message if the event failed tool_name: anyOf: - type: string - type: 'null' title: Tool Name description: Name of the MCP tool being called server_name: anyOf: - type: string - type: 'null' title: Server Name description: Name of the MCP server arguments: anyOf: - additionalProperties: true type: object - type: 'null' title: Arguments description: Arguments for the MCP tool call result: anyOf: - additionalProperties: true type: object - type: 'null' title: Result description: Result from the MCP tool call type: object title: MCPCallEvent description: '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.' ? NotNode_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____-Input : properties: not: anyOf: - $ref: '#/components/schemas/FilterLeaf_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____' - $ref: '#/components/schemas/AndNode_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____-Input' - $ref: '#/components/schemas/OrNode_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____-Input' - $ref: '#/components/schemas/NotNode_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____-Input' title: Not type: object required: - not title: NotNode[Annotated[Union[LogRecordsIDFilter, LogRecordsDateFilter, LogRecordsNumberFilter, LogRecordsBooleanFilter, LogRecordsCollectionFilter, LogRecordsTextFilter, LogRecordsFullyAnnotatedFilter], FieldInfo(annotation=NoneType, required=True, discriminator='type')]] SystemMetricInfo: properties: aggregation_type: type: string const: numeric title: Aggregation Type description: 'Discriminator: numeric metrics aggregated via stats/histogram' default: numeric name: type: string title: Name description: Unique identifier for the metric label: type: string title: Label description: Human-readable display name for the metric unit: anyOf: - $ref: '#/components/schemas/DataUnit' - type: 'null' description: Unit of measurement, if any values: items: type: number type: array title: Values description: Raw metric values used to compute statistics and histograms mean: anyOf: - type: number - type: 'null' title: Mean description: Arithmetic mean of the metric values median: anyOf: - type: number - type: 'null' title: Median description: Median (50th percentile) of the metric values p5: anyOf: - type: number - type: 'null' title: P5 description: 5th percentile of the metric values p25: anyOf: - type: number - type: 'null' title: P25 description: 25th percentile (first quartile) of the metric values p75: anyOf: - type: number - type: 'null' title: P75 description: 75th percentile (third quartile) of the metric values p95: anyOf: - type: number - type: 'null' title: P95 description: 95th percentile of the metric values min: anyOf: - type: number - type: 'null' title: Min description: Minimum value in the metric dataset max: anyOf: - type: number - type: 'null' title: Max description: Maximum value in the metric dataset histogram: anyOf: - $ref: '#/components/schemas/Histogram' - type: 'null' description: Histogram representation of the metric distribution type: object required: - name - label title: SystemMetricInfo BucketedMetrics: properties: start_bucket_time: type: string format: date-time title: Start Bucket Time end_bucket_time: type: string format: date-time title: End Bucket Time additionalProperties: true type: object required: - start_bucket_time - end_bucket_time title: BucketedMetrics LlmMetrics: properties: duration_ns: anyOf: - type: integer - type: 'null' title: Duration Ns description: Duration of the trace or span in nanoseconds. Displayed as 'Latency' in Galileo. num_input_tokens: anyOf: - type: integer - type: 'null' title: Num Input Tokens description: Number of input tokens. num_output_tokens: anyOf: - type: integer - type: 'null' title: Num Output Tokens description: Number of output tokens. num_total_tokens: anyOf: - type: integer - type: 'null' title: Num Total Tokens description: Total number of tokens. time_to_first_token_ns: anyOf: - type: integer - type: 'null' title: Time To First Token Ns description: Time until the first token was generated in nanoseconds. num_image_input_tokens: anyOf: - type: integer - type: 'null' title: Num Image Input Tokens description: Number of image input tokens. num_audio_input_tokens: anyOf: - type: integer - type: 'null' title: Num Audio Input Tokens description: Number of audio input tokens. num_audio_output_tokens: anyOf: - type: integer - type: 'null' title: Num Audio Output Tokens description: Number of audio output tokens. num_image_output_tokens: anyOf: - type: integer - type: 'null' title: Num Image Output Tokens description: Number of image output tokens. additionalProperties: true type: object title: LlmMetrics LogRecordsCollectionFilter: properties: column_id: type: string title: Column Id description: ID of the column to filter. operator: type: string enum: - eq - contains - one_of - not_in title: Operator value: anyOf: - type: string - items: type: string type: array title: Value case_sensitive: type: boolean title: Case Sensitive default: true type: type: string const: collection title: Type default: collection type: object required: - column_id - operator - value title: LogRecordsCollectionFilter BaseScorerVersionDB: properties: id: type: string format: uuid4 title: Id version: type: integer title: Version scorer_id: type: string format: uuid4 title: Scorer Id generated_scorer: anyOf: - $ref: '#/components/schemas/BaseGeneratedScorerDB' - type: 'null' registered_scorer: anyOf: - $ref: '#/components/schemas/BaseRegisteredScorerDB' - type: 'null' finetuned_scorer: anyOf: - $ref: '#/components/schemas/BaseFinetunedScorerDB' - type: 'null' model_name: anyOf: - type: string - type: 'null' title: Model Name num_judges: anyOf: - type: integer - type: 'null' title: Num Judges scoreable_node_types: anyOf: - items: type: string type: array - type: 'null' title: Scoreable Node Types description: List of node types that can be scored by this scorer. Defaults to llm/chat. cot_enabled: anyOf: - type: boolean - type: 'null' title: Cot Enabled description: Whether to enable chain of thought for this scorer. Defaults to False for llm scorers. output_type: anyOf: - $ref: '#/components/schemas/OutputTypeEnum' - type: 'null' description: What type of output to use for model-based scorers (sessions_normalized, trace_io_only, etc.). input_type: anyOf: - $ref: '#/components/schemas/InputTypeEnum' - type: 'null' description: What type of input to use for model-based scorers (sessions_normalized, trace_io_only, etc.). type: object required: - id - version - scorer_id title: BaseScorerVersionDB description: Scorer version from the scorer_versions table. OutputTypeEnum: type: string enum: - boolean - categorical - count - discrete - freeform - percentage - multilabel - retrieved_chunk_list_boolean - boolean_multilabel title: OutputTypeEnum description: Enumeration of output types. LogRecordsTextFilter: properties: column_id: type: string title: Column Id description: ID of the column to filter. operator: type: string enum: - eq - ne - contains - one_of - not_in title: Operator value: anyOf: - type: string - items: type: string type: array title: Value case_sensitive: type: boolean title: Case Sensitive default: true type: type: string const: text title: Type default: text type: object required: - column_id - operator - value title: LogRecordsTextFilter LlmSpan: properties: type: type: string const: llm title: Type description: Type of the trace, span or session. default: llm input: items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array title: Input description: Input to the trace or span. redacted_input: anyOf: - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' description: Output of the trace or span. redacted_output: anyOf: - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - type: 'null' description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/LlmMetrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: anyOf: - type: string format: uuid4 - type: 'null' title: ID description: Galileo ID of the session, trace or span session_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session ID description: Galileo ID of the session containing the trace or span or session trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. parent_id: anyOf: - type: string format: uuid4 - type: 'null' title: Parent ID description: Galileo ID of the parent of this span tools: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Tools description: List of available tools passed to the LLM on invocation. events: anyOf: - items: oneOf: - $ref: '#/components/schemas/MessageEvent' - $ref: '#/components/schemas/ReasoningEvent' - $ref: '#/components/schemas/InternalToolCall' - $ref: '#/components/schemas/WebSearchCallEvent' - $ref: '#/components/schemas/ImageGenerationEvent' - $ref: '#/components/schemas/MCPCallEvent' - $ref: '#/components/schemas/MCPListToolsEvent' - $ref: '#/components/schemas/MCPApprovalRequestEvent' discriminator: propertyName: type mapping: image_generation: '#/components/schemas/ImageGenerationEvent' internal_tool_call: '#/components/schemas/InternalToolCall' mcp_approval_request: '#/components/schemas/MCPApprovalRequestEvent' mcp_call: '#/components/schemas/MCPCallEvent' mcp_list_tools: '#/components/schemas/MCPListToolsEvent' message: '#/components/schemas/MessageEvent' reasoning: '#/components/schemas/ReasoningEvent' web_search_call: '#/components/schemas/WebSearchCallEvent' type: array - type: 'null' title: Events description: List of reasoning, internal tool call, or MCP events that occurred during the LLM span. model: anyOf: - type: string - type: 'null' title: Model description: Model used for this span. temperature: anyOf: - type: number - type: 'null' title: Temperature description: Temperature used for generation. finish_reason: anyOf: - type: string - type: 'null' title: Finish Reason description: Reason for finishing. type: object title: LlmSpan PartialExtendedAgentSpanRecord: properties: type: type: string const: agent title: Type description: Type of the trace, span or session. default: agent input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Output' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Output description: Output of the trace or span. redacted_output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Output' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: anyOf: - type: string format: uuid - type: 'null' title: ID description: Galileo ID of the session, trace or span session_id: anyOf: - type: string format: uuid - type: 'null' title: Session ID description: Galileo ID of the session containing the trace (or the same value as id for a trace) trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) project_id: anyOf: - type: string format: uuid - type: 'null' title: Project ID description: Galileo ID of the project associated with this trace or span run_id: anyOf: - type: string format: uuid - type: 'null' title: Run ID description: Galileo ID of the run (log stream or experiment) associated with this trace or span updated_at: anyOf: - type: string format: date-time - type: 'null' title: Last Updated description: Timestamp of the session or trace or span's last update has_children: anyOf: - type: boolean - type: 'null' title: Has Children description: Whether or not this trace or span has child spans metrics_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Batch Id description: Galileo ID of the metrics batch associated with this trace or span session_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Batch Id description: Galileo ID of the metrics batch associated with this trace or span feedback_rating_info: additionalProperties: $ref: '#/components/schemas/FeedbackRatingInfo' type: object title: Feedback Rating Info description: Feedback information related to the record annotations: additionalProperties: additionalProperties: $ref: '#/components/schemas/AnnotationRatingInfo' propertyNames: format: uuid4 type: object propertyNames: format: uuid4 type: object title: Annotations description: Annotations keyed by template ID and annotator ID file_ids: items: type: string format: uuid4 type: array title: File Ids description: IDs of files associated with this record file_modalities: items: $ref: '#/components/schemas/ContentModality' type: array title: File Modalities description: Modalities of files associated with this record annotation_aggregates: additionalProperties: $ref: '#/components/schemas/AnnotationAggregate' propertyNames: format: uuid4 type: object title: Annotation Aggregates description: Annotation aggregate information keyed by template ID annotation_agreement: additionalProperties: type: number propertyNames: format: uuid4 type: object title: Annotation Agreement description: Annotation agreement scores keyed by template ID overall_annotation_agreement: anyOf: - type: number - type: 'null' title: Overall Annotation Agreement description: Average annotation agreement across all templates in the queue annotation_queue_ids: items: type: string format: uuid4 type: array title: Annotation Queue Ids description: IDs of annotation queues this record is in fully_annotated: anyOf: - type: boolean - type: 'null' title: Fully Annotated description: Whether every field is annotated by every annotator in the queue progress_message: type: string title: Progress Message description: Runner progress text written directly to CH span default: '' error_message: type: string title: Error Message description: Runner error text written directly to CH span default: '' metric_info: anyOf: - additionalProperties: oneOf: - $ref: '#/components/schemas/MetricNotComputed' - $ref: '#/components/schemas/MetricPending' - $ref: '#/components/schemas/MetricComputing' - $ref: '#/components/schemas/MetricNotApplicable' - $ref: '#/components/schemas/MetricSuccess' - $ref: '#/components/schemas/MetricError' - $ref: '#/components/schemas/MetricFailed' - $ref: '#/components/schemas/MetricRollUp' discriminator: propertyName: status_type mapping: computing: '#/components/schemas/MetricComputing' error: '#/components/schemas/MetricError' failed: '#/components/schemas/MetricFailed' not_applicable: '#/components/schemas/MetricNotApplicable' not_computed: '#/components/schemas/MetricNotComputed' pending: '#/components/schemas/MetricPending' roll_up: '#/components/schemas/MetricRollUp' success: '#/components/schemas/MetricSuccess' type: object - type: 'null' title: Metric Info description: Detailed information about the metrics associated with this trace or span files: anyOf: - additionalProperties: $ref: '#/components/schemas/FileMetadata' propertyNames: format: uuid4 type: object - type: 'null' title: Files description: File metadata keyed by file ID for files associated with this record parent_id: anyOf: - type: string format: uuid - type: 'null' title: Parent ID description: Galileo ID of the parent of this span is_complete: type: boolean title: Is Complete description: Whether the parent trace is complete or not default: true step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. agent_type: $ref: '#/components/schemas/AgentType' description: Agent type. default: default type: object title: PartialExtendedAgentSpanRecord MetricSuccess: properties: status_type: type: string const: success title: Status Type default: success scorer_type: anyOf: - $ref: '#/components/schemas/ScorerType' - type: 'null' metric_key_alias: anyOf: - type: string - type: 'null' title: Metric Key Alias value: anyOf: - type: string - type: integer - type: number - type: boolean - type: string format: uuid - type: string format: date-time - $ref: '#/components/schemas/Segment' - $ref: '#/components/schemas/HallucinationSegment' - $ref: '#/components/schemas/Document-Output' - $ref: '#/components/schemas/FeedbackRatingDB' - $ref: '#/components/schemas/FeedbackAggregate' - items: anyOf: - type: string - type: integer - type: number - type: boolean - type: string format: uuid - type: string format: date-time - $ref: '#/components/schemas/Segment' - $ref: '#/components/schemas/HallucinationSegment' - $ref: '#/components/schemas/Document-Output' - $ref: '#/components/schemas/FeedbackRatingDB' - $ref: '#/components/schemas/FeedbackAggregate' - type: 'null' type: array - items: items: anyOf: - type: string - type: integer - type: number - type: boolean - type: string format: uuid - type: string format: date-time - $ref: '#/components/schemas/Segment' - $ref: '#/components/schemas/HallucinationSegment' - $ref: '#/components/schemas/Document-Output' - $ref: '#/components/schemas/FeedbackRatingDB' - $ref: '#/components/schemas/FeedbackAggregate' - type: 'null' type: array type: array - items: items: items: anyOf: - type: string - type: integer - type: number - type: boolean - type: string format: uuid - type: string format: date-time - $ref: '#/components/schemas/Segment' - $ref: '#/components/schemas/HallucinationSegment' - $ref: '#/components/schemas/Document-Output' - $ref: '#/components/schemas/FeedbackRatingDB' - $ref: '#/components/schemas/FeedbackAggregate' - type: 'null' type: array type: array type: array - type: 'null' title: Value explanation: anyOf: - type: string - type: 'null' title: Explanation cost: anyOf: - type: number - type: 'null' title: Cost model_alias: anyOf: - type: string - type: 'null' title: Model Alias num_judges: anyOf: - type: integer - type: 'null' title: Num Judges multijudge_average: anyOf: - type: number - type: 'null' title: Multijudge Average input_tokens: anyOf: - type: integer - type: 'null' title: Input Tokens output_tokens: anyOf: - type: integer - type: 'null' title: Output Tokens total_tokens: anyOf: - type: integer - type: 'null' title: Total Tokens critique: anyOf: - $ref: '#/components/schemas/MetricCritiqueColumnar' - type: 'null' metadata: anyOf: - additionalProperties: true type: object - type: 'null' title: Metadata description: Optional per-row context returned alongside the score by code-based scorers that return a (score, metadata) tuple. Sourced from the {metric_name}_metadata auxiliary key, which is stored as a JSON string in ClickHouse. display_value: anyOf: - type: string - type: 'null' title: Display Value rationale: anyOf: - type: string - type: 'null' title: Rationale type: object required: - value title: MetricSuccess LogTraceUpdateResponse: properties: log_stream_id: anyOf: - type: string format: uuid4 - type: 'null' title: Log Stream Id description: Log stream id associated with the traces. experiment_id: anyOf: - type: string format: uuid4 - type: 'null' title: Experiment Id description: Experiment id associated with the traces. metrics_testing_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Testing Id description: Metrics testing id associated with the traces. project_id: type: string format: uuid4 title: Project Id description: Project id associated with the traces. project_name: type: string title: Project Name description: Project name associated with the traces. session_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Id description: Session id associated with the traces. records_count: type: integer title: Records Count description: Total number of records ingested trace_id: type: string format: uuid4 title: Trace Id description: Trace id associated with the updated trace. type: object required: - project_id - project_name - records_count - trace_id title: LogTraceUpdateResponse AnnotationStarAggregate: properties: annotation_type: type: string const: star title: Annotation Type default: star average: type: number title: Average counts: additionalProperties: type: integer type: object title: Counts unrated_count: type: integer title: Unrated Count type: object required: - average - counts - unrated_count title: AnnotationStarAggregate LogRecordsDateFilter: properties: column_id: type: string title: Column Id description: ID of the column to filter. operator: type: string enum: - eq - ne - gt - gte - lt - lte title: Operator value: type: string format: date-time title: Value type: type: string const: date title: Type default: date type: object required: - column_id - operator - value title: LogRecordsDateFilter NodeNameFilter: properties: name: type: string const: node_name title: Name default: node_name operator: type: string enum: - eq - ne - contains - one_of - not_in title: Operator value: anyOf: - type: string - items: type: string type: array title: Value case_sensitive: type: boolean title: Case Sensitive default: true type: object required: - operator - value title: NodeNameFilter description: Filters on node names in scorer jobs. LogRecordsIDFilter: properties: column_id: type: string title: Column Id description: ID of the column to filter. operator: type: string enum: - eq - ne - one_of - not_in - contains title: Operator default: eq value: anyOf: - type: string format: uuid4 - items: anyOf: - type: string format: uuid4 - type: string type: array - type: string title: Value type: type: string const: id title: Type default: id type: object required: - column_id - value title: LogRecordsIDFilter ColumnCategory: type: string enum: - standard - metric - user_metadata - metric_status - dataset_metadata - dataset - feedback - tags title: ColumnCategory TreeChoiceAggregate: properties: feedback_type: type: string const: tree_choice title: Feedback Type default: tree_choice counts: additionalProperties: type: integer type: object title: Counts unrated_count: type: integer title: Unrated Count type: object required: - counts - unrated_count title: TreeChoiceAggregate ExportPresignedUrlResponse: properties: url: type: string title: Url url_expires_at: type: string format: date-time title: Url Expires At file_name: type: string title: File Name content_type: type: string title: Content Type type: object required: - url - url_expires_at - file_name - content_type title: ExportPresignedUrlResponse description: Response for an export written to object storage. LogRecordsColumnInfo: properties: id: type: string title: Id description: Column id. Must be universally unique. label: anyOf: - type: string - type: 'null' title: Label description: Display label of the column in the UI. category: $ref: '#/components/schemas/ColumnCategory' description: Category of the column. description: anyOf: - type: string - type: 'null' title: Description description: Description of the column. group_label: anyOf: - type: string - type: 'null' title: Group Label description: Display label of the column group. data_type: anyOf: - $ref: '#/components/schemas/DataType' - type: 'null' description: Data type of the column. This is used to determine how to format the data on the UI. data_unit: anyOf: - $ref: '#/components/schemas/DataUnit' - type: 'null' description: Data unit of the column (optional). multi_valued: type: boolean title: Multi Valued description: Whether the column is multi-valued. default: false allowed_values: anyOf: - items: {} type: array uniqueItems: true - type: 'null' title: Allowed Values description: Allowed values for this column. sortable: type: boolean title: Sortable description: Whether the column is sortable. filterable: type: boolean title: Filterable description: Whether the column is filterable. is_empty: type: boolean title: Is Empty description: Indicates whether the column is empty and should be hidden. default: false applicable_types: items: $ref: '#/components/schemas/StepType' type: array uniqueItems: true title: Applicable Types description: List of types applicable for this column. is_optional: type: boolean title: Is Optional description: Whether the column is optional. default: false roll_up_method: anyOf: - type: string - type: 'null' title: Roll Up Method description: Default roll-up aggregation method for this metric (e.g., 'sum', 'average'). metric_key_alias: anyOf: - type: string - type: 'null' title: Metric Key Alias description: Alternate metric key for this column. When scorer UUIDs are used as column IDs, this holds the legacy metric_name string for dual-key ClickHouse query fallback. scorer_config: anyOf: - $ref: '#/components/schemas/ScorerConfig' - type: 'null' description: 'For metric columns only: Scorer config that produced the metric.' scorer_id: anyOf: - type: string format: uuid4 - type: 'null' title: Scorer Id description: 'For metric columns only: Scorer id that produced the metric. This is deprecated and will be removed in future versions.' insight_type: anyOf: - $ref: '#/components/schemas/InsightType' - type: 'null' description: Insight type. filter_type: anyOf: - $ref: '#/components/schemas/LogRecordsFilterType' - type: 'null' description: Filter type. threshold: anyOf: - $ref: '#/components/schemas/MetricThreshold' - type: 'null' description: Thresholds for the column, if this is a metrics column. label_color: anyOf: - type: string enum: - positive - negative - type: 'null' title: Label Color description: Type of label color for the column, if this is a multilabel metric column. type: object required: - id - category - data_type title: LogRecordsColumnInfo ErrorSeverity: type: string enum: - low - medium - high - critical title: ErrorSeverity description: Error severity levels for catalog entries. LogRecordsPartialQueryRequest: properties: starting_token: type: integer title: Starting Token default: 0 limit: type: integer title: Limit default: 100 previous_last_row_id: anyOf: - type: string format: uuid4 - type: 'null' title: Previous Last Row Id log_stream_id: anyOf: - type: string format: uuid4 - type: 'null' title: Log Stream Id description: Log stream id associated with the traces. experiment_id: anyOf: - type: string format: uuid4 - type: 'null' title: Experiment Id description: Experiment id associated with the traces. metrics_testing_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Testing Id description: Metrics testing id associated with the traces. filters: items: oneOf: - $ref: '#/components/schemas/LogRecordsIDFilter' - $ref: '#/components/schemas/LogRecordsDateFilter' - $ref: '#/components/schemas/LogRecordsNumberFilter' - $ref: '#/components/schemas/LogRecordsBooleanFilter' - $ref: '#/components/schemas/LogRecordsCollectionFilter' - $ref: '#/components/schemas/LogRecordsTextFilter' - $ref: '#/components/schemas/LogRecordsFullyAnnotatedFilter' discriminator: propertyName: type mapping: boolean: '#/components/schemas/LogRecordsBooleanFilter' collection: '#/components/schemas/LogRecordsCollectionFilter' date: '#/components/schemas/LogRecordsDateFilter' fully_annotated: '#/components/schemas/LogRecordsFullyAnnotatedFilter' id: '#/components/schemas/LogRecordsIDFilter' number: '#/components/schemas/LogRecordsNumberFilter' text: '#/components/schemas/LogRecordsTextFilter' type: array title: Filters filter_tree: anyOf: - $ref: '#/components/schemas/FilterExpression_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____-Input' - type: 'null' sort: anyOf: - $ref: '#/components/schemas/LogRecordsSortClause' - type: 'null' description: Sort for the query. Defaults to native sort (created_at, id descending). truncate_fields: type: boolean title: Truncate Fields default: false include_counts: type: boolean title: Include Counts description: If True, include computed child counts (e.g., num_traces for sessions, num_spans for traces). default: false include_code_metric_metadata: type: boolean title: Include Code Metric Metadata description: If True, include per-row scorer metadata (the dict returned alongside the score by code-based scorers via the (score, metadata) tuple-return contract) on each MetricSuccess in the response. Off by default to keep payloads small for callers that don't need it. default: false select_columns: $ref: '#/components/schemas/SelectColumns' type: object required: - select_columns title: LogRecordsPartialQueryRequest description: Request to query a genai project run (log stream or experiment) with partial results. examples: - filters: - case_sensitive: true name: input operator: eq type: text value: example input log_stream_id: 00000000-0000-0000-0000-000000000000 pagination: limit: 5 starting_token: 0 select_columns: column_ids: - id - metrics/agentic_session_success - metrics/completeness_gpt include_all_feedback: false include_all_metrics: false includes_metric_columns: true metric_columns_names: - agentic_session_success - completeness_gpt sort: ascending: false name: updated_at sort_type: column - filter_tree: and: - or: - filter: name: input operator: contains type: text value: abx - filter: name: output operator: contains type: text value: xyz - filter: name: session_id operator: eq type: id value: 123e4567-e89b-42d3-a456-426614174000 log_stream_id: 00000000-0000-0000-0000-000000000000 pagination: limit: 5 starting_token: 0 select_columns: column_ids: - id include_all_feedback: false include_all_metrics: true includes_metric_columns: true metric_columns_names: [] sort: ascending: false name: updated_at sort_type: column BaseFinetunedScorerDB: properties: id: type: string format: uuid4 title: Id name: type: string title: Name lora_task_id: type: integer title: Lora Task Id lora_weights_path: anyOf: - type: string - type: 'null' title: Lora Weights Path prompt: type: string title: Prompt luna_input_type: anyOf: - $ref: '#/components/schemas/LunaInputTypeEnum' - type: 'null' luna_output_type: anyOf: - $ref: '#/components/schemas/LunaOutputTypeEnum' - type: 'null' class_name_to_vocab_ix: anyOf: - additionalProperties: items: type: integer type: array uniqueItems: true type: object - additionalProperties: type: integer type: object - type: 'null' title: Class Name To Vocab Ix executor: anyOf: - $ref: '#/components/schemas/galileo_core__schemas__shared__scorers__scorer_name__ScorerName' - type: 'null' description: Executor pipeline. Defaults to finetuned scorer pipeline but can run custom galileo score pipelines. type: object required: - id - name - lora_task_id - prompt title: BaseFinetunedScorerDB ScoreAggregate: properties: feedback_type: type: string const: score title: Feedback Type default: score average: type: number title: Average unrated_count: type: integer title: Unrated Count type: object required: - average - unrated_count title: ScoreAggregate MetricsTestingAvailableColumnsRequest: properties: log_stream_id: anyOf: - type: string format: uuid4 - type: 'null' title: Log Stream Id description: Log stream id associated with the traces. experiment_id: anyOf: - type: string format: uuid4 - type: 'null' title: Experiment Id description: Experiment id associated with the traces. metrics_testing_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Testing Id description: Metrics testing id associated with the traces. name: type: string title: Name description: Name of the metric that we are testing. output_type: anyOf: - $ref: '#/components/schemas/OutputTypeEnum' - type: 'null' description: Output type of the scorer. Required when metric_key is REGISTERED_SCORER_VALIDATION; used to determine the data_type for validation columns. cot_enabled: type: boolean title: Cot Enabled description: Whether the metrics testing table is using chain of thought (CoT) enabled scorers. If True, the columns will be generated for CoT enabled scorers. default: false metric_key: type: string title: Metric Key description: The metric key to use for column generation (e.g., 'generated_scorer_validation' or 'registered_scorer_validation'). default: generated_scorer_validation required_scorers: anyOf: - items: type: string type: array - type: 'null' title: Required Scorers description: List of required scorer names for composite scorers. Columns will be generated for these scorers. score_type: anyOf: - type: string - type: 'null' title: Score Type description: The score type for registered scorers (e.g., 'bool', 'int', 'float', 'str'). Used to determine the correct data_type for the column. Provided by validation result. type: object required: - name title: MetricsTestingAvailableColumnsRequest description: Request to get the available columns for the metrics testing table. libs__python__schemas__log_records__feedback__ScoreRating: properties: feedback_type: type: string const: score title: Feedback Type default: score value: type: integer title: Value type: object required: - value title: ScoreRating LogRecordsCustomMetricsQueryRequest: properties: log_stream_id: anyOf: - type: string format: uuid4 - type: 'null' title: Log Stream Id description: Log stream id associated with the traces. experiment_id: anyOf: - type: string format: uuid4 - type: 'null' title: Experiment Id description: Experiment id associated with the traces. metrics_testing_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Testing Id description: Metrics testing id associated with the traces. filter_tree: anyOf: - $ref: '#/components/schemas/FilterExpression_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____-Input' - type: 'null' description: Filter expression tree for complex filtering start_time: type: string format: date-time title: Start Time description: Include traces from this time onward. end_time: type: string format: date-time title: End Time description: Include traces up to this time. interval_minutes: type: integer title: Interval Minutes description: Time interval in minutes for bucketing default: 5 metric_details: items: $ref: '#/components/schemas/MetricAggregationDetail' type: array maxItems: 100 title: Metric Details description: List of metrics to aggregate with their widget IDs and aggregation types (max 100) group_by: anyOf: - type: string - type: 'null' title: Group By description: Column to group by type: object required: - start_time - end_time - metric_details title: LogRecordsCustomMetricsQueryRequest examples: - end_time: '2024-01-07T23:59:59Z' filter_tree: and_: - filter: case_sensitive: true name: input operator: contains type: text value: customer group_by: model interval_minutes: 1440 log_stream_id: c5fef527-51f6-49d0-800a-1859b678a098 metric_details: - aggregation: Sum id: w1 metric_name: num_total_tokens - aggregation: Average id: w2 metric_name: toxicity start_time: '2024-01-01T00:00:00Z' ExtendedTraceRecordWithChildren: properties: spans: items: oneOf: - $ref: '#/components/schemas/ExtendedAgentSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedWorkflowSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedLlmSpanRecord' - $ref: '#/components/schemas/ExtendedToolSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedRetrieverSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedControlSpanRecord' discriminator: propertyName: type mapping: agent: '#/components/schemas/ExtendedAgentSpanRecordWithChildren' control: '#/components/schemas/ExtendedControlSpanRecord' llm: '#/components/schemas/ExtendedLlmSpanRecord' retriever: '#/components/schemas/ExtendedRetrieverSpanRecordWithChildren' tool: '#/components/schemas/ExtendedToolSpanRecordWithChildren' workflow: '#/components/schemas/ExtendedWorkflowSpanRecordWithChildren' type: array title: Spans type: type: string const: trace title: Type description: Type of the trace, span or session. default: trace input: anyOf: - type: string - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: anyOf: - type: string - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Output description: Output of the trace or span. redacted_output: anyOf: - type: string - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: type: string format: uuid4 title: ID description: Galileo ID of the trace session_id: type: string format: uuid4 title: Session ID description: Galileo ID of the session containing the trace (or the same value as id for a trace) trace_id: type: string format: uuid4 title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) project_id: type: string format: uuid4 title: Project ID description: Galileo ID of the project associated with this trace or span run_id: type: string format: uuid4 title: Run ID description: Galileo ID of the run (log stream or experiment) associated with this trace or span updated_at: anyOf: - type: string format: date-time - type: 'null' title: Last Updated description: Timestamp of the session or trace or span's last update has_children: anyOf: - type: boolean - type: 'null' title: Has Children description: Whether or not this trace or span has child spans metrics_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Batch Id description: Galileo ID of the metrics batch associated with this trace or span session_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Batch Id description: Galileo ID of the metrics batch associated with this trace or span feedback_rating_info: additionalProperties: $ref: '#/components/schemas/FeedbackRatingInfo' type: object title: Feedback Rating Info description: Feedback information related to the record annotations: additionalProperties: additionalProperties: $ref: '#/components/schemas/AnnotationRatingInfo' propertyNames: format: uuid4 type: object propertyNames: format: uuid4 type: object title: Annotations description: Annotations keyed by template ID and annotator ID file_ids: items: type: string format: uuid4 type: array title: File Ids description: IDs of files associated with this record file_modalities: items: $ref: '#/components/schemas/ContentModality' type: array title: File Modalities description: Modalities of files associated with this record annotation_aggregates: additionalProperties: $ref: '#/components/schemas/AnnotationAggregate' propertyNames: format: uuid4 type: object title: Annotation Aggregates description: Annotation aggregate information keyed by template ID annotation_agreement: additionalProperties: type: number propertyNames: format: uuid4 type: object title: Annotation Agreement description: Annotation agreement scores keyed by template ID overall_annotation_agreement: anyOf: - type: number - type: 'null' title: Overall Annotation Agreement description: Average annotation agreement across all templates in the queue annotation_queue_ids: items: type: string format: uuid4 type: array title: Annotation Queue Ids description: IDs of annotation queues this record is in fully_annotated: anyOf: - type: boolean - type: 'null' title: Fully Annotated description: Whether every field is annotated by every annotator in the queue progress_message: type: string title: Progress Message description: Runner progress text written directly to CH span default: '' error_message: type: string title: Error Message description: Runner error text written directly to CH span default: '' metric_info: anyOf: - additionalProperties: oneOf: - $ref: '#/components/schemas/MetricNotComputed' - $ref: '#/components/schemas/MetricPending' - $ref: '#/components/schemas/MetricComputing' - $ref: '#/components/schemas/MetricNotApplicable' - $ref: '#/components/schemas/MetricSuccess' - $ref: '#/components/schemas/MetricError' - $ref: '#/components/schemas/MetricFailed' - $ref: '#/components/schemas/MetricRollUp' discriminator: propertyName: status_type mapping: computing: '#/components/schemas/MetricComputing' error: '#/components/schemas/MetricError' failed: '#/components/schemas/MetricFailed' not_applicable: '#/components/schemas/MetricNotApplicable' not_computed: '#/components/schemas/MetricNotComputed' pending: '#/components/schemas/MetricPending' roll_up: '#/components/schemas/MetricRollUp' success: '#/components/schemas/MetricSuccess' type: object - type: 'null' title: Metric Info description: Detailed information about the metrics associated with this trace or span files: anyOf: - additionalProperties: $ref: '#/components/schemas/FileMetadata' propertyNames: format: uuid4 type: object - type: 'null' title: Files description: File metadata keyed by file ID for files associated with this record is_complete: type: boolean title: Is Complete description: Whether the trace is complete or not default: true num_spans: anyOf: - type: integer - type: 'null' title: Num Spans type: object required: - id - session_id - trace_id - project_id - run_id title: ExtendedTraceRecordWithChildren ContentModality: type: string enum: - text - document - image - audio - video title: ContentModality description: Classification of content modality libs__python__schemas__log_records__feedback__ChoiceRating: properties: feedback_type: type: string const: choice title: Feedback Type default: choice value: type: string maxLength: 255 minLength: 1 title: Value type: object required: - value title: ChoiceRating ExtendedAgentSpanRecord: properties: type: type: string const: agent title: Type description: Type of the trace, span or session. default: agent input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Output' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Output description: Output of the trace or span. redacted_output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Output' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: type: string format: uuid4 title: ID description: Galileo ID of the session, trace or span session_id: type: string format: uuid4 title: Session ID description: Galileo ID of the session containing the trace (or the same value as id for a trace) trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) project_id: type: string format: uuid4 title: Project ID description: Galileo ID of the project associated with this trace or span run_id: type: string format: uuid4 title: Run ID description: Galileo ID of the run (log stream or experiment) associated with this trace or span updated_at: anyOf: - type: string format: date-time - type: 'null' title: Last Updated description: Timestamp of the session or trace or span's last update has_children: anyOf: - type: boolean - type: 'null' title: Has Children description: Whether or not this trace or span has child spans metrics_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Batch Id description: Galileo ID of the metrics batch associated with this trace or span session_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Batch Id description: Galileo ID of the metrics batch associated with this trace or span feedback_rating_info: additionalProperties: $ref: '#/components/schemas/FeedbackRatingInfo' type: object title: Feedback Rating Info description: Feedback information related to the record annotations: additionalProperties: additionalProperties: $ref: '#/components/schemas/AnnotationRatingInfo' propertyNames: format: uuid4 type: object propertyNames: format: uuid4 type: object title: Annotations description: Annotations keyed by template ID and annotator ID file_ids: items: type: string format: uuid4 type: array title: File Ids description: IDs of files associated with this record file_modalities: items: $ref: '#/components/schemas/ContentModality' type: array title: File Modalities description: Modalities of files associated with this record annotation_aggregates: additionalProperties: $ref: '#/components/schemas/AnnotationAggregate' propertyNames: format: uuid4 type: object title: Annotation Aggregates description: Annotation aggregate information keyed by template ID annotation_agreement: additionalProperties: type: number propertyNames: format: uuid4 type: object title: Annotation Agreement description: Annotation agreement scores keyed by template ID overall_annotation_agreement: anyOf: - type: number - type: 'null' title: Overall Annotation Agreement description: Average annotation agreement across all templates in the queue annotation_queue_ids: items: type: string format: uuid4 type: array title: Annotation Queue Ids description: IDs of annotation queues this record is in fully_annotated: anyOf: - type: boolean - type: 'null' title: Fully Annotated description: Whether every field is annotated by every annotator in the queue progress_message: type: string title: Progress Message description: Runner progress text written directly to CH span default: '' error_message: type: string title: Error Message description: Runner error text written directly to CH span default: '' metric_info: anyOf: - additionalProperties: oneOf: - $ref: '#/components/schemas/MetricNotComputed' - $ref: '#/components/schemas/MetricPending' - $ref: '#/components/schemas/MetricComputing' - $ref: '#/components/schemas/MetricNotApplicable' - $ref: '#/components/schemas/MetricSuccess' - $ref: '#/components/schemas/MetricError' - $ref: '#/components/schemas/MetricFailed' - $ref: '#/components/schemas/MetricRollUp' discriminator: propertyName: status_type mapping: computing: '#/components/schemas/MetricComputing' error: '#/components/schemas/MetricError' failed: '#/components/schemas/MetricFailed' not_applicable: '#/components/schemas/MetricNotApplicable' not_computed: '#/components/schemas/MetricNotComputed' pending: '#/components/schemas/MetricPending' roll_up: '#/components/schemas/MetricRollUp' success: '#/components/schemas/MetricSuccess' type: object - type: 'null' title: Metric Info description: Detailed information about the metrics associated with this trace or span files: anyOf: - additionalProperties: $ref: '#/components/schemas/FileMetadata' propertyNames: format: uuid4 type: object - type: 'null' title: Files description: File metadata keyed by file ID for files associated with this record parent_id: type: string format: uuid4 title: Parent ID description: Galileo ID of the parent of this span is_complete: type: boolean title: Is Complete description: Whether the parent trace is complete or not default: true step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. agent_type: $ref: '#/components/schemas/AgentType' description: Agent type. default: default type: object required: - id - session_id - project_id - run_id - parent_id title: ExtendedAgentSpanRecord SessionCreateResponse: properties: id: type: string format: uuid4 title: Id description: Session id associated with the session. name: anyOf: - type: string - type: 'null' title: Name description: Name of the session. project_id: type: string format: uuid4 title: Project Id description: Project id associated with the session. project_name: type: string title: Project Name description: Project name associated with the session. previous_session_id: anyOf: - type: string format: uuid4 - type: 'null' title: Previous Session Id description: Id of the previous session. external_id: anyOf: - type: string - type: 'null' title: External Id description: External id of the session. type: object required: - id - name - project_id - project_name title: SessionCreateResponse PartialExtendedSessionRecord: properties: type: type: string const: session title: Type description: Type of the trace, span or session. default: session input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array title: Input default: '' redacted_input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Output' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Output description: Output of the trace or span. redacted_output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Output' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: anyOf: - type: string format: uuid - type: 'null' title: ID description: Galileo ID of the session session_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session ID description: Galileo ID of the session containing the trace or span or session trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) project_id: anyOf: - type: string format: uuid - type: 'null' title: Project ID description: Galileo ID of the project associated with this trace or span run_id: anyOf: - type: string format: uuid - type: 'null' title: Run ID description: Galileo ID of the run (log stream or experiment) associated with this trace or span updated_at: anyOf: - type: string format: date-time - type: 'null' title: Last Updated description: Timestamp of the session or trace or span's last update has_children: anyOf: - type: boolean - type: 'null' title: Has Children description: Whether or not this trace or span has child spans metrics_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Batch Id description: Galileo ID of the metrics batch associated with this trace or span session_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Batch Id description: Galileo ID of the metrics batch associated with this trace or span feedback_rating_info: additionalProperties: $ref: '#/components/schemas/FeedbackRatingInfo' type: object title: Feedback Rating Info description: Feedback information related to the record annotations: additionalProperties: additionalProperties: $ref: '#/components/schemas/AnnotationRatingInfo' propertyNames: format: uuid4 type: object propertyNames: format: uuid4 type: object title: Annotations description: Annotations keyed by template ID and annotator ID file_ids: items: type: string format: uuid4 type: array title: File Ids description: IDs of files associated with this record file_modalities: items: $ref: '#/components/schemas/ContentModality' type: array title: File Modalities description: Modalities of files associated with this record annotation_aggregates: additionalProperties: $ref: '#/components/schemas/AnnotationAggregate' propertyNames: format: uuid4 type: object title: Annotation Aggregates description: Annotation aggregate information keyed by template ID annotation_agreement: additionalProperties: type: number propertyNames: format: uuid4 type: object title: Annotation Agreement description: Annotation agreement scores keyed by template ID overall_annotation_agreement: anyOf: - type: number - type: 'null' title: Overall Annotation Agreement description: Average annotation agreement across all templates in the queue annotation_queue_ids: items: type: string format: uuid4 type: array title: Annotation Queue Ids description: IDs of annotation queues this record is in fully_annotated: anyOf: - type: boolean - type: 'null' title: Fully Annotated description: Whether every field is annotated by every annotator in the queue progress_message: type: string title: Progress Message description: Runner progress text written directly to CH span default: '' error_message: type: string title: Error Message description: Runner error text written directly to CH span default: '' metric_info: anyOf: - additionalProperties: oneOf: - $ref: '#/components/schemas/MetricNotComputed' - $ref: '#/components/schemas/MetricPending' - $ref: '#/components/schemas/MetricComputing' - $ref: '#/components/schemas/MetricNotApplicable' - $ref: '#/components/schemas/MetricSuccess' - $ref: '#/components/schemas/MetricError' - $ref: '#/components/schemas/MetricFailed' - $ref: '#/components/schemas/MetricRollUp' discriminator: propertyName: status_type mapping: computing: '#/components/schemas/MetricComputing' error: '#/components/schemas/MetricError' failed: '#/components/schemas/MetricFailed' not_applicable: '#/components/schemas/MetricNotApplicable' not_computed: '#/components/schemas/MetricNotComputed' pending: '#/components/schemas/MetricPending' roll_up: '#/components/schemas/MetricRollUp' success: '#/components/schemas/MetricSuccess' type: object - type: 'null' title: Metric Info description: Detailed information about the metrics associated with this trace or span files: anyOf: - additionalProperties: $ref: '#/components/schemas/FileMetadata' propertyNames: format: uuid4 type: object - type: 'null' title: Files description: File metadata keyed by file ID for files associated with this record previous_session_id: anyOf: - type: string format: uuid4 - type: 'null' title: Previous Session Id num_traces: anyOf: - type: integer - type: 'null' title: Num Traces type: object title: PartialExtendedSessionRecord LogRecordsFullyAnnotatedFilter: properties: column_id: type: string const: fully_annotated title: Column Id description: Queue-scoped filter identifier. This filter only works for annotation-queue searches that provide queue context. default: fully_annotated type: type: string const: fully_annotated title: Type default: fully_annotated user_ids: anyOf: - items: type: string format: uuid4 type: array minItems: 1 - type: 'null' title: User Ids description: Optional queue member IDs to require for full annotation in a queue-scoped search. If omitted, all tracked queue members visible to the requester are used. type: object title: LogRecordsFullyAnnotatedFilter description: Queue-scoped filter for records rated across all queue templates. MCPListToolsEvent: properties: type: type: string const: mcp_list_tools title: Type default: mcp_list_tools id: anyOf: - type: string - type: 'null' title: Id description: Unique identifier for the event status: anyOf: - $ref: '#/components/schemas/EventStatus' - type: 'null' description: Status of the event metadata: anyOf: - additionalProperties: true type: object - type: 'null' title: Metadata description: Provider-specific metadata and additional fields error_message: anyOf: - type: string - type: 'null' title: Error Message description: Error message if the event failed server_name: anyOf: - type: string - type: 'null' title: Server Name description: Name of the MCP server tools: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Tools description: List of available MCP tools type: object title: MCPListToolsEvent description: MCP list tools event - when the model queries available MCP tools. ToolCall: properties: id: type: string title: Id function: $ref: '#/components/schemas/ToolCallFunction' type: object required: - id - function title: ToolCall AnnotationType: type: string enum: - like_dislike - star - score - tags - text - choice - tree_choice title: AnnotationType LogRecordsQueryResponse: properties: starting_token: type: integer title: Starting Token default: 0 limit: type: integer title: Limit default: 100 paginated: type: boolean title: Paginated default: false next_starting_token: anyOf: - type: integer - type: 'null' title: Next Starting Token last_row_id: anyOf: - type: string format: uuid4 - type: 'null' title: Last Row Id records: items: oneOf: - $ref: '#/components/schemas/ExtendedTraceRecord' - $ref: '#/components/schemas/ExtendedAgentSpanRecord' - $ref: '#/components/schemas/ExtendedWorkflowSpanRecord' - $ref: '#/components/schemas/ExtendedLlmSpanRecord' - $ref: '#/components/schemas/ExtendedToolSpanRecord' - $ref: '#/components/schemas/ExtendedRetrieverSpanRecord' - $ref: '#/components/schemas/ExtendedControlSpanRecord' - $ref: '#/components/schemas/ExtendedSessionRecord' discriminator: propertyName: type mapping: agent: '#/components/schemas/ExtendedAgentSpanRecord' control: '#/components/schemas/ExtendedControlSpanRecord' llm: '#/components/schemas/ExtendedLlmSpanRecord' retriever: '#/components/schemas/ExtendedRetrieverSpanRecord' session: '#/components/schemas/ExtendedSessionRecord' tool: '#/components/schemas/ExtendedToolSpanRecord' trace: '#/components/schemas/ExtendedTraceRecord' workflow: '#/components/schemas/ExtendedWorkflowSpanRecord' type: array title: Records description: records matching the query num_records: type: integer title: Num Records description: number of records readOnly: true type: object required: - num_records title: LogRecordsQueryResponse examples: - next_starting_token: 2 num_rows: 2 paginated: true records: - annotation_aggregates: {} annotation_agreement: {} annotation_queue_ids: [] annotations: {} created_at: '2026-07-18T04:11:24.446077Z' dataset_metadata: {} error_message: '' feedback_rating_info: {} file_ids: [] file_modalities: [] id: 1a0939d1-8b43-4fe3-a91c-196e2d9847e3 input: Who is a smart LLM? is_complete: true metrics: duration_ns: 4 name: '' output: I am progress_message: '' project_id: 0d4e3799-3861-4759-875f-9ae14c167b0a run_id: 74aec44e-ec21-4c9f-a3e2-b2ab2b81b4db session_id: 1a0939d1-8b43-4fe3-a91c-196e2d9847e3 tags: [] trace_id: 1a0939d1-8b43-4fe3-a91c-196e2d9847e3 type: trace user_metadata: {} - annotation_aggregates: {} annotation_agreement: {} annotation_queue_ids: [] annotations: {} created_at: '2026-07-18T04:11:24.446231Z' dataset_metadata: {} error_message: '' feedback_rating_info: {} file_ids: [] file_modalities: [] id: 1edc2401-24b4-448c-a392-b36932293061 input: - content: Who is a smart LLM? role: user is_complete: true metrics: duration_ns: 4 num_input_tokens: 4 num_output_tokens: 2 num_total_tokens: 6 name: '' output: content: I am role: user parent_id: 1a0939d1-8b43-4fe3-a91c-196e2d9847e3 progress_message: '' project_id: 0d4e3799-3861-4759-875f-9ae14c167b0a run_id: 74aec44e-ec21-4c9f-a3e2-b2ab2b81b4db session_id: 1a0939d1-8b43-4fe3-a91c-196e2d9847e3 tags: [] trace_id: 1a0939d1-8b43-4fe3-a91c-196e2d9847e3 type: llm user_metadata: {} ControlResult: properties: action: $ref: '#/components/schemas/ControlAction' description: Decision/action produced by the control. matched: type: boolean title: Matched description: Whether the control matched. False covers both non-match and error cases; use error_message to distinguish errors. confidence: anyOf: - type: number - type: 'null' title: Confidence description: Confidence score reported by the control evaluation result. error_message: anyOf: - type: string - type: 'null' title: Error Message description: Error text when control evaluation failed. This should be null for normal matches and non-matches. type: object required: - action - matched title: ControlResult LogSpansIngestResponse: properties: log_stream_id: anyOf: - type: string format: uuid4 - type: 'null' title: Log Stream Id description: Log stream id associated with the traces. experiment_id: anyOf: - type: string format: uuid4 - type: 'null' title: Experiment Id description: Experiment id associated with the traces. metrics_testing_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Testing Id description: Metrics testing id associated with the traces. project_id: type: string format: uuid4 title: Project Id description: Project id associated with the traces. project_name: type: string title: Project Name description: Project name associated with the traces. session_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Id description: Session id associated with the traces. records_count: type: integer title: Records Count description: Total number of records ingested trace_id: type: string format: uuid4 title: Trace Id description: Trace id associated with the spans. parent_id: type: string format: uuid4 title: Parent Id description: Parent trace or span id. type: object required: - project_id - project_name - records_count - trace_id - parent_id title: LogSpansIngestResponse ExtendedLlmSpanRecord: properties: type: type: string const: llm title: Type description: Type of the trace, span or session. default: llm input: items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array title: Input description: Input to the trace or span. redacted_input: anyOf: - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' description: Output of the trace or span. redacted_output: anyOf: - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - type: 'null' description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/LlmMetrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: type: string format: uuid4 title: ID description: Galileo ID of the session, trace or span session_id: type: string format: uuid4 title: Session ID description: Galileo ID of the session containing the trace (or the same value as id for a trace) trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) project_id: type: string format: uuid4 title: Project ID description: Galileo ID of the project associated with this trace or span run_id: type: string format: uuid4 title: Run ID description: Galileo ID of the run (log stream or experiment) associated with this trace or span updated_at: anyOf: - type: string format: date-time - type: 'null' title: Last Updated description: Timestamp of the session or trace or span's last update has_children: anyOf: - type: boolean - type: 'null' title: Has Children description: Whether or not this trace or span has child spans metrics_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Batch Id description: Galileo ID of the metrics batch associated with this trace or span session_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Batch Id description: Galileo ID of the metrics batch associated with this trace or span feedback_rating_info: additionalProperties: $ref: '#/components/schemas/FeedbackRatingInfo' type: object title: Feedback Rating Info description: Feedback information related to the record annotations: additionalProperties: additionalProperties: $ref: '#/components/schemas/AnnotationRatingInfo' propertyNames: format: uuid4 type: object propertyNames: format: uuid4 type: object title: Annotations description: Annotations keyed by template ID and annotator ID file_ids: items: type: string format: uuid4 type: array title: File Ids description: IDs of files associated with this record file_modalities: items: $ref: '#/components/schemas/ContentModality' type: array title: File Modalities description: Modalities of files associated with this record annotation_aggregates: additionalProperties: $ref: '#/components/schemas/AnnotationAggregate' propertyNames: format: uuid4 type: object title: Annotation Aggregates description: Annotation aggregate information keyed by template ID annotation_agreement: additionalProperties: type: number propertyNames: format: uuid4 type: object title: Annotation Agreement description: Annotation agreement scores keyed by template ID overall_annotation_agreement: anyOf: - type: number - type: 'null' title: Overall Annotation Agreement description: Average annotation agreement across all templates in the queue annotation_queue_ids: items: type: string format: uuid4 type: array title: Annotation Queue Ids description: IDs of annotation queues this record is in fully_annotated: anyOf: - type: boolean - type: 'null' title: Fully Annotated description: Whether every field is annotated by every annotator in the queue progress_message: type: string title: Progress Message description: Runner progress text written directly to CH span default: '' error_message: type: string title: Error Message description: Runner error text written directly to CH span default: '' metric_info: anyOf: - additionalProperties: oneOf: - $ref: '#/components/schemas/MetricNotComputed' - $ref: '#/components/schemas/MetricPending' - $ref: '#/components/schemas/MetricComputing' - $ref: '#/components/schemas/MetricNotApplicable' - $ref: '#/components/schemas/MetricSuccess' - $ref: '#/components/schemas/MetricError' - $ref: '#/components/schemas/MetricFailed' - $ref: '#/components/schemas/MetricRollUp' discriminator: propertyName: status_type mapping: computing: '#/components/schemas/MetricComputing' error: '#/components/schemas/MetricError' failed: '#/components/schemas/MetricFailed' not_applicable: '#/components/schemas/MetricNotApplicable' not_computed: '#/components/schemas/MetricNotComputed' pending: '#/components/schemas/MetricPending' roll_up: '#/components/schemas/MetricRollUp' success: '#/components/schemas/MetricSuccess' type: object - type: 'null' title: Metric Info description: Detailed information about the metrics associated with this trace or span files: anyOf: - additionalProperties: $ref: '#/components/schemas/FileMetadata' propertyNames: format: uuid4 type: object - type: 'null' title: Files description: File metadata keyed by file ID for files associated with this record parent_id: type: string format: uuid4 title: Parent ID description: Galileo ID of the parent of this span is_complete: type: boolean title: Is Complete description: Whether the parent trace is complete or not default: true step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. tools: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Tools description: List of available tools passed to the LLM on invocation. events: anyOf: - items: oneOf: - $ref: '#/components/schemas/MessageEvent' - $ref: '#/components/schemas/ReasoningEvent' - $ref: '#/components/schemas/InternalToolCall' - $ref: '#/components/schemas/WebSearchCallEvent' - $ref: '#/components/schemas/ImageGenerationEvent' - $ref: '#/components/schemas/MCPCallEvent' - $ref: '#/components/schemas/MCPListToolsEvent' - $ref: '#/components/schemas/MCPApprovalRequestEvent' discriminator: propertyName: type mapping: image_generation: '#/components/schemas/ImageGenerationEvent' internal_tool_call: '#/components/schemas/InternalToolCall' mcp_approval_request: '#/components/schemas/MCPApprovalRequestEvent' mcp_call: '#/components/schemas/MCPCallEvent' mcp_list_tools: '#/components/schemas/MCPListToolsEvent' message: '#/components/schemas/MessageEvent' reasoning: '#/components/schemas/ReasoningEvent' web_search_call: '#/components/schemas/WebSearchCallEvent' type: array - type: 'null' title: Events description: List of reasoning, internal tool call, or MCP events that occurred during the LLM span. model: anyOf: - type: string - type: 'null' title: Model description: Model used for this span. temperature: anyOf: - type: number - type: 'null' title: Temperature description: Temperature used for generation. finish_reason: anyOf: - type: string - type: 'null' title: Finish Reason description: Reason for finishing. type: object required: - id - session_id - project_id - run_id - parent_id title: ExtendedLlmSpanRecord ExtendedAgentSpanRecordWithChildren: properties: spans: items: oneOf: - $ref: '#/components/schemas/ExtendedAgentSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedWorkflowSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedLlmSpanRecord' - $ref: '#/components/schemas/ExtendedToolSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedRetrieverSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedControlSpanRecord' discriminator: propertyName: type mapping: agent: '#/components/schemas/ExtendedAgentSpanRecordWithChildren' control: '#/components/schemas/ExtendedControlSpanRecord' llm: '#/components/schemas/ExtendedLlmSpanRecord' retriever: '#/components/schemas/ExtendedRetrieverSpanRecordWithChildren' tool: '#/components/schemas/ExtendedToolSpanRecordWithChildren' workflow: '#/components/schemas/ExtendedWorkflowSpanRecordWithChildren' type: array title: Spans type: type: string const: agent title: Type description: Type of the trace, span or session. default: agent input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Output' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Output description: Output of the trace or span. redacted_output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Output' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: type: string format: uuid4 title: ID description: Galileo ID of the session, trace or span session_id: type: string format: uuid4 title: Session ID description: Galileo ID of the session containing the trace (or the same value as id for a trace) trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) project_id: type: string format: uuid4 title: Project ID description: Galileo ID of the project associated with this trace or span run_id: type: string format: uuid4 title: Run ID description: Galileo ID of the run (log stream or experiment) associated with this trace or span updated_at: anyOf: - type: string format: date-time - type: 'null' title: Last Updated description: Timestamp of the session or trace or span's last update has_children: anyOf: - type: boolean - type: 'null' title: Has Children description: Whether or not this trace or span has child spans metrics_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Batch Id description: Galileo ID of the metrics batch associated with this trace or span session_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Batch Id description: Galileo ID of the metrics batch associated with this trace or span feedback_rating_info: additionalProperties: $ref: '#/components/schemas/FeedbackRatingInfo' type: object title: Feedback Rating Info description: Feedback information related to the record annotations: additionalProperties: additionalProperties: $ref: '#/components/schemas/AnnotationRatingInfo' propertyNames: format: uuid4 type: object propertyNames: format: uuid4 type: object title: Annotations description: Annotations keyed by template ID and annotator ID file_ids: items: type: string format: uuid4 type: array title: File Ids description: IDs of files associated with this record file_modalities: items: $ref: '#/components/schemas/ContentModality' type: array title: File Modalities description: Modalities of files associated with this record annotation_aggregates: additionalProperties: $ref: '#/components/schemas/AnnotationAggregate' propertyNames: format: uuid4 type: object title: Annotation Aggregates description: Annotation aggregate information keyed by template ID annotation_agreement: additionalProperties: type: number propertyNames: format: uuid4 type: object title: Annotation Agreement description: Annotation agreement scores keyed by template ID overall_annotation_agreement: anyOf: - type: number - type: 'null' title: Overall Annotation Agreement description: Average annotation agreement across all templates in the queue annotation_queue_ids: items: type: string format: uuid4 type: array title: Annotation Queue Ids description: IDs of annotation queues this record is in fully_annotated: anyOf: - type: boolean - type: 'null' title: Fully Annotated description: Whether every field is annotated by every annotator in the queue progress_message: type: string title: Progress Message description: Runner progress text written directly to CH span default: '' error_message: type: string title: Error Message description: Runner error text written directly to CH span default: '' metric_info: anyOf: - additionalProperties: oneOf: - $ref: '#/components/schemas/MetricNotComputed' - $ref: '#/components/schemas/MetricPending' - $ref: '#/components/schemas/MetricComputing' - $ref: '#/components/schemas/MetricNotApplicable' - $ref: '#/components/schemas/MetricSuccess' - $ref: '#/components/schemas/MetricError' - $ref: '#/components/schemas/MetricFailed' - $ref: '#/components/schemas/MetricRollUp' discriminator: propertyName: status_type mapping: computing: '#/components/schemas/MetricComputing' error: '#/components/schemas/MetricError' failed: '#/components/schemas/MetricFailed' not_applicable: '#/components/schemas/MetricNotApplicable' not_computed: '#/components/schemas/MetricNotComputed' pending: '#/components/schemas/MetricPending' roll_up: '#/components/schemas/MetricRollUp' success: '#/components/schemas/MetricSuccess' type: object - type: 'null' title: Metric Info description: Detailed information about the metrics associated with this trace or span files: anyOf: - additionalProperties: $ref: '#/components/schemas/FileMetadata' propertyNames: format: uuid4 type: object - type: 'null' title: Files description: File metadata keyed by file ID for files associated with this record parent_id: type: string format: uuid4 title: Parent ID description: Galileo ID of the parent of this span is_complete: type: boolean title: Is Complete description: Whether the parent trace is complete or not default: true step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. agent_type: $ref: '#/components/schemas/AgentType' description: Agent type. default: default type: object required: - id - session_id - project_id - run_id - parent_id title: ExtendedAgentSpanRecordWithChildren LunaInputTypeEnum: type: string enum: - span - trace_object - trace_input_output_only title: LunaInputTypeEnum ControlAction: type: string enum: - deny - steer - observe title: ControlAction PartialExtendedTraceRecord: properties: type: type: string const: trace title: Type description: Type of the trace, span or session. default: trace input: anyOf: - type: string - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: anyOf: - type: string - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Output description: Output of the trace or span. redacted_output: anyOf: - type: string - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: anyOf: - type: string format: uuid - type: 'null' title: ID description: Galileo ID of the trace session_id: anyOf: - type: string format: uuid - type: 'null' title: Session ID description: Galileo ID of the session containing the trace (or the same value as id for a trace) trace_id: anyOf: - type: string format: uuid - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) project_id: anyOf: - type: string format: uuid - type: 'null' title: Project ID description: Galileo ID of the project associated with this trace or span run_id: anyOf: - type: string format: uuid - type: 'null' title: Run ID description: Galileo ID of the run (log stream or experiment) associated with this trace or span updated_at: anyOf: - type: string format: date-time - type: 'null' title: Last Updated description: Timestamp of the session or trace or span's last update has_children: anyOf: - type: boolean - type: 'null' title: Has Children description: Whether or not this trace or span has child spans metrics_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Batch Id description: Galileo ID of the metrics batch associated with this trace or span session_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Batch Id description: Galileo ID of the metrics batch associated with this trace or span feedback_rating_info: additionalProperties: $ref: '#/components/schemas/FeedbackRatingInfo' type: object title: Feedback Rating Info description: Feedback information related to the record annotations: additionalProperties: additionalProperties: $ref: '#/components/schemas/AnnotationRatingInfo' propertyNames: format: uuid4 type: object propertyNames: format: uuid4 type: object title: Annotations description: Annotations keyed by template ID and annotator ID file_ids: items: type: string format: uuid4 type: array title: File Ids description: IDs of files associated with this record file_modalities: items: $ref: '#/components/schemas/ContentModality' type: array title: File Modalities description: Modalities of files associated with this record annotation_aggregates: additionalProperties: $ref: '#/components/schemas/AnnotationAggregate' propertyNames: format: uuid4 type: object title: Annotation Aggregates description: Annotation aggregate information keyed by template ID annotation_agreement: additionalProperties: type: number propertyNames: format: uuid4 type: object title: Annotation Agreement description: Annotation agreement scores keyed by template ID overall_annotation_agreement: anyOf: - type: number - type: 'null' title: Overall Annotation Agreement description: Average annotation agreement across all templates in the queue annotation_queue_ids: items: type: string format: uuid4 type: array title: Annotation Queue Ids description: IDs of annotation queues this record is in fully_annotated: anyOf: - type: boolean - type: 'null' title: Fully Annotated description: Whether every field is annotated by every annotator in the queue progress_message: type: string title: Progress Message description: Runner progress text written directly to CH span default: '' error_message: type: string title: Error Message description: Runner error text written directly to CH span default: '' metric_info: anyOf: - additionalProperties: oneOf: - $ref: '#/components/schemas/MetricNotComputed' - $ref: '#/components/schemas/MetricPending' - $ref: '#/components/schemas/MetricComputing' - $ref: '#/components/schemas/MetricNotApplicable' - $ref: '#/components/schemas/MetricSuccess' - $ref: '#/components/schemas/MetricError' - $ref: '#/components/schemas/MetricFailed' - $ref: '#/components/schemas/MetricRollUp' discriminator: propertyName: status_type mapping: computing: '#/components/schemas/MetricComputing' error: '#/components/schemas/MetricError' failed: '#/components/schemas/MetricFailed' not_applicable: '#/components/schemas/MetricNotApplicable' not_computed: '#/components/schemas/MetricNotComputed' pending: '#/components/schemas/MetricPending' roll_up: '#/components/schemas/MetricRollUp' success: '#/components/schemas/MetricSuccess' type: object - type: 'null' title: Metric Info description: Detailed information about the metrics associated with this trace or span files: anyOf: - additionalProperties: $ref: '#/components/schemas/FileMetadata' propertyNames: format: uuid4 type: object - type: 'null' title: Files description: File metadata keyed by file ID for files associated with this record is_complete: type: boolean title: Is Complete description: Whether the trace is complete or not default: true num_spans: anyOf: - type: integer - type: 'null' title: Num Spans type: object title: PartialExtendedTraceRecord FeedbackAggregate: properties: aggregate: oneOf: - $ref: '#/components/schemas/LikeDislikeAggregate' - $ref: '#/components/schemas/StarAggregate' - $ref: '#/components/schemas/ScoreAggregate' - $ref: '#/components/schemas/TagsAggregate' - $ref: '#/components/schemas/TextAggregate' - $ref: '#/components/schemas/ChoiceAggregate' - $ref: '#/components/schemas/TreeChoiceAggregate' title: Aggregate discriminator: propertyName: feedback_type mapping: choice: '#/components/schemas/ChoiceAggregate' like_dislike: '#/components/schemas/LikeDislikeAggregate' score: '#/components/schemas/ScoreAggregate' star: '#/components/schemas/StarAggregate' tags: '#/components/schemas/TagsAggregate' text: '#/components/schemas/TextAggregate' tree_choice: '#/components/schemas/TreeChoiceAggregate' type: object required: - aggregate title: FeedbackAggregate ExtendedRetrieverSpanRecordWithChildren: properties: spans: items: oneOf: - $ref: '#/components/schemas/ExtendedAgentSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedWorkflowSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedLlmSpanRecord' - $ref: '#/components/schemas/ExtendedToolSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedRetrieverSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedControlSpanRecord' discriminator: propertyName: type mapping: agent: '#/components/schemas/ExtendedAgentSpanRecordWithChildren' control: '#/components/schemas/ExtendedControlSpanRecord' llm: '#/components/schemas/ExtendedLlmSpanRecord' retriever: '#/components/schemas/ExtendedRetrieverSpanRecordWithChildren' tool: '#/components/schemas/ExtendedToolSpanRecordWithChildren' workflow: '#/components/schemas/ExtendedWorkflowSpanRecordWithChildren' type: array title: Spans type: type: string const: retriever title: Type description: Type of the trace, span or session. default: retriever input: type: string title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: items: $ref: '#/components/schemas/Document-Output' type: array title: Output description: Output of the trace or span. redacted_output: anyOf: - items: $ref: '#/components/schemas/Document-Output' type: array - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: type: string format: uuid4 title: ID description: Galileo ID of the session, trace or span session_id: type: string format: uuid4 title: Session ID description: Galileo ID of the session containing the trace (or the same value as id for a trace) trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) project_id: type: string format: uuid4 title: Project ID description: Galileo ID of the project associated with this trace or span run_id: type: string format: uuid4 title: Run ID description: Galileo ID of the run (log stream or experiment) associated with this trace or span updated_at: anyOf: - type: string format: date-time - type: 'null' title: Last Updated description: Timestamp of the session or trace or span's last update has_children: anyOf: - type: boolean - type: 'null' title: Has Children description: Whether or not this trace or span has child spans metrics_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Batch Id description: Galileo ID of the metrics batch associated with this trace or span session_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Batch Id description: Galileo ID of the metrics batch associated with this trace or span feedback_rating_info: additionalProperties: $ref: '#/components/schemas/FeedbackRatingInfo' type: object title: Feedback Rating Info description: Feedback information related to the record annotations: additionalProperties: additionalProperties: $ref: '#/components/schemas/AnnotationRatingInfo' propertyNames: format: uuid4 type: object propertyNames: format: uuid4 type: object title: Annotations description: Annotations keyed by template ID and annotator ID file_ids: items: type: string format: uuid4 type: array title: File Ids description: IDs of files associated with this record file_modalities: items: $ref: '#/components/schemas/ContentModality' type: array title: File Modalities description: Modalities of files associated with this record annotation_aggregates: additionalProperties: $ref: '#/components/schemas/AnnotationAggregate' propertyNames: format: uuid4 type: object title: Annotation Aggregates description: Annotation aggregate information keyed by template ID annotation_agreement: additionalProperties: type: number propertyNames: format: uuid4 type: object title: Annotation Agreement description: Annotation agreement scores keyed by template ID overall_annotation_agreement: anyOf: - type: number - type: 'null' title: Overall Annotation Agreement description: Average annotation agreement across all templates in the queue annotation_queue_ids: items: type: string format: uuid4 type: array title: Annotation Queue Ids description: IDs of annotation queues this record is in fully_annotated: anyOf: - type: boolean - type: 'null' title: Fully Annotated description: Whether every field is annotated by every annotator in the queue progress_message: type: string title: Progress Message description: Runner progress text written directly to CH span default: '' error_message: type: string title: Error Message description: Runner error text written directly to CH span default: '' metric_info: anyOf: - additionalProperties: oneOf: - $ref: '#/components/schemas/MetricNotComputed' - $ref: '#/components/schemas/MetricPending' - $ref: '#/components/schemas/MetricComputing' - $ref: '#/components/schemas/MetricNotApplicable' - $ref: '#/components/schemas/MetricSuccess' - $ref: '#/components/schemas/MetricError' - $ref: '#/components/schemas/MetricFailed' - $ref: '#/components/schemas/MetricRollUp' discriminator: propertyName: status_type mapping: computing: '#/components/schemas/MetricComputing' error: '#/components/schemas/MetricError' failed: '#/components/schemas/MetricFailed' not_applicable: '#/components/schemas/MetricNotApplicable' not_computed: '#/components/schemas/MetricNotComputed' pending: '#/components/schemas/MetricPending' roll_up: '#/components/schemas/MetricRollUp' success: '#/components/schemas/MetricSuccess' type: object - type: 'null' title: Metric Info description: Detailed information about the metrics associated with this trace or span files: anyOf: - additionalProperties: $ref: '#/components/schemas/FileMetadata' propertyNames: format: uuid4 type: object - type: 'null' title: Files description: File metadata keyed by file ID for files associated with this record parent_id: type: string format: uuid4 title: Parent ID description: Galileo ID of the parent of this span is_complete: type: boolean title: Is Complete description: Whether the parent trace is complete or not default: true step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. type: object required: - id - session_id - project_id - run_id - parent_id title: ExtendedRetrieverSpanRecordWithChildren PartialExtendedControlSpanRecord: properties: type: type: string const: control title: Type description: Type of the trace, span or session. default: control input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: anyOf: - $ref: '#/components/schemas/ControlResult' - type: 'null' description: Output of the trace or span. redacted_output: anyOf: - $ref: '#/components/schemas/ControlResult' - type: 'null' description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: anyOf: - type: string format: uuid - type: 'null' title: ID description: Galileo ID of the session, trace or span session_id: anyOf: - type: string format: uuid - type: 'null' title: Session ID description: Galileo ID of the session containing the trace (or the same value as id for a trace) trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) project_id: anyOf: - type: string format: uuid - type: 'null' title: Project ID description: Galileo ID of the project associated with this trace or span run_id: anyOf: - type: string format: uuid - type: 'null' title: Run ID description: Galileo ID of the run (log stream or experiment) associated with this trace or span updated_at: anyOf: - type: string format: date-time - type: 'null' title: Last Updated description: Timestamp of the session or trace or span's last update has_children: anyOf: - type: boolean - type: 'null' title: Has Children description: Whether or not this trace or span has child spans metrics_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Batch Id description: Galileo ID of the metrics batch associated with this trace or span session_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Batch Id description: Galileo ID of the metrics batch associated with this trace or span feedback_rating_info: additionalProperties: $ref: '#/components/schemas/FeedbackRatingInfo' type: object title: Feedback Rating Info description: Feedback information related to the record annotations: additionalProperties: additionalProperties: $ref: '#/components/schemas/AnnotationRatingInfo' propertyNames: format: uuid4 type: object propertyNames: format: uuid4 type: object title: Annotations description: Annotations keyed by template ID and annotator ID file_ids: items: type: string format: uuid4 type: array title: File Ids description: IDs of files associated with this record file_modalities: items: $ref: '#/components/schemas/ContentModality' type: array title: File Modalities description: Modalities of files associated with this record annotation_aggregates: additionalProperties: $ref: '#/components/schemas/AnnotationAggregate' propertyNames: format: uuid4 type: object title: Annotation Aggregates description: Annotation aggregate information keyed by template ID annotation_agreement: additionalProperties: type: number propertyNames: format: uuid4 type: object title: Annotation Agreement description: Annotation agreement scores keyed by template ID overall_annotation_agreement: anyOf: - type: number - type: 'null' title: Overall Annotation Agreement description: Average annotation agreement across all templates in the queue annotation_queue_ids: items: type: string format: uuid4 type: array title: Annotation Queue Ids description: IDs of annotation queues this record is in fully_annotated: anyOf: - type: boolean - type: 'null' title: Fully Annotated description: Whether every field is annotated by every annotator in the queue progress_message: type: string title: Progress Message description: Runner progress text written directly to CH span default: '' error_message: type: string title: Error Message description: Runner error text written directly to CH span default: '' metric_info: anyOf: - additionalProperties: oneOf: - $ref: '#/components/schemas/MetricNotComputed' - $ref: '#/components/schemas/MetricPending' - $ref: '#/components/schemas/MetricComputing' - $ref: '#/components/schemas/MetricNotApplicable' - $ref: '#/components/schemas/MetricSuccess' - $ref: '#/components/schemas/MetricError' - $ref: '#/components/schemas/MetricFailed' - $ref: '#/components/schemas/MetricRollUp' discriminator: propertyName: status_type mapping: computing: '#/components/schemas/MetricComputing' error: '#/components/schemas/MetricError' failed: '#/components/schemas/MetricFailed' not_applicable: '#/components/schemas/MetricNotApplicable' not_computed: '#/components/schemas/MetricNotComputed' pending: '#/components/schemas/MetricPending' roll_up: '#/components/schemas/MetricRollUp' success: '#/components/schemas/MetricSuccess' type: object - type: 'null' title: Metric Info description: Detailed information about the metrics associated with this trace or span files: anyOf: - additionalProperties: $ref: '#/components/schemas/FileMetadata' propertyNames: format: uuid4 type: object - type: 'null' title: Files description: File metadata keyed by file ID for files associated with this record parent_id: anyOf: - type: string format: uuid - type: 'null' title: Parent ID description: Galileo ID of the parent of this span is_complete: type: boolean title: Is Complete description: Whether the parent trace is complete or not default: true step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. control_id: anyOf: - type: integer - type: 'null' title: Control Id description: Identifier of the control definition that produced this span. agent_name: anyOf: - type: string - type: 'null' title: Agent Name description: Normalized agent name associated with this control execution. check_stage: anyOf: - $ref: '#/components/schemas/ControlCheckStage' - type: 'null' description: Execution stage where the control ran, typically 'pre' or 'post'. applies_to: anyOf: - $ref: '#/components/schemas/ControlAppliesTo' - type: 'null' description: Parent execution type the control applied to, for example 'llm_call' or 'tool_call'. evaluator_name: anyOf: - type: string - type: 'null' title: Evaluator Name description: Representative evaluator name for this control span. For composite controls, this is the primary evaluator chosen for observability identity. selector_path: anyOf: - type: string - type: 'null' title: Selector Path description: Representative selector path for this control span. For composite controls, this is the primary selector path chosen for observability identity. type: object title: PartialExtendedControlSpanRecord ChoiceAggregate: properties: feedback_type: type: string const: choice title: Feedback Type default: choice counts: additionalProperties: type: integer type: object title: Counts unrated_count: type: integer title: Unrated Count type: object required: - counts - unrated_count title: ChoiceAggregate AggregatedTraceViewEdge: properties: source: type: string title: Source target: type: string title: Target weight: type: number title: Weight occurrences: type: integer title: Occurrences trace_count: type: integer title: Trace Count trace_ids: items: type: string format: uuid4 type: array title: Trace Ids type: object required: - source - target - weight - occurrences - trace_count - trace_ids title: AggregatedTraceViewEdge LogRecordsQueryRequest: properties: starting_token: type: integer title: Starting Token default: 0 limit: type: integer title: Limit default: 100 previous_last_row_id: anyOf: - type: string format: uuid4 - type: 'null' title: Previous Last Row Id log_stream_id: anyOf: - type: string format: uuid4 - type: 'null' title: Log Stream Id description: Log stream id associated with the traces. experiment_id: anyOf: - type: string format: uuid4 - type: 'null' title: Experiment Id description: Experiment id associated with the traces. metrics_testing_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Testing Id description: Metrics testing id associated with the traces. filters: items: oneOf: - $ref: '#/components/schemas/LogRecordsIDFilter' - $ref: '#/components/schemas/LogRecordsDateFilter' - $ref: '#/components/schemas/LogRecordsNumberFilter' - $ref: '#/components/schemas/LogRecordsBooleanFilter' - $ref: '#/components/schemas/LogRecordsCollectionFilter' - $ref: '#/components/schemas/LogRecordsTextFilter' - $ref: '#/components/schemas/LogRecordsFullyAnnotatedFilter' discriminator: propertyName: type mapping: boolean: '#/components/schemas/LogRecordsBooleanFilter' collection: '#/components/schemas/LogRecordsCollectionFilter' date: '#/components/schemas/LogRecordsDateFilter' fully_annotated: '#/components/schemas/LogRecordsFullyAnnotatedFilter' id: '#/components/schemas/LogRecordsIDFilter' number: '#/components/schemas/LogRecordsNumberFilter' text: '#/components/schemas/LogRecordsTextFilter' type: array title: Filters filter_tree: anyOf: - $ref: '#/components/schemas/FilterExpression_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____-Input' - type: 'null' sort: anyOf: - $ref: '#/components/schemas/LogRecordsSortClause' - type: 'null' description: Sort for the query. Defaults to native sort (created_at, id descending). truncate_fields: type: boolean title: Truncate Fields default: false include_counts: type: boolean title: Include Counts description: If True, include computed child counts (e.g., num_traces for sessions, num_spans for traces). default: false include_code_metric_metadata: type: boolean title: Include Code Metric Metadata description: If True, include per-row scorer metadata (the dict returned alongside the score by code-based scorers via the (score, metadata) tuple-return contract) on each MetricSuccess in the response. Off by default to keep payloads small for callers that don't need it. default: false type: object title: LogRecordsQueryRequest examples: - filters: - case_sensitive: true name: input operator: eq type: text value: example input log_stream_id: 00000000-0000-0000-0000-000000000000 pagination: limit: 5 starting_token: 0 sort: ascending: false name: updated_at sort_type: column - filter_tree: and: - or: - filter: name: input operator: contains type: text value: abx - filter: name: output operator: contains type: text value: xyz - filter: name: session_id operator: eq type: id value: 123e4567-e89b-42d3-a456-426614174000 log_stream_id: 00000000-0000-0000-0000-000000000000 pagination: limit: 5 starting_token: 0 sort: ascending: false name: updated_at sort_type: column HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ScorerType: type: string enum: - Luna - Plus title: ScorerType Segment: properties: start: type: integer title: Start end: type: integer title: End value: anyOf: - type: number - type: integer - type: string title: Value prob: anyOf: - type: number - type: 'null' title: Prob type: object required: - start - end - value title: Segment RollUpMethodDisplayOptions: type: string enum: - average - sum - max - min - category_count - percentage_true - percentage_false title: RollUpMethodDisplayOptions description: 'Display options for roll up methods when showing rolled up metrics in the UI. Separates display intent from computation methods. The computation methods (NumericRollUpMethod, CategoricalRollUpMethod) control what aggregations are available. This enum controls how the UI displays the selected roll-up value for a scorer.' ReasoningEvent: properties: type: type: string const: reasoning title: Type default: reasoning id: anyOf: - type: string - type: 'null' title: Id description: Unique identifier for the event status: anyOf: - $ref: '#/components/schemas/EventStatus' - type: 'null' description: Status of the event metadata: anyOf: - additionalProperties: true type: object - type: 'null' title: Metadata description: Provider-specific metadata and additional fields error_message: anyOf: - type: string - type: 'null' title: Error Message description: Error message if the event failed content: anyOf: - type: string - type: 'null' title: Content description: The reasoning/thinking content summary: anyOf: - type: string - items: additionalProperties: true type: object type: array - type: 'null' title: Summary description: Summary of the reasoning type: object title: ReasoningEvent description: Internal reasoning/thinking from the model (e.g., OpenAI o1/o3 reasoning tokens). FileMetadata: properties: file_id: type: string format: uuid4 title: File Id modality: $ref: '#/components/schemas/ContentModality' content_type: anyOf: - type: string - type: 'null' title: Content Type url: anyOf: - type: string - type: 'null' title: Url description: Presigned S3 URL or external URL url_expires_at: anyOf: - type: string format: date-time - type: 'null' title: Url Expires At description: Expiration time size_bytes: anyOf: - type: integer - type: 'null' title: Size Bytes filename: anyOf: - type: string - type: 'null' title: Filename source: $ref: '#/components/schemas/FileSource' status: $ref: '#/components/schemas/FileStatus' type: object required: - file_id - modality - source - status title: FileMetadata description: 'Enriched file metadata returned to UI/SDK. Contains presigned URLs and properties for displaying multimodal content in the Galileo console and SDKs.' WebSearchCallEvent: properties: type: type: string const: web_search_call title: Type default: web_search_call id: anyOf: - type: string - type: 'null' title: Id description: Unique identifier for the event status: anyOf: - $ref: '#/components/schemas/EventStatus' - type: 'null' description: Status of the event metadata: anyOf: - additionalProperties: true type: object - type: 'null' title: Metadata description: Provider-specific metadata and additional fields error_message: anyOf: - type: string - type: 'null' title: Error Message description: Error message if the event failed action: $ref: '#/components/schemas/WebSearchAction' description: Web search action payload type: object required: - action title: WebSearchCallEvent description: An OpenAI-style web search call event. LoggingMethod: type: string enum: - playground - python_client - typescript_client - api_direct title: LoggingMethod ExtendedRetrieverSpanRecord: properties: type: type: string const: retriever title: Type description: Type of the trace, span or session. default: retriever input: type: string title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: items: $ref: '#/components/schemas/Document-Output' type: array title: Output description: Output of the trace or span. redacted_output: anyOf: - items: $ref: '#/components/schemas/Document-Output' type: array - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: type: string format: uuid4 title: ID description: Galileo ID of the session, trace or span session_id: type: string format: uuid4 title: Session ID description: Galileo ID of the session containing the trace (or the same value as id for a trace) trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) project_id: type: string format: uuid4 title: Project ID description: Galileo ID of the project associated with this trace or span run_id: type: string format: uuid4 title: Run ID description: Galileo ID of the run (log stream or experiment) associated with this trace or span updated_at: anyOf: - type: string format: date-time - type: 'null' title: Last Updated description: Timestamp of the session or trace or span's last update has_children: anyOf: - type: boolean - type: 'null' title: Has Children description: Whether or not this trace or span has child spans metrics_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Batch Id description: Galileo ID of the metrics batch associated with this trace or span session_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Batch Id description: Galileo ID of the metrics batch associated with this trace or span feedback_rating_info: additionalProperties: $ref: '#/components/schemas/FeedbackRatingInfo' type: object title: Feedback Rating Info description: Feedback information related to the record annotations: additionalProperties: additionalProperties: $ref: '#/components/schemas/AnnotationRatingInfo' propertyNames: format: uuid4 type: object propertyNames: format: uuid4 type: object title: Annotations description: Annotations keyed by template ID and annotator ID file_ids: items: type: string format: uuid4 type: array title: File Ids description: IDs of files associated with this record file_modalities: items: $ref: '#/components/schemas/ContentModality' type: array title: File Modalities description: Modalities of files associated with this record annotation_aggregates: additionalProperties: $ref: '#/components/schemas/AnnotationAggregate' propertyNames: format: uuid4 type: object title: Annotation Aggregates description: Annotation aggregate information keyed by template ID annotation_agreement: additionalProperties: type: number propertyNames: format: uuid4 type: object title: Annotation Agreement description: Annotation agreement scores keyed by template ID overall_annotation_agreement: anyOf: - type: number - type: 'null' title: Overall Annotation Agreement description: Average annotation agreement across all templates in the queue annotation_queue_ids: items: type: string format: uuid4 type: array title: Annotation Queue Ids description: IDs of annotation queues this record is in fully_annotated: anyOf: - type: boolean - type: 'null' title: Fully Annotated description: Whether every field is annotated by every annotator in the queue progress_message: type: string title: Progress Message description: Runner progress text written directly to CH span default: '' error_message: type: string title: Error Message description: Runner error text written directly to CH span default: '' metric_info: anyOf: - additionalProperties: oneOf: - $ref: '#/components/schemas/MetricNotComputed' - $ref: '#/components/schemas/MetricPending' - $ref: '#/components/schemas/MetricComputing' - $ref: '#/components/schemas/MetricNotApplicable' - $ref: '#/components/schemas/MetricSuccess' - $ref: '#/components/schemas/MetricError' - $ref: '#/components/schemas/MetricFailed' - $ref: '#/components/schemas/MetricRollUp' discriminator: propertyName: status_type mapping: computing: '#/components/schemas/MetricComputing' error: '#/components/schemas/MetricError' failed: '#/components/schemas/MetricFailed' not_applicable: '#/components/schemas/MetricNotApplicable' not_computed: '#/components/schemas/MetricNotComputed' pending: '#/components/schemas/MetricPending' roll_up: '#/components/schemas/MetricRollUp' success: '#/components/schemas/MetricSuccess' type: object - type: 'null' title: Metric Info description: Detailed information about the metrics associated with this trace or span files: anyOf: - additionalProperties: $ref: '#/components/schemas/FileMetadata' propertyNames: format: uuid4 type: object - type: 'null' title: Files description: File metadata keyed by file ID for files associated with this record parent_id: type: string format: uuid4 title: Parent ID description: Galileo ID of the parent of this span is_complete: type: boolean title: Is Complete description: Whether the parent trace is complete or not default: true step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. type: object required: - id - session_id - project_id - run_id - parent_id title: ExtendedRetrieverSpanRecord FewShotExample: properties: generation_prompt_and_response: type: string title: Generation Prompt And Response evaluating_response: type: string title: Evaluating Response type: object required: - generation_prompt_and_response - evaluating_response title: FewShotExample description: Few-shot example for a chainpoll metric prompt. SessionCreateRequest: properties: log_stream_id: anyOf: - type: string format: uuid4 - type: 'null' title: Log Stream Id description: Log stream id associated with the traces. experiment_id: anyOf: - type: string format: uuid4 - type: 'null' title: Experiment Id description: Experiment id associated with the traces. metrics_testing_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Testing Id description: Metrics testing id associated with the traces. logging_method: $ref: '#/components/schemas/LoggingMethod' default: api_direct client_version: anyOf: - type: string - type: 'null' title: Client Version reliable: type: boolean title: Reliable description: Whether or not to use reliable logging. If set to False, the method will respond immediately before verifying that the traces have been successfully ingested, and no error message will be returned if ingestion fails. If set to True, the method will wait for the traces to be successfully ingested or return an error message if there is an ingestion failure. default: true name: anyOf: - type: string - type: 'null' title: Name description: Name of the session. previous_session_id: anyOf: - type: string format: uuid4 - type: 'null' title: Previous Session Id description: Id of the previous session. external_id: anyOf: - type: string - type: 'null' title: External Id description: External id of the session. user_metadata: anyOf: - additionalProperties: type: string type: object - type: 'null' title: User Metadata description: User metadata for the session. type: object title: SessionCreateRequest libs__python__schemas__log_records__feedback__LikeDislikeRating: properties: feedback_type: type: string const: like_dislike title: Feedback Type default: like_dislike value: type: boolean title: Value type: object required: - value title: LikeDislikeRating MessageEvent: properties: type: type: string const: message title: Type default: message id: anyOf: - type: string - type: 'null' title: Id description: Unique identifier for the event status: anyOf: - $ref: '#/components/schemas/EventStatus' - type: 'null' description: Status of the event metadata: anyOf: - additionalProperties: true type: object - type: 'null' title: Metadata description: Provider-specific metadata and additional fields error_message: anyOf: - type: string - type: 'null' title: Error Message description: Error message if the event failed role: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__MessageRole' description: Role of the message sender content: anyOf: - type: string - type: 'null' title: Content description: Text content of the message content_parts: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Content Parts description: Structured content items (text, audio, images, etc.) type: object required: - role title: MessageEvent description: An output message from the model. ControlSpan: properties: type: type: string const: control title: Type description: Type of the trace, span or session. default: control input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: anyOf: - $ref: '#/components/schemas/ControlResult' - type: 'null' description: Output of the trace or span. redacted_output: anyOf: - $ref: '#/components/schemas/ControlResult' - type: 'null' description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: anyOf: - type: string format: uuid4 - type: 'null' title: ID description: Galileo ID of the session, trace or span session_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session ID description: Galileo ID of the session containing the trace or span or session trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. parent_id: anyOf: - type: string format: uuid4 - type: 'null' title: Parent ID description: Galileo ID of the parent of this span control_id: anyOf: - type: integer - type: 'null' title: Control Id description: Identifier of the control definition that produced this span. agent_name: anyOf: - type: string - type: 'null' title: Agent Name description: Normalized agent name associated with this control execution. check_stage: anyOf: - $ref: '#/components/schemas/ControlCheckStage' - type: 'null' description: Execution stage where the control ran, typically 'pre' or 'post'. applies_to: anyOf: - $ref: '#/components/schemas/ControlAppliesTo' - type: 'null' description: Parent execution type the control applied to, for example 'llm_call' or 'tool_call'. evaluator_name: anyOf: - type: string - type: 'null' title: Evaluator Name description: Representative evaluator name for this control span. For composite controls, this is the primary evaluator chosen for observability identity. selector_path: anyOf: - type: string - type: 'null' title: Selector Path description: Representative selector path for this control span. For composite controls, this is the primary selector path chosen for observability identity. type: object title: ControlSpan LogRecordsAvailableColumnsRequest: properties: log_stream_id: anyOf: - type: string format: uuid4 - type: 'null' title: Log Stream Id description: Log stream id associated with the traces. experiment_id: anyOf: - type: string format: uuid4 - type: 'null' title: Experiment Id description: Experiment id associated with the traces. metrics_testing_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Testing Id description: Metrics testing id associated with the traces. start_time: anyOf: - type: string format: date-time - type: 'null' title: Start Time end_time: anyOf: - type: string format: date-time - type: 'null' title: End Time type: object title: LogRecordsAvailableColumnsRequest examples: - log_stream_id: 00000000-0000-0000-0000-000000000000 LunaOutputTypeEnum: type: string enum: - float - string - string_list - bool_list title: LunaOutputTypeEnum LogRecordsPartialQueryResponse: properties: starting_token: type: integer title: Starting Token default: 0 limit: type: integer title: Limit default: 100 paginated: type: boolean title: Paginated default: false next_starting_token: anyOf: - type: integer - type: 'null' title: Next Starting Token last_row_id: anyOf: - type: string format: uuid4 - type: 'null' title: Last Row Id records: items: oneOf: - $ref: '#/components/schemas/PartialExtendedTraceRecord' - $ref: '#/components/schemas/PartialExtendedAgentSpanRecord' - $ref: '#/components/schemas/PartialExtendedWorkflowSpanRecord' - $ref: '#/components/schemas/PartialExtendedLlmSpanRecord' - $ref: '#/components/schemas/PartialExtendedToolSpanRecord' - $ref: '#/components/schemas/PartialExtendedRetrieverSpanRecord' - $ref: '#/components/schemas/PartialExtendedControlSpanRecord' - $ref: '#/components/schemas/PartialExtendedSessionRecord' discriminator: propertyName: type mapping: agent: '#/components/schemas/PartialExtendedAgentSpanRecord' control: '#/components/schemas/PartialExtendedControlSpanRecord' llm: '#/components/schemas/PartialExtendedLlmSpanRecord' retriever: '#/components/schemas/PartialExtendedRetrieverSpanRecord' session: '#/components/schemas/PartialExtendedSessionRecord' tool: '#/components/schemas/PartialExtendedToolSpanRecord' trace: '#/components/schemas/PartialExtendedTraceRecord' workflow: '#/components/schemas/PartialExtendedWorkflowSpanRecord' type: array title: Records description: records matching the query num_records: type: integer title: Num Records description: number of records readOnly: true type: object required: - num_records title: LogRecordsPartialQueryResponse examples: - next_starting_token: 2 num_rows: 2 paginated: true records: - annotation_aggregates: {} annotation_agreement: {} annotation_queue_ids: [] annotations: {} created_at: '2026-07-18T04:11:24.451518Z' dataset_metadata: {} error_message: '' feedback_rating_info: {} file_ids: [] file_modalities: [] id: 1a0939d1-8b43-4fe3-a91c-196e2d9847e3 input: Who is a smart LLM? is_complete: true metrics: {} name: '' progress_message: '' tags: [] type: trace user_metadata: {} - annotation_aggregates: {} annotation_agreement: {} annotation_queue_ids: [] annotations: {} created_at: '2026-07-18T04:11:24.451639Z' dataset_metadata: {} error_message: '' feedback_rating_info: {} file_ids: [] file_modalities: [] id: 1edc2401-24b4-448c-a392-b36932293061 input: - content: Who is a smart LLM? role: user is_complete: true metrics: {} name: '' output: content: '' role: assistant progress_message: '' tags: [] type: llm user_metadata: {} RecomputeLogRecordsMetricsRequest: properties: starting_token: type: integer title: Starting Token default: 0 limit: type: integer title: Limit default: 100 previous_last_row_id: anyOf: - type: string format: uuid4 - type: 'null' title: Previous Last Row Id log_stream_id: anyOf: - type: string format: uuid4 - type: 'null' title: Log Stream Id description: Log stream id associated with the traces. experiment_id: anyOf: - type: string format: uuid4 - type: 'null' title: Experiment Id description: Experiment id associated with the traces. metrics_testing_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Testing Id description: Metrics testing id associated with the traces. filters: items: oneOf: - $ref: '#/components/schemas/LogRecordsIDFilter' - $ref: '#/components/schemas/LogRecordsDateFilter' - $ref: '#/components/schemas/LogRecordsNumberFilter' - $ref: '#/components/schemas/LogRecordsBooleanFilter' - $ref: '#/components/schemas/LogRecordsCollectionFilter' - $ref: '#/components/schemas/LogRecordsTextFilter' - $ref: '#/components/schemas/LogRecordsFullyAnnotatedFilter' discriminator: propertyName: type mapping: boolean: '#/components/schemas/LogRecordsBooleanFilter' collection: '#/components/schemas/LogRecordsCollectionFilter' date: '#/components/schemas/LogRecordsDateFilter' fully_annotated: '#/components/schemas/LogRecordsFullyAnnotatedFilter' id: '#/components/schemas/LogRecordsIDFilter' number: '#/components/schemas/LogRecordsNumberFilter' text: '#/components/schemas/LogRecordsTextFilter' type: array title: Filters filter_tree: anyOf: - $ref: '#/components/schemas/FilterExpression_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____-Input' - type: 'null' sort: anyOf: - $ref: '#/components/schemas/LogRecordsSortClause' - type: 'null' description: Sort for the query. Defaults to native sort (created_at, id descending). truncate_fields: type: boolean title: Truncate Fields default: false include_counts: type: boolean title: Include Counts description: If True, include computed child counts (e.g., num_traces for sessions, num_spans for traces). default: false include_code_metric_metadata: type: boolean title: Include Code Metric Metadata description: If True, include per-row scorer metadata (the dict returned alongside the score by code-based scorers via the (score, metadata) tuple-return contract) on each MetricSuccess in the response. Off by default to keep payloads small for callers that don't need it. default: false scorer_ids: items: type: string format: uuid4 type: array title: Scorer Ids description: List of scorer IDs for which metrics should be recomputed. type: object required: - scorer_ids title: RecomputeLogRecordsMetricsRequest description: 'Request to recompute metrics for a genai project run (log stream or experiment). This request is used to trigger recomputation of metrics based on the provided filters and scorer IDs.' examples: - filters: - case_sensitive: true name: input operator: eq type: text value: example input log_stream_id: 00000000-0000-0000-0000-000000000000 pagination: limit: 5 starting_token: 0 sort: ascending: false name: updated_at sort_type: column - filter_tree: and: - or: - filter: name: input operator: contains type: text value: abx - filter: name: output operator: contains type: text value: xyz - filter: name: session_id operator: eq type: id value: 123e4567-e89b-42d3-a456-426614174000 log_stream_id: 00000000-0000-0000-0000-000000000000 pagination: limit: 5 starting_token: 0 sort: ascending: false name: updated_at sort_type: column AgentSpan: properties: type: type: string const: agent title: Type description: Type of the trace, span or session. default: agent input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Input' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Output description: Output of the trace or span. redacted_output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Input' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: anyOf: - type: string format: uuid4 - type: 'null' title: ID description: Galileo ID of the session, trace or span session_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session ID description: Galileo ID of the session containing the trace or span or session trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. parent_id: anyOf: - type: string format: uuid4 - type: 'null' title: Parent ID description: Galileo ID of the parent of this span spans: items: oneOf: - $ref: '#/components/schemas/AgentSpan' - $ref: '#/components/schemas/WorkflowSpan' - $ref: '#/components/schemas/LlmSpan' - $ref: '#/components/schemas/RetrieverSpan' - $ref: '#/components/schemas/ToolSpan' - $ref: '#/components/schemas/ControlSpan' discriminator: propertyName: type mapping: agent: '#/components/schemas/AgentSpan' control: '#/components/schemas/ControlSpan' llm: '#/components/schemas/LlmSpan' retriever: '#/components/schemas/RetrieverSpan' tool: '#/components/schemas/ToolSpan' workflow: '#/components/schemas/WorkflowSpan' type: array title: Spans description: Child spans. agent_type: $ref: '#/components/schemas/AgentType' description: Agent type. default: default type: object title: AgentSpan libs__python__schemas__log_records__feedback__StarRating: properties: feedback_type: type: string const: star title: Feedback Type default: star value: type: integer maximum: 5.0 minimum: 1.0 title: Value type: object required: - value title: StarRating ToolCallFunction: properties: name: type: string title: Name arguments: type: string title: Arguments type: object required: - name - arguments title: ToolCallFunction RootType: type: string enum: - session - trace - span title: RootType description: 'The root-level type of a logged step hierarchy. Maps fine-grained StepType values to the three top-level categories used throughout the platform: session, trace, and span.' galileo_core__schemas__shared__scorers__scorer_name__ScorerName: type: string enum: - action_completion_luna - action_advancement_luna - agentic_session_success - agentic_session_success - action_completion_vision - action_completion_audio - agentic_workflow_success - agentic_workflow_success - agent_efficiency - agent_flow - chunk_attribution_utilization_luna - chunk_attribution_utilization - chunk_relevance - chunk_relevance_luna - context_precision - precision_at_k - completeness_luna - completeness - context_adherence - context_adherence_luna - context_adherence_vision - context_adherence_audio - context_relevance - context_relevance_luna - conversation_quality - correctness - correctness_vision - correctness_audio - ground_truth_adherence - ground_truth_adherence_vision - ground_truth_adherence_audio - visual_fidelity - visual_quality - input_pii - input_pii_gpt - input_sexist - input_sexist - input_sexist_luna - input_sexist_luna - input_tone - input_tone_gpt - input_toxicity - input_toxicity_luna - input_toxicity_vision - input_toxicity_audio - instruction_adherence - output_pii - output_pii_gpt - output_sexist - output_sexist - output_sexist_luna - output_sexist_luna - output_tone - output_tone_gpt - output_toxicity - output_toxicity_luna - output_toxicity_vision - output_toxicity_audio - prompt_injection - prompt_injection_luna - reasoning_coherence - reasoning_coherence_vision - reasoning_coherence_audio - sql_efficiency - sql_adherence - sql_injection - sql_correctness - tool_error_rate - tool_error_rate_luna - tool_selection_quality - tool_selection_quality_luna - user_intent_change - user_intent_change_vision - user_intent_change_audio - interruption_detection title: ScorerName WebSearchAction: properties: type: type: string const: search title: Type description: Type of web search action query: anyOf: - type: string - type: 'null' title: Query description: Search query string sources: anyOf: - {} - type: 'null' title: Sources description: Optional provider-specific sources type: object required: - type title: WebSearchAction description: Action payload for a web search call event. FileStatus: type: string enum: - complete - failed - pending - not_uploaded title: FileStatus description: Processing status of the file. LogRecordsFilterType: type: string enum: - id - date - number - boolean - text - collection - fully_annotated title: LogRecordsFilterType ControlAppliesTo: type: string enum: - llm_call - tool_call title: ControlAppliesTo HallucinationSegment: properties: hallucination_severity: type: integer maximum: 2.0 minimum: 0.0 title: Hallucination Severity default: 0 start: type: integer title: Start end: type: integer title: End hallucination: type: number title: Hallucination type: object required: - start - end - hallucination title: HallucinationSegment InsightType: type: string enum: - vertical_bar - horizontal_bar title: InsightType MetadataFilter: properties: name: type: string const: metadata title: Name default: metadata operator: type: string enum: - one_of - not_in - eq - ne title: Operator key: type: string title: Key value: anyOf: - type: string - items: type: string type: array title: Value type: object required: - operator - key - value title: MetadataFilter description: Filters on metadata key-value pairs in scorer jobs. ControlCheckStage: type: string enum: - pre - post title: ControlCheckStage libs__python__schemas__log_records__feedback__TagsRating: properties: feedback_type: type: string const: tags title: Feedback Type default: tags value: items: type: string maxLength: 255 minLength: 1 type: array title: Value type: object required: - value title: TagsRating LogRecordsMetricsQueryRequest: properties: log_stream_id: anyOf: - type: string format: uuid4 - type: 'null' title: Log Stream Id description: Log stream id associated with the traces. experiment_id: anyOf: - type: string format: uuid4 - type: 'null' title: Experiment Id description: Experiment id associated with the traces. metrics_testing_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Testing Id description: Metrics testing id associated with the traces. filters: items: oneOf: - $ref: '#/components/schemas/LogRecordsIDFilter' - $ref: '#/components/schemas/LogRecordsDateFilter' - $ref: '#/components/schemas/LogRecordsNumberFilter' - $ref: '#/components/schemas/LogRecordsBooleanFilter' - $ref: '#/components/schemas/LogRecordsCollectionFilter' - $ref: '#/components/schemas/LogRecordsTextFilter' - $ref: '#/components/schemas/LogRecordsFullyAnnotatedFilter' discriminator: propertyName: type mapping: boolean: '#/components/schemas/LogRecordsBooleanFilter' collection: '#/components/schemas/LogRecordsCollectionFilter' date: '#/components/schemas/LogRecordsDateFilter' fully_annotated: '#/components/schemas/LogRecordsFullyAnnotatedFilter' id: '#/components/schemas/LogRecordsIDFilter' number: '#/components/schemas/LogRecordsNumberFilter' text: '#/components/schemas/LogRecordsTextFilter' type: array title: Filters start_time: type: string format: date-time title: Start Time description: Include traces from this time onward. end_time: type: string format: date-time title: End Time description: Include traces up to this time. interval: type: integer title: Interval default: 5 group_by: anyOf: - type: string - type: 'null' title: Group By type: object required: - start_time - end_time title: LogRecordsMetricsQueryRequest examples: - end_time: '2023-10-01T01:00:00Z' filters: - case_sensitive: true name: input operator: eq type: text value: example input group_by: model interval: 5 log_stream_id: 00000000-0000-0000-0000-000000000000 start_time: '2023-10-01T00:00:00Z' ExtendedTraceRecord: properties: type: type: string const: trace title: Type description: Type of the trace, span or session. default: trace input: anyOf: - type: string - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: anyOf: - type: string - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Output description: Output of the trace or span. redacted_output: anyOf: - type: string - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: type: string format: uuid4 title: ID description: Galileo ID of the trace session_id: type: string format: uuid4 title: Session ID description: Galileo ID of the session containing the trace (or the same value as id for a trace) trace_id: type: string format: uuid4 title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) project_id: type: string format: uuid4 title: Project ID description: Galileo ID of the project associated with this trace or span run_id: type: string format: uuid4 title: Run ID description: Galileo ID of the run (log stream or experiment) associated with this trace or span updated_at: anyOf: - type: string format: date-time - type: 'null' title: Last Updated description: Timestamp of the session or trace or span's last update has_children: anyOf: - type: boolean - type: 'null' title: Has Children description: Whether or not this trace or span has child spans metrics_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Batch Id description: Galileo ID of the metrics batch associated with this trace or span session_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Batch Id description: Galileo ID of the metrics batch associated with this trace or span feedback_rating_info: additionalProperties: $ref: '#/components/schemas/FeedbackRatingInfo' type: object title: Feedback Rating Info description: Feedback information related to the record annotations: additionalProperties: additionalProperties: $ref: '#/components/schemas/AnnotationRatingInfo' propertyNames: format: uuid4 type: object propertyNames: format: uuid4 type: object title: Annotations description: Annotations keyed by template ID and annotator ID file_ids: items: type: string format: uuid4 type: array title: File Ids description: IDs of files associated with this record file_modalities: items: $ref: '#/components/schemas/ContentModality' type: array title: File Modalities description: Modalities of files associated with this record annotation_aggregates: additionalProperties: $ref: '#/components/schemas/AnnotationAggregate' propertyNames: format: uuid4 type: object title: Annotation Aggregates description: Annotation aggregate information keyed by template ID annotation_agreement: additionalProperties: type: number propertyNames: format: uuid4 type: object title: Annotation Agreement description: Annotation agreement scores keyed by template ID overall_annotation_agreement: anyOf: - type: number - type: 'null' title: Overall Annotation Agreement description: Average annotation agreement across all templates in the queue annotation_queue_ids: items: type: string format: uuid4 type: array title: Annotation Queue Ids description: IDs of annotation queues this record is in fully_annotated: anyOf: - type: boolean - type: 'null' title: Fully Annotated description: Whether every field is annotated by every annotator in the queue progress_message: type: string title: Progress Message description: Runner progress text written directly to CH span default: '' error_message: type: string title: Error Message description: Runner error text written directly to CH span default: '' metric_info: anyOf: - additionalProperties: oneOf: - $ref: '#/components/schemas/MetricNotComputed' - $ref: '#/components/schemas/MetricPending' - $ref: '#/components/schemas/MetricComputing' - $ref: '#/components/schemas/MetricNotApplicable' - $ref: '#/components/schemas/MetricSuccess' - $ref: '#/components/schemas/MetricError' - $ref: '#/components/schemas/MetricFailed' - $ref: '#/components/schemas/MetricRollUp' discriminator: propertyName: status_type mapping: computing: '#/components/schemas/MetricComputing' error: '#/components/schemas/MetricError' failed: '#/components/schemas/MetricFailed' not_applicable: '#/components/schemas/MetricNotApplicable' not_computed: '#/components/schemas/MetricNotComputed' pending: '#/components/schemas/MetricPending' roll_up: '#/components/schemas/MetricRollUp' success: '#/components/schemas/MetricSuccess' type: object - type: 'null' title: Metric Info description: Detailed information about the metrics associated with this trace or span files: anyOf: - additionalProperties: $ref: '#/components/schemas/FileMetadata' propertyNames: format: uuid4 type: object - type: 'null' title: Files description: File metadata keyed by file ID for files associated with this record is_complete: type: boolean title: Is Complete description: Whether the trace is complete or not default: true num_spans: anyOf: - type: integer - type: 'null' title: Num Spans type: object required: - id - session_id - trace_id - project_id - run_id title: ExtendedTraceRecord galileo_core__schemas__logging__llm__Message: properties: content: anyOf: - type: string - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array title: Content role: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__MessageRole' tool_call_id: anyOf: - type: string - type: 'null' title: Tool Call Id tool_calls: anyOf: - items: $ref: '#/components/schemas/ToolCall' type: array - type: 'null' title: Tool Calls type: object required: - content - role title: Message ExtendedSessionRecordWithChildren: properties: traces: items: $ref: '#/components/schemas/ExtendedTraceRecordWithChildren' type: array title: Traces type: type: string const: session title: Type description: Type of the trace, span or session. default: session input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array title: Input default: '' redacted_input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Output' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Output description: Output of the trace or span. redacted_output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Output' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: type: string format: uuid4 title: ID description: Galileo ID of the session session_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session ID description: Galileo ID of the session containing the trace or span or session trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) project_id: type: string format: uuid4 title: Project ID description: Galileo ID of the project associated with this trace or span run_id: type: string format: uuid4 title: Run ID description: Galileo ID of the run (log stream or experiment) associated with this trace or span updated_at: anyOf: - type: string format: date-time - type: 'null' title: Last Updated description: Timestamp of the session or trace or span's last update has_children: anyOf: - type: boolean - type: 'null' title: Has Children description: Whether or not this trace or span has child spans metrics_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Batch Id description: Galileo ID of the metrics batch associated with this trace or span session_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Batch Id description: Galileo ID of the metrics batch associated with this trace or span feedback_rating_info: additionalProperties: $ref: '#/components/schemas/FeedbackRatingInfo' type: object title: Feedback Rating Info description: Feedback information related to the record annotations: additionalProperties: additionalProperties: $ref: '#/components/schemas/AnnotationRatingInfo' propertyNames: format: uuid4 type: object propertyNames: format: uuid4 type: object title: Annotations description: Annotations keyed by template ID and annotator ID file_ids: items: type: string format: uuid4 type: array title: File Ids description: IDs of files associated with this record file_modalities: items: $ref: '#/components/schemas/ContentModality' type: array title: File Modalities description: Modalities of files associated with this record annotation_aggregates: additionalProperties: $ref: '#/components/schemas/AnnotationAggregate' propertyNames: format: uuid4 type: object title: Annotation Aggregates description: Annotation aggregate information keyed by template ID annotation_agreement: additionalProperties: type: number propertyNames: format: uuid4 type: object title: Annotation Agreement description: Annotation agreement scores keyed by template ID overall_annotation_agreement: anyOf: - type: number - type: 'null' title: Overall Annotation Agreement description: Average annotation agreement across all templates in the queue annotation_queue_ids: items: type: string format: uuid4 type: array title: Annotation Queue Ids description: IDs of annotation queues this record is in fully_annotated: anyOf: - type: boolean - type: 'null' title: Fully Annotated description: Whether every field is annotated by every annotator in the queue progress_message: type: string title: Progress Message description: Runner progress text written directly to CH span default: '' error_message: type: string title: Error Message description: Runner error text written directly to CH span default: '' metric_info: anyOf: - additionalProperties: oneOf: - $ref: '#/components/schemas/MetricNotComputed' - $ref: '#/components/schemas/MetricPending' - $ref: '#/components/schemas/MetricComputing' - $ref: '#/components/schemas/MetricNotApplicable' - $ref: '#/components/schemas/MetricSuccess' - $ref: '#/components/schemas/MetricError' - $ref: '#/components/schemas/MetricFailed' - $ref: '#/components/schemas/MetricRollUp' discriminator: propertyName: status_type mapping: computing: '#/components/schemas/MetricComputing' error: '#/components/schemas/MetricError' failed: '#/components/schemas/MetricFailed' not_applicable: '#/components/schemas/MetricNotApplicable' not_computed: '#/components/schemas/MetricNotComputed' pending: '#/components/schemas/MetricPending' roll_up: '#/components/schemas/MetricRollUp' success: '#/components/schemas/MetricSuccess' type: object - type: 'null' title: Metric Info description: Detailed information about the metrics associated with this trace or span files: anyOf: - additionalProperties: $ref: '#/components/schemas/FileMetadata' propertyNames: format: uuid4 type: object - type: 'null' title: Files description: File metadata keyed by file ID for files associated with this record previous_session_id: anyOf: - type: string format: uuid4 - type: 'null' title: Previous Session Id num_traces: anyOf: - type: integer - type: 'null' title: Num Traces type: object required: - id - project_id - run_id title: ExtendedSessionRecordWithChildren TextContentPart: properties: type: type: string const: text title: Type default: text text: type: string title: Text type: object required: - text title: TextContentPart description: A text segment within a message. HistogramStrategy: type: string enum: - fixed - trimmed - quantile title: HistogramStrategy Metrics: properties: duration_ns: anyOf: - type: integer - type: 'null' title: Duration Ns description: Duration of the trace or span in nanoseconds. Displayed as 'Latency' in Galileo. additionalProperties: true type: object title: Metrics ScoreBucket: properties: min_inclusive: type: integer title: Min Inclusive max_exclusive: anyOf: - type: integer - type: 'null' title: Max Exclusive count: type: integer title: Count type: object required: - min_inclusive - max_exclusive - count title: ScoreBucket AnnotationChoiceAggregate: properties: annotation_type: type: string const: choice title: Annotation Type default: choice counts: additionalProperties: type: integer type: object title: Counts unrated_count: type: integer title: Unrated Count type: object required: - counts - unrated_count title: AnnotationChoiceAggregate ExtendedToolSpanRecordWithChildren: properties: spans: items: oneOf: - $ref: '#/components/schemas/ExtendedAgentSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedWorkflowSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedLlmSpanRecord' - $ref: '#/components/schemas/ExtendedToolSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedRetrieverSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedControlSpanRecord' discriminator: propertyName: type mapping: agent: '#/components/schemas/ExtendedAgentSpanRecordWithChildren' control: '#/components/schemas/ExtendedControlSpanRecord' llm: '#/components/schemas/ExtendedLlmSpanRecord' retriever: '#/components/schemas/ExtendedRetrieverSpanRecordWithChildren' tool: '#/components/schemas/ExtendedToolSpanRecordWithChildren' workflow: '#/components/schemas/ExtendedWorkflowSpanRecordWithChildren' type: array title: Spans type: type: string const: tool title: Type description: Type of the trace, span or session. default: tool input: type: string title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: anyOf: - type: string - type: 'null' title: Output description: Output of the trace or span. redacted_output: anyOf: - type: string - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: type: string format: uuid4 title: ID description: Galileo ID of the session, trace or span session_id: type: string format: uuid4 title: Session ID description: Galileo ID of the session containing the trace (or the same value as id for a trace) trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) project_id: type: string format: uuid4 title: Project ID description: Galileo ID of the project associated with this trace or span run_id: type: string format: uuid4 title: Run ID description: Galileo ID of the run (log stream or experiment) associated with this trace or span updated_at: anyOf: - type: string format: date-time - type: 'null' title: Last Updated description: Timestamp of the session or trace or span's last update has_children: anyOf: - type: boolean - type: 'null' title: Has Children description: Whether or not this trace or span has child spans metrics_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Batch Id description: Galileo ID of the metrics batch associated with this trace or span session_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Batch Id description: Galileo ID of the metrics batch associated with this trace or span feedback_rating_info: additionalProperties: $ref: '#/components/schemas/FeedbackRatingInfo' type: object title: Feedback Rating Info description: Feedback information related to the record annotations: additionalProperties: additionalProperties: $ref: '#/components/schemas/AnnotationRatingInfo' propertyNames: format: uuid4 type: object propertyNames: format: uuid4 type: object title: Annotations description: Annotations keyed by template ID and annotator ID file_ids: items: type: string format: uuid4 type: array title: File Ids description: IDs of files associated with this record file_modalities: items: $ref: '#/components/schemas/ContentModality' type: array title: File Modalities description: Modalities of files associated with this record annotation_aggregates: additionalProperties: $ref: '#/components/schemas/AnnotationAggregate' propertyNames: format: uuid4 type: object title: Annotation Aggregates description: Annotation aggregate information keyed by template ID annotation_agreement: additionalProperties: type: number propertyNames: format: uuid4 type: object title: Annotation Agreement description: Annotation agreement scores keyed by template ID overall_annotation_agreement: anyOf: - type: number - type: 'null' title: Overall Annotation Agreement description: Average annotation agreement across all templates in the queue annotation_queue_ids: items: type: string format: uuid4 type: array title: Annotation Queue Ids description: IDs of annotation queues this record is in fully_annotated: anyOf: - type: boolean - type: 'null' title: Fully Annotated description: Whether every field is annotated by every annotator in the queue progress_message: type: string title: Progress Message description: Runner progress text written directly to CH span default: '' error_message: type: string title: Error Message description: Runner error text written directly to CH span default: '' metric_info: anyOf: - additionalProperties: oneOf: - $ref: '#/components/schemas/MetricNotComputed' - $ref: '#/components/schemas/MetricPending' - $ref: '#/components/schemas/MetricComputing' - $ref: '#/components/schemas/MetricNotApplicable' - $ref: '#/components/schemas/MetricSuccess' - $ref: '#/components/schemas/MetricError' - $ref: '#/components/schemas/MetricFailed' - $ref: '#/components/schemas/MetricRollUp' discriminator: propertyName: status_type mapping: computing: '#/components/schemas/MetricComputing' error: '#/components/schemas/MetricError' failed: '#/components/schemas/MetricFailed' not_applicable: '#/components/schemas/MetricNotApplicable' not_computed: '#/components/schemas/MetricNotComputed' pending: '#/components/schemas/MetricPending' roll_up: '#/components/schemas/MetricRollUp' success: '#/components/schemas/MetricSuccess' type: object - type: 'null' title: Metric Info description: Detailed information about the metrics associated with this trace or span files: anyOf: - additionalProperties: $ref: '#/components/schemas/FileMetadata' propertyNames: format: uuid4 type: object - type: 'null' title: Files description: File metadata keyed by file ID for files associated with this record parent_id: type: string format: uuid4 title: Parent ID description: Galileo ID of the parent of this span is_complete: type: boolean title: Is Complete description: Whether the parent trace is complete or not default: true step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. tool_call_id: anyOf: - type: string - type: 'null' title: Tool Call Id description: ID of the tool call. type: object required: - id - session_id - project_id - run_id - parent_id title: ExtendedToolSpanRecordWithChildren galileo_core__schemas__logging__llm__MessageRole: type: string enum: - agent - assistant - developer - function - system - tool - user title: MessageRole ScorerTypes: type: string enum: - llm - code - luna - preset title: ScorerTypes ExtendedWorkflowSpanRecordWithChildren: properties: spans: items: oneOf: - $ref: '#/components/schemas/ExtendedAgentSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedWorkflowSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedLlmSpanRecord' - $ref: '#/components/schemas/ExtendedToolSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedRetrieverSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedControlSpanRecord' discriminator: propertyName: type mapping: agent: '#/components/schemas/ExtendedAgentSpanRecordWithChildren' control: '#/components/schemas/ExtendedControlSpanRecord' llm: '#/components/schemas/ExtendedLlmSpanRecord' retriever: '#/components/schemas/ExtendedRetrieverSpanRecordWithChildren' tool: '#/components/schemas/ExtendedToolSpanRecordWithChildren' workflow: '#/components/schemas/ExtendedWorkflowSpanRecordWithChildren' type: array title: Spans type: type: string const: workflow title: Type description: Type of the trace, span or session. default: workflow input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Output' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Output description: Output of the trace or span. redacted_output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Output' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: type: string format: uuid4 title: ID description: Galileo ID of the session, trace or span session_id: type: string format: uuid4 title: Session ID description: Galileo ID of the session containing the trace (or the same value as id for a trace) trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) project_id: type: string format: uuid4 title: Project ID description: Galileo ID of the project associated with this trace or span run_id: type: string format: uuid4 title: Run ID description: Galileo ID of the run (log stream or experiment) associated with this trace or span updated_at: anyOf: - type: string format: date-time - type: 'null' title: Last Updated description: Timestamp of the session or trace or span's last update has_children: anyOf: - type: boolean - type: 'null' title: Has Children description: Whether or not this trace or span has child spans metrics_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Batch Id description: Galileo ID of the metrics batch associated with this trace or span session_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Batch Id description: Galileo ID of the metrics batch associated with this trace or span feedback_rating_info: additionalProperties: $ref: '#/components/schemas/FeedbackRatingInfo' type: object title: Feedback Rating Info description: Feedback information related to the record annotations: additionalProperties: additionalProperties: $ref: '#/components/schemas/AnnotationRatingInfo' propertyNames: format: uuid4 type: object propertyNames: format: uuid4 type: object title: Annotations description: Annotations keyed by template ID and annotator ID file_ids: items: type: string format: uuid4 type: array title: File Ids description: IDs of files associated with this record file_modalities: items: $ref: '#/components/schemas/ContentModality' type: array title: File Modalities description: Modalities of files associated with this record annotation_aggregates: additionalProperties: $ref: '#/components/schemas/AnnotationAggregate' propertyNames: format: uuid4 type: object title: Annotation Aggregates description: Annotation aggregate information keyed by template ID annotation_agreement: additionalProperties: type: number propertyNames: format: uuid4 type: object title: Annotation Agreement description: Annotation agreement scores keyed by template ID overall_annotation_agreement: anyOf: - type: number - type: 'null' title: Overall Annotation Agreement description: Average annotation agreement across all templates in the queue annotation_queue_ids: items: type: string format: uuid4 type: array title: Annotation Queue Ids description: IDs of annotation queues this record is in fully_annotated: anyOf: - type: boolean - type: 'null' title: Fully Annotated description: Whether every field is annotated by every annotator in the queue progress_message: type: string title: Progress Message description: Runner progress text written directly to CH span default: '' error_message: type: string title: Error Message description: Runner error text written directly to CH span default: '' metric_info: anyOf: - additionalProperties: oneOf: - $ref: '#/components/schemas/MetricNotComputed' - $ref: '#/components/schemas/MetricPending' - $ref: '#/components/schemas/MetricComputing' - $ref: '#/components/schemas/MetricNotApplicable' - $ref: '#/components/schemas/MetricSuccess' - $ref: '#/components/schemas/MetricError' - $ref: '#/components/schemas/MetricFailed' - $ref: '#/components/schemas/MetricRollUp' discriminator: propertyName: status_type mapping: computing: '#/components/schemas/MetricComputing' error: '#/components/schemas/MetricError' failed: '#/components/schemas/MetricFailed' not_applicable: '#/components/schemas/MetricNotApplicable' not_computed: '#/components/schemas/MetricNotComputed' pending: '#/components/schemas/MetricPending' roll_up: '#/components/schemas/MetricRollUp' success: '#/components/schemas/MetricSuccess' type: object - type: 'null' title: Metric Info description: Detailed information about the metrics associated with this trace or span files: anyOf: - additionalProperties: $ref: '#/components/schemas/FileMetadata' propertyNames: format: uuid4 type: object - type: 'null' title: Files description: File metadata keyed by file ID for files associated with this record parent_id: type: string format: uuid4 title: Parent ID description: Galileo ID of the parent of this span is_complete: type: boolean title: Is Complete description: Whether the parent trace is complete or not default: true step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. type: object required: - id - session_id - project_id - run_id - parent_id title: ExtendedWorkflowSpanRecordWithChildren LogTraceUpdateRequest: properties: log_stream_id: anyOf: - type: string format: uuid4 - type: 'null' title: Log Stream Id description: Log stream id associated with the traces. experiment_id: anyOf: - type: string format: uuid4 - type: 'null' title: Experiment Id description: Experiment id associated with the traces. metrics_testing_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Testing Id description: Metrics testing id associated with the traces. logging_method: $ref: '#/components/schemas/LoggingMethod' default: api_direct client_version: anyOf: - type: string - type: 'null' title: Client Version reliable: type: boolean title: Reliable description: Whether or not to use reliable logging. If set to False, the method will respond immediately before verifying that the traces have been successfully ingested, and no error message will be returned if ingestion fails. If set to True, the method will wait for the traces to be successfully ingested or return an error message if there is an ingestion failure. default: true trace_id: type: string format: uuid4 title: Trace Id description: Trace id to update. input: anyOf: - type: string - type: 'null' title: Input description: Input of the trace. Overwrites previous value if present. output: anyOf: - type: string - type: 'null' title: Output description: Output of the trace. Overwrites previous value if present. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace. Overwrites previous value if present. tags: anyOf: - items: type: string type: array - type: 'null' title: Tags description: Tags to add to the trace. is_complete: anyOf: - type: boolean - type: 'null' title: Is Complete description: Whether or not the records in this request are complete. default: false duration_ns: anyOf: - type: integer - type: 'null' title: Duration Ns description: Duration in nanoseconds. Overwrites previous value if present. type: object required: - trace_id title: LogTraceUpdateRequest description: Request model for updating a trace. AggregatedTraceViewRequest: properties: log_stream_id: type: string format: uuid4 title: Log Stream Id description: Log stream id associated with the traces. filters: items: oneOf: - $ref: '#/components/schemas/LogRecordsIDFilter' - $ref: '#/components/schemas/LogRecordsDateFilter' - $ref: '#/components/schemas/LogRecordsNumberFilter' - $ref: '#/components/schemas/LogRecordsBooleanFilter' - $ref: '#/components/schemas/LogRecordsCollectionFilter' - $ref: '#/components/schemas/LogRecordsTextFilter' - $ref: '#/components/schemas/LogRecordsFullyAnnotatedFilter' discriminator: propertyName: type mapping: boolean: '#/components/schemas/LogRecordsBooleanFilter' collection: '#/components/schemas/LogRecordsCollectionFilter' date: '#/components/schemas/LogRecordsDateFilter' fully_annotated: '#/components/schemas/LogRecordsFullyAnnotatedFilter' id: '#/components/schemas/LogRecordsIDFilter' number: '#/components/schemas/LogRecordsNumberFilter' text: '#/components/schemas/LogRecordsTextFilter' type: array title: Filters description: 'Filters to apply on the traces. Note: Only trace-level filters are supported.' type: object required: - log_stream_id title: AggregatedTraceViewRequest MetricNotComputed: properties: status_type: type: string const: not_computed title: Status Type default: not_computed scorer_type: anyOf: - $ref: '#/components/schemas/ScorerType' - type: 'null' metric_key_alias: anyOf: - type: string - type: 'null' title: Metric Key Alias message: type: string title: Message default: Metric not computed. type: object title: MetricNotComputed FeedbackRatingInfo: properties: feedback_type: $ref: '#/components/schemas/FeedbackType' value: anyOf: - type: boolean - type: integer - type: string - items: type: string maxLength: 255 minLength: 1 type: array title: Value explanation: anyOf: - type: string - type: 'null' title: Explanation type: object required: - feedback_type - value - explanation title: FeedbackRatingInfo TagsAggregate: properties: feedback_type: type: string const: tags title: Feedback Type default: tags counts: additionalProperties: type: integer type: object title: Counts unrated_count: type: integer title: Unrated Count type: object required: - counts - unrated_count title: TagsAggregate LogRecordsDeleteRequest: properties: log_stream_id: anyOf: - type: string format: uuid4 - type: 'null' title: Log Stream Id description: Log stream id associated with the traces. experiment_id: anyOf: - type: string format: uuid4 - type: 'null' title: Experiment Id description: Experiment id associated with the traces. metrics_testing_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Testing Id description: Metrics testing id associated with the traces. filters: items: oneOf: - $ref: '#/components/schemas/LogRecordsIDFilter' - $ref: '#/components/schemas/LogRecordsDateFilter' - $ref: '#/components/schemas/LogRecordsNumberFilter' - $ref: '#/components/schemas/LogRecordsBooleanFilter' - $ref: '#/components/schemas/LogRecordsCollectionFilter' - $ref: '#/components/schemas/LogRecordsTextFilter' - $ref: '#/components/schemas/LogRecordsFullyAnnotatedFilter' discriminator: propertyName: type mapping: boolean: '#/components/schemas/LogRecordsBooleanFilter' collection: '#/components/schemas/LogRecordsCollectionFilter' date: '#/components/schemas/LogRecordsDateFilter' fully_annotated: '#/components/schemas/LogRecordsFullyAnnotatedFilter' id: '#/components/schemas/LogRecordsIDFilter' number: '#/components/schemas/LogRecordsNumberFilter' text: '#/components/schemas/LogRecordsTextFilter' type: array title: Filters filter_tree: anyOf: - $ref: '#/components/schemas/FilterExpression_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____-Input' - type: 'null' type: object title: LogRecordsDeleteRequest example: filters: - case_sensitive: true name: input operator: eq type: text value: example input log_stream_id: 74aec44e-ec21-4c9f-a3e2-b2ab2b81b4db ExtendedSessionRecord: properties: type: type: string const: session title: Type description: Type of the trace, span or session. default: session input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array title: Input default: '' redacted_input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Output' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Output description: Output of the trace or span. redacted_output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Output' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: type: string format: uuid4 title: ID description: Galileo ID of the session session_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session ID description: Galileo ID of the session containing the trace or span or session trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) project_id: type: string format: uuid4 title: Project ID description: Galileo ID of the project associated with this trace or span run_id: type: string format: uuid4 title: Run ID description: Galileo ID of the run (log stream or experiment) associated with this trace or span updated_at: anyOf: - type: string format: date-time - type: 'null' title: Last Updated description: Timestamp of the session or trace or span's last update has_children: anyOf: - type: boolean - type: 'null' title: Has Children description: Whether or not this trace or span has child spans metrics_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Batch Id description: Galileo ID of the metrics batch associated with this trace or span session_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Batch Id description: Galileo ID of the metrics batch associated with this trace or span feedback_rating_info: additionalProperties: $ref: '#/components/schemas/FeedbackRatingInfo' type: object title: Feedback Rating Info description: Feedback information related to the record annotations: additionalProperties: additionalProperties: $ref: '#/components/schemas/AnnotationRatingInfo' propertyNames: format: uuid4 type: object propertyNames: format: uuid4 type: object title: Annotations description: Annotations keyed by template ID and annotator ID file_ids: items: type: string format: uuid4 type: array title: File Ids description: IDs of files associated with this record file_modalities: items: $ref: '#/components/schemas/ContentModality' type: array title: File Modalities description: Modalities of files associated with this record annotation_aggregates: additionalProperties: $ref: '#/components/schemas/AnnotationAggregate' propertyNames: format: uuid4 type: object title: Annotation Aggregates description: Annotation aggregate information keyed by template ID annotation_agreement: additionalProperties: type: number propertyNames: format: uuid4 type: object title: Annotation Agreement description: Annotation agreement scores keyed by template ID overall_annotation_agreement: anyOf: - type: number - type: 'null' title: Overall Annotation Agreement description: Average annotation agreement across all templates in the queue annotation_queue_ids: items: type: string format: uuid4 type: array title: Annotation Queue Ids description: IDs of annotation queues this record is in fully_annotated: anyOf: - type: boolean - type: 'null' title: Fully Annotated description: Whether every field is annotated by every annotator in the queue progress_message: type: string title: Progress Message description: Runner progress text written directly to CH span default: '' error_message: type: string title: Error Message description: Runner error text written directly to CH span default: '' metric_info: anyOf: - additionalProperties: oneOf: - $ref: '#/components/schemas/MetricNotComputed' - $ref: '#/components/schemas/MetricPending' - $ref: '#/components/schemas/MetricComputing' - $ref: '#/components/schemas/MetricNotApplicable' - $ref: '#/components/schemas/MetricSuccess' - $ref: '#/components/schemas/MetricError' - $ref: '#/components/schemas/MetricFailed' - $ref: '#/components/schemas/MetricRollUp' discriminator: propertyName: status_type mapping: computing: '#/components/schemas/MetricComputing' error: '#/components/schemas/MetricError' failed: '#/components/schemas/MetricFailed' not_applicable: '#/components/schemas/MetricNotApplicable' not_computed: '#/components/schemas/MetricNotComputed' pending: '#/components/schemas/MetricPending' roll_up: '#/components/schemas/MetricRollUp' success: '#/components/schemas/MetricSuccess' type: object - type: 'null' title: Metric Info description: Detailed information about the metrics associated with this trace or span files: anyOf: - additionalProperties: $ref: '#/components/schemas/FileMetadata' propertyNames: format: uuid4 type: object - type: 'null' title: Files description: File metadata keyed by file ID for files associated with this record previous_session_id: anyOf: - type: string format: uuid4 - type: 'null' title: Previous Session Id num_traces: anyOf: - type: integer - type: 'null' title: Num Traces type: object required: - id - project_id - run_id title: ExtendedSessionRecord FeedbackRatingDB: properties: explanation: anyOf: - type: string minLength: 1 - type: 'null' title: Explanation rating: oneOf: - $ref: '#/components/schemas/libs__python__schemas__log_records__feedback__LikeDislikeRating' - $ref: '#/components/schemas/libs__python__schemas__log_records__feedback__StarRating' - $ref: '#/components/schemas/libs__python__schemas__log_records__feedback__ScoreRating' - $ref: '#/components/schemas/libs__python__schemas__log_records__feedback__TagsRating' - $ref: '#/components/schemas/libs__python__schemas__log_records__feedback__TextRating' - $ref: '#/components/schemas/libs__python__schemas__log_records__feedback__ChoiceRating' - $ref: '#/components/schemas/libs__python__schemas__log_records__feedback__TreeChoiceRating' title: Rating discriminator: propertyName: feedback_type mapping: choice: '#/components/schemas/libs__python__schemas__log_records__feedback__ChoiceRating' like_dislike: '#/components/schemas/libs__python__schemas__log_records__feedback__LikeDislikeRating' score: '#/components/schemas/libs__python__schemas__log_records__feedback__ScoreRating' star: '#/components/schemas/libs__python__schemas__log_records__feedback__StarRating' tags: '#/components/schemas/libs__python__schemas__log_records__feedback__TagsRating' text: '#/components/schemas/libs__python__schemas__log_records__feedback__TextRating' tree_choice: '#/components/schemas/libs__python__schemas__log_records__feedback__TreeChoiceRating' created_at: type: string format: date-time title: Created At created_by: anyOf: - type: string format: uuid4 - type: 'null' title: Created By type: object required: - rating - created_at - created_by title: FeedbackRatingDB LogTracesIngestRequest: properties: log_stream_id: anyOf: - type: string format: uuid4 - type: 'null' title: Log Stream Id description: Log stream id associated with the traces. experiment_id: anyOf: - type: string format: uuid4 - type: 'null' title: Experiment Id description: Experiment id associated with the traces. metrics_testing_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Testing Id description: Metrics testing id associated with the traces. logging_method: $ref: '#/components/schemas/LoggingMethod' default: api_direct client_version: anyOf: - type: string - type: 'null' title: Client Version reliable: type: boolean title: Reliable description: Whether or not to use reliable logging. If set to False, the method will respond immediately before verifying that the traces have been successfully ingested, and no error message will be returned if ingestion fails. If set to True, the method will wait for the traces to be successfully ingested or return an error message if there is an ingestion failure. default: true session_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Id description: Session id associated with the traces. session_external_id: anyOf: - type: string - type: 'null' title: Session External Id description: External id of the session (e.g., OTEL session.id from span attributes). traces: items: $ref: '#/components/schemas/Trace' type: array minItems: 1 title: Traces description: List of traces to log. is_complete: type: boolean title: Is Complete description: Whether or not the records in this request are complete. default: true include_trace_ids: type: boolean title: Include Trace Ids description: If True, include the list of ingested trace IDs in the response. default: false type: object required: - traces title: LogTracesIngestRequest description: Request model for ingesting traces. examples: - log_stream_id: 00000000-0000-0000-0000-000000000000 session_id: 00000000-0000-0000-0000-000000000000 traces: - created_at: '2026-07-18T04:11:24.401217Z' dataset_metadata: {} input: who is a smart LLM? metrics: {} name: '' output: I am! spans: - created_at: '2026-07-18T04:11:24.401174Z' dataset_metadata: {} input: - content: 'Question: who is a smart LLM?' role: user metrics: {} name: '' output: content: I am! role: user tags: [] type: llm user_metadata: {} tags: [] type: trace user_metadata: {} - experiment_id: 00000000-0000-0000-0000-000000000000 traces: - created_at: '2026-07-18T04:11:24.401580Z' dataset_metadata: {} input: who is a smart LLM? metrics: {} name: '' output: I am! spans: - created_at: '2026-07-18T04:11:24.401543Z' dataset_metadata: {} id: 11111111-1111-4111-a111-111111111111 input: - content: 'Question: who is a smart LLM?' role: user metrics: {} name: '' output: content: I am! role: user tags: [] type: llm user_metadata: {} tags: [] type: trace user_metadata: {} AnnotationRatingInfo: properties: annotation_type: $ref: '#/components/schemas/AnnotationType' value: anyOf: - type: boolean - type: integer - type: string - items: type: string maxLength: 255 minLength: 1 type: array title: Value explanation: anyOf: - type: string - type: 'null' title: Explanation type: object required: - annotation_type - value - explanation title: AnnotationRatingInfo BaseGeneratedScorerDB: properties: id: type: string format: uuid4 title: Id name: type: string title: Name instructions: anyOf: - type: string - type: 'null' title: Instructions chain_poll_template: $ref: '#/components/schemas/ChainPollTemplate' user_prompt: anyOf: - type: string - type: 'null' title: User Prompt type: object required: - id - name - chain_poll_template title: BaseGeneratedScorerDB PartialExtendedLlmSpanRecord: properties: type: type: string const: llm title: Type description: Type of the trace, span or session. default: llm input: items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array title: Input description: Input to the trace or span. redacted_input: anyOf: - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' description: Output of the trace or span. redacted_output: anyOf: - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - type: 'null' description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/LlmMetrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: anyOf: - type: string format: uuid - type: 'null' title: ID description: Galileo ID of the session, trace or span session_id: anyOf: - type: string format: uuid - type: 'null' title: Session ID description: Galileo ID of the session containing the trace (or the same value as id for a trace) trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) project_id: anyOf: - type: string format: uuid - type: 'null' title: Project ID description: Galileo ID of the project associated with this trace or span run_id: anyOf: - type: string format: uuid - type: 'null' title: Run ID description: Galileo ID of the run (log stream or experiment) associated with this trace or span updated_at: anyOf: - type: string format: date-time - type: 'null' title: Last Updated description: Timestamp of the session or trace or span's last update has_children: anyOf: - type: boolean - type: 'null' title: Has Children description: Whether or not this trace or span has child spans metrics_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Batch Id description: Galileo ID of the metrics batch associated with this trace or span session_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Batch Id description: Galileo ID of the metrics batch associated with this trace or span feedback_rating_info: additionalProperties: $ref: '#/components/schemas/FeedbackRatingInfo' type: object title: Feedback Rating Info description: Feedback information related to the record annotations: additionalProperties: additionalProperties: $ref: '#/components/schemas/AnnotationRatingInfo' propertyNames: format: uuid4 type: object propertyNames: format: uuid4 type: object title: Annotations description: Annotations keyed by template ID and annotator ID file_ids: items: type: string format: uuid4 type: array title: File Ids description: IDs of files associated with this record file_modalities: items: $ref: '#/components/schemas/ContentModality' type: array title: File Modalities description: Modalities of files associated with this record annotation_aggregates: additionalProperties: $ref: '#/components/schemas/AnnotationAggregate' propertyNames: format: uuid4 type: object title: Annotation Aggregates description: Annotation aggregate information keyed by template ID annotation_agreement: additionalProperties: type: number propertyNames: format: uuid4 type: object title: Annotation Agreement description: Annotation agreement scores keyed by template ID overall_annotation_agreement: anyOf: - type: number - type: 'null' title: Overall Annotation Agreement description: Average annotation agreement across all templates in the queue annotation_queue_ids: items: type: string format: uuid4 type: array title: Annotation Queue Ids description: IDs of annotation queues this record is in fully_annotated: anyOf: - type: boolean - type: 'null' title: Fully Annotated description: Whether every field is annotated by every annotator in the queue progress_message: type: string title: Progress Message description: Runner progress text written directly to CH span default: '' error_message: type: string title: Error Message description: Runner error text written directly to CH span default: '' metric_info: anyOf: - additionalProperties: oneOf: - $ref: '#/components/schemas/MetricNotComputed' - $ref: '#/components/schemas/MetricPending' - $ref: '#/components/schemas/MetricComputing' - $ref: '#/components/schemas/MetricNotApplicable' - $ref: '#/components/schemas/MetricSuccess' - $ref: '#/components/schemas/MetricError' - $ref: '#/components/schemas/MetricFailed' - $ref: '#/components/schemas/MetricRollUp' discriminator: propertyName: status_type mapping: computing: '#/components/schemas/MetricComputing' error: '#/components/schemas/MetricError' failed: '#/components/schemas/MetricFailed' not_applicable: '#/components/schemas/MetricNotApplicable' not_computed: '#/components/schemas/MetricNotComputed' pending: '#/components/schemas/MetricPending' roll_up: '#/components/schemas/MetricRollUp' success: '#/components/schemas/MetricSuccess' type: object - type: 'null' title: Metric Info description: Detailed information about the metrics associated with this trace or span files: anyOf: - additionalProperties: $ref: '#/components/schemas/FileMetadata' propertyNames: format: uuid4 type: object - type: 'null' title: Files description: File metadata keyed by file ID for files associated with this record parent_id: anyOf: - type: string format: uuid - type: 'null' title: Parent ID description: Galileo ID of the parent of this span is_complete: type: boolean title: Is Complete description: Whether the parent trace is complete or not default: true step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. tools: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Tools description: List of available tools passed to the LLM on invocation. events: anyOf: - items: oneOf: - $ref: '#/components/schemas/MessageEvent' - $ref: '#/components/schemas/ReasoningEvent' - $ref: '#/components/schemas/InternalToolCall' - $ref: '#/components/schemas/WebSearchCallEvent' - $ref: '#/components/schemas/ImageGenerationEvent' - $ref: '#/components/schemas/MCPCallEvent' - $ref: '#/components/schemas/MCPListToolsEvent' - $ref: '#/components/schemas/MCPApprovalRequestEvent' discriminator: propertyName: type mapping: image_generation: '#/components/schemas/ImageGenerationEvent' internal_tool_call: '#/components/schemas/InternalToolCall' mcp_approval_request: '#/components/schemas/MCPApprovalRequestEvent' mcp_call: '#/components/schemas/MCPCallEvent' mcp_list_tools: '#/components/schemas/MCPListToolsEvent' message: '#/components/schemas/MessageEvent' reasoning: '#/components/schemas/ReasoningEvent' web_search_call: '#/components/schemas/WebSearchCallEvent' type: array - type: 'null' title: Events description: List of reasoning, internal tool call, or MCP events that occurred during the LLM span. model: anyOf: - type: string - type: 'null' title: Model description: Model used for this span. temperature: anyOf: - type: number - type: 'null' title: Temperature description: Temperature used for generation. finish_reason: anyOf: - type: string - type: 'null' title: Finish Reason description: Reason for finishing. type: object title: PartialExtendedLlmSpanRecord LogRecordsMetricsResponse: properties: group_by_columns: items: type: string type: array title: Group By Columns aggregate_metrics: additionalProperties: anyOf: - type: number - type: integer - additionalProperties: type: integer type: object type: object title: Aggregate Metrics bucketed_metrics: additionalProperties: items: $ref: '#/components/schemas/BucketedMetrics' type: array type: object title: Bucketed Metrics ems_captured_error: type: boolean title: Ems Captured Error description: Whether any EMS error codes were encountered in the queried metrics default: false standard_errors: anyOf: - additionalProperties: $ref: '#/components/schemas/StandardError' type: object - type: 'null' title: Standard Errors description: Structured EMS errors for each error code encountered, keyed by code type: object required: - group_by_columns - aggregate_metrics - bucketed_metrics title: LogRecordsMetricsResponse LikeDislikeAggregate: properties: feedback_type: type: string const: like_dislike title: Feedback Type default: like_dislike like_count: type: integer title: Like Count dislike_count: type: integer title: Dislike Count unrated_count: type: integer title: Unrated Count type: object required: - like_count - dislike_count - unrated_count title: LikeDislikeAggregate MetricAggregation: type: string enum: - Count - Sum - Average - Min - Max - P50 - P90 - P95 - P99 - PercentageFalse - PercentageTrue title: MetricAggregation LogRecordsDeleteResponse: properties: message: type: string title: Message description: Message type: object required: - message title: LogRecordsDeleteResponse ModelType: type: string enum: - slm - llm - code title: ModelType MultimodalCapability: type: string enum: - vision - audio title: MultimodalCapability LogSpansIngestRequest: properties: log_stream_id: anyOf: - type: string format: uuid4 - type: 'null' title: Log Stream Id description: Log stream id associated with the traces. experiment_id: anyOf: - type: string format: uuid4 - type: 'null' title: Experiment Id description: Experiment id associated with the traces. metrics_testing_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Testing Id description: Metrics testing id associated with the traces. logging_method: $ref: '#/components/schemas/LoggingMethod' default: api_direct client_version: anyOf: - type: string - type: 'null' title: Client Version reliable: type: boolean title: Reliable description: Whether or not to use reliable logging. If set to False, the method will respond immediately before verifying that the traces have been successfully ingested, and no error message will be returned if ingestion fails. If set to True, the method will wait for the traces to be successfully ingested or return an error message if there is an ingestion failure. default: true spans: items: oneOf: - $ref: '#/components/schemas/AgentSpan' - $ref: '#/components/schemas/WorkflowSpan' - $ref: '#/components/schemas/LlmSpan' - $ref: '#/components/schemas/RetrieverSpan' - $ref: '#/components/schemas/ToolSpan' - $ref: '#/components/schemas/ControlSpan' discriminator: propertyName: type mapping: agent: '#/components/schemas/AgentSpan' control: '#/components/schemas/ControlSpan' llm: '#/components/schemas/LlmSpan' retriever: '#/components/schemas/RetrieverSpan' tool: '#/components/schemas/ToolSpan' workflow: '#/components/schemas/WorkflowSpan' type: array minItems: 1 title: Spans description: List of spans to log. trace_id: type: string format: uuid4 title: Trace Id description: Trace id associated with the spans. parent_id: type: string format: uuid4 title: Parent Id description: Parent trace or span id. type: object required: - spans - trace_id - parent_id title: LogSpansIngestRequest description: Request model for ingesting spans. examples: - log_stream_id: 00000000-0000-0000-0000-000000000000 parent_id: 11000011-0000-0000-0000-110000110000 spans: - created_at: '2026-07-18T04:11:24.420049Z' dataset_metadata: {} input: who is a smart LLM? metrics: {} name: '' output: I am! spans: - created_at: '2026-07-18T04:11:24.406228Z' dataset_metadata: {} id: 22222222-2222-4222-a222-222222222222 input: - content: 'Question: who is a smart LLM?' role: user metrics: {} name: '' output: content: I am! role: user tags: [] type: llm user_metadata: {} tags: [] type: workflow user_metadata: {} trace_id: 11000011-0000-0000-0000-110000110000 LogRecordsQueryCountRequest: properties: log_stream_id: anyOf: - type: string format: uuid4 - type: 'null' title: Log Stream Id description: Log stream id associated with the traces. experiment_id: anyOf: - type: string format: uuid4 - type: 'null' title: Experiment Id description: Experiment id associated with the traces. metrics_testing_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Testing Id description: Metrics testing id associated with the traces. filters: items: oneOf: - $ref: '#/components/schemas/LogRecordsIDFilter' - $ref: '#/components/schemas/LogRecordsDateFilter' - $ref: '#/components/schemas/LogRecordsNumberFilter' - $ref: '#/components/schemas/LogRecordsBooleanFilter' - $ref: '#/components/schemas/LogRecordsCollectionFilter' - $ref: '#/components/schemas/LogRecordsTextFilter' - $ref: '#/components/schemas/LogRecordsFullyAnnotatedFilter' discriminator: propertyName: type mapping: boolean: '#/components/schemas/LogRecordsBooleanFilter' collection: '#/components/schemas/LogRecordsCollectionFilter' date: '#/components/schemas/LogRecordsDateFilter' fully_annotated: '#/components/schemas/LogRecordsFullyAnnotatedFilter' id: '#/components/schemas/LogRecordsIDFilter' number: '#/components/schemas/LogRecordsNumberFilter' text: '#/components/schemas/LogRecordsTextFilter' type: array title: Filters filter_tree: anyOf: - $ref: '#/components/schemas/FilterExpression_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____-Input' - type: 'null' type: object title: LogRecordsQueryCountRequest example: filters: - case_sensitive: true name: input operator: eq type: text value: example input log_stream_id: 74aec44e-ec21-4c9f-a3e2-b2ab2b81b4db ImageGenerationEvent: properties: type: type: string const: image_generation title: Type default: image_generation id: anyOf: - type: string - type: 'null' title: Id description: Unique identifier for the event status: anyOf: - $ref: '#/components/schemas/EventStatus' - type: 'null' description: Status of the event metadata: anyOf: - additionalProperties: true type: object - type: 'null' title: Metadata description: Provider-specific metadata and additional fields error_message: anyOf: - type: string - type: 'null' title: Error Message description: Error message if the event failed prompt: anyOf: - type: string - type: 'null' title: Prompt description: The prompt used for image generation images: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Images description: Generated images with URLs or base64 data model: anyOf: - type: string - type: 'null' title: Model description: Image generation model used type: object title: ImageGenerationEvent description: An image generation event from the model. AgentType: type: string enum: - default - planner - react - reflection - router - classifier - supervisor - judge title: AgentType AggregatedTraceViewResponse: properties: graph: $ref: '#/components/schemas/AggregatedTraceViewGraph' num_traces: type: integer title: Num Traces description: Number of traces in the aggregated view num_sessions: type: integer title: Num Sessions description: Number of sessions in the aggregated view start_time: anyOf: - type: string format: date-time - type: 'null' title: Start Time description: created_at of earliest record of the aggregated view end_time: anyOf: - type: string format: date-time - type: 'null' title: End Time description: created_at of latest record of the aggregated view has_all_traces: type: boolean title: Has All Traces description: Whether all traces were returned type: object required: - graph - num_traces - num_sessions - has_all_traces title: AggregatedTraceViewResponse FileSource: type: string enum: - direct_upload - external_files_api - external_url - assembled_stream title: FileSource description: Source of the file data. StandardError: properties: error_code: type: integer title: Error Code error_type: $ref: '#/components/schemas/ErrorType' error_group: type: string title: Error Group severity: $ref: '#/components/schemas/ErrorSeverity' message: type: string title: Message user_action: anyOf: - type: string - type: 'null' title: User Action documentation_link: anyOf: - type: string maxLength: 2083 minLength: 1 format: uri - type: 'null' title: Documentation Link retriable: type: boolean title: Retriable default: false blocking: type: boolean title: Blocking default: false http_status_code: anyOf: - type: integer - type: 'null' title: Http Status Code source_service: anyOf: - type: string - type: 'null' title: Source Service context: additionalProperties: true type: object title: Context type: object required: - error_code - error_type - error_group - severity - message title: StandardError PartialExtendedToolSpanRecord: properties: type: type: string const: tool title: Type description: Type of the trace, span or session. default: tool input: type: string title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: anyOf: - type: string - type: 'null' title: Output description: Output of the trace or span. redacted_output: anyOf: - type: string - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: anyOf: - type: string format: uuid - type: 'null' title: ID description: Galileo ID of the session, trace or span session_id: anyOf: - type: string format: uuid - type: 'null' title: Session ID description: Galileo ID of the session containing the trace (or the same value as id for a trace) trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) project_id: anyOf: - type: string format: uuid - type: 'null' title: Project ID description: Galileo ID of the project associated with this trace or span run_id: anyOf: - type: string format: uuid - type: 'null' title: Run ID description: Galileo ID of the run (log stream or experiment) associated with this trace or span updated_at: anyOf: - type: string format: date-time - type: 'null' title: Last Updated description: Timestamp of the session or trace or span's last update has_children: anyOf: - type: boolean - type: 'null' title: Has Children description: Whether or not this trace or span has child spans metrics_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Batch Id description: Galileo ID of the metrics batch associated with this trace or span session_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Batch Id description: Galileo ID of the metrics batch associated with this trace or span feedback_rating_info: additionalProperties: $ref: '#/components/schemas/FeedbackRatingInfo' type: object title: Feedback Rating Info description: Feedback information related to the record annotations: additionalProperties: additionalProperties: $ref: '#/components/schemas/AnnotationRatingInfo' propertyNames: format: uuid4 type: object propertyNames: format: uuid4 type: object title: Annotations description: Annotations keyed by template ID and annotator ID file_ids: items: type: string format: uuid4 type: array title: File Ids description: IDs of files associated with this record file_modalities: items: $ref: '#/components/schemas/ContentModality' type: array title: File Modalities description: Modalities of files associated with this record annotation_aggregates: additionalProperties: $ref: '#/components/schemas/AnnotationAggregate' propertyNames: format: uuid4 type: object title: Annotation Aggregates description: Annotation aggregate information keyed by template ID annotation_agreement: additionalProperties: type: number propertyNames: format: uuid4 type: object title: Annotation Agreement description: Annotation agreement scores keyed by template ID overall_annotation_agreement: anyOf: - type: number - type: 'null' title: Overall Annotation Agreement description: Average annotation agreement across all templates in the queue annotation_queue_ids: items: type: string format: uuid4 type: array title: Annotation Queue Ids description: IDs of annotation queues this record is in fully_annotated: anyOf: - type: boolean - type: 'null' title: Fully Annotated description: Whether every field is annotated by every annotator in the queue progress_message: type: string title: Progress Message description: Runner progress text written directly to CH span default: '' error_message: type: string title: Error Message description: Runner error text written directly to CH span default: '' metric_info: anyOf: - additionalProperties: oneOf: - $ref: '#/components/schemas/MetricNotComputed' - $ref: '#/components/schemas/MetricPending' - $ref: '#/components/schemas/MetricComputing' - $ref: '#/components/schemas/MetricNotApplicable' - $ref: '#/components/schemas/MetricSuccess' - $ref: '#/components/schemas/MetricError' - $ref: '#/components/schemas/MetricFailed' - $ref: '#/components/schemas/MetricRollUp' discriminator: propertyName: status_type mapping: computing: '#/components/schemas/MetricComputing' error: '#/components/schemas/MetricError' failed: '#/components/schemas/MetricFailed' not_applicable: '#/components/schemas/MetricNotApplicable' not_computed: '#/components/schemas/MetricNotComputed' pending: '#/components/schemas/MetricPending' roll_up: '#/components/schemas/MetricRollUp' success: '#/components/schemas/MetricSuccess' type: object - type: 'null' title: Metric Info description: Detailed information about the metrics associated with this trace or span files: anyOf: - additionalProperties: $ref: '#/components/schemas/FileMetadata' propertyNames: format: uuid4 type: object - type: 'null' title: Files description: File metadata keyed by file ID for files associated with this record parent_id: anyOf: - type: string format: uuid - type: 'null' title: Parent ID description: Galileo ID of the parent of this span is_complete: type: boolean title: Is Complete description: Whether the parent trace is complete or not default: true step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. tool_call_id: anyOf: - type: string - type: 'null' title: Tool Call Id description: ID of the tool call. type: object title: PartialExtendedToolSpanRecord LogRecordsNumberFilter: properties: column_id: type: string title: Column Id description: ID of the column to filter. operator: type: string enum: - eq - ne - gt - gte - lt - lte - between title: Operator value: anyOf: - type: integer - type: number - items: type: integer type: array - items: type: number type: array title: Value type: type: string const: number title: Type default: number type: object required: - column_id - operator - value title: LogRecordsNumberFilter AnnotationScoreAggregate: properties: annotation_type: type: string const: score title: Annotation Type default: score buckets: items: $ref: '#/components/schemas/ScoreBucket' type: array title: Buckets average: type: number title: Average unrated_count: type: integer title: Unrated Count type: object required: - buckets - average - unrated_count title: AnnotationScoreAggregate LogTracesIngestResponse: properties: log_stream_id: anyOf: - type: string format: uuid4 - type: 'null' title: Log Stream Id description: Log stream id associated with the traces. experiment_id: anyOf: - type: string format: uuid4 - type: 'null' title: Experiment Id description: Experiment id associated with the traces. metrics_testing_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Testing Id description: Metrics testing id associated with the traces. project_id: type: string format: uuid4 title: Project Id description: Project id associated with the traces. project_name: type: string title: Project Name description: Project name associated with the traces. session_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Id description: Session id associated with the traces. records_count: type: integer title: Records Count description: Total number of records ingested traces_count: type: integer title: Traces Count description: total number of traces ingested spans_count: type: integer title: Spans Count description: total number of spans ingested trace_ids: anyOf: - items: type: string format: uuid4 type: array - type: 'null' title: Trace Ids description: List of trace IDs that were ingested. Only included if include_trace_ids=True in request. type: object required: - project_id - project_name - records_count - traces_count - spans_count title: LogTracesIngestResponse StarAggregate: properties: feedback_type: type: string const: star title: Feedback Type default: star average: type: number title: Average counts: additionalProperties: type: integer type: object title: Counts unrated_count: type: integer title: Unrated Count type: object required: - average - counts - unrated_count title: StarAggregate AnnotationTreeChoiceAggregate: properties: annotation_type: type: string const: tree_choice title: Annotation Type default: tree_choice counts: additionalProperties: type: integer type: object title: Counts unrated_count: type: integer title: Unrated Count type: object required: - counts - unrated_count title: AnnotationTreeChoiceAggregate ScorerConfig: properties: model_name: anyOf: - type: string - type: 'null' title: Model Name num_judges: anyOf: - type: integer - type: 'null' title: Num Judges filters: anyOf: - items: oneOf: - $ref: '#/components/schemas/NodeNameFilter' - $ref: '#/components/schemas/MetadataFilter' - $ref: '#/components/schemas/ModalityFilter' discriminator: propertyName: name mapping: metadata: '#/components/schemas/MetadataFilter' modality: '#/components/schemas/ModalityFilter' node_name: '#/components/schemas/NodeNameFilter' type: array - type: 'null' title: Filters description: List of filters to apply to the scorer. scoreable_node_types: anyOf: - items: type: string type: array - type: 'null' title: Scoreable Node Types description: List of node types that can be scored by this scorer. Defaults to llm/chat. cot_enabled: anyOf: - type: boolean - type: 'null' title: Cot Enabled description: Whether to enable chain of thought for this scorer. Defaults to False for llm scorers. output_type: anyOf: - $ref: '#/components/schemas/OutputTypeEnum' - type: 'null' description: What type of output to use for model-based scorers (boolean, categorical, etc.). input_type: anyOf: - $ref: '#/components/schemas/InputTypeEnum' - type: 'null' description: What type of input to use for model-based scorers (sessions_normalized, trace_io_only, etc..). id: type: string format: uuid4 title: Id name: anyOf: - type: string - type: 'null' title: Name scorer_type: $ref: '#/components/schemas/ScorerTypes' model_type: anyOf: - $ref: '#/components/schemas/ModelType' - type: 'null' description: Type of model to use for this scorer. slm maps to luna, and llm maps to plus scorer_version: anyOf: - $ref: '#/components/schemas/BaseScorerVersionDB' - type: 'null' description: ScorerVersion to use for this scorer. If not provided, the latest version will be used. multimodal_capabilities: anyOf: - items: $ref: '#/components/schemas/MultimodalCapability' type: array - type: 'null' title: Multimodal Capabilities description: Multimodal capabilities which this scorer can utilize in its evaluation. roll_up_method: anyOf: - $ref: '#/components/schemas/RollUpMethodDisplayOptions' - type: 'null' score_type: anyOf: - type: string - type: 'null' title: Score Type description: Return type of code scorers (e.g., 'bool', 'int', 'float', 'str'). type: object required: - id - scorer_type title: ScorerConfig description: Used for configuring a scorer for a scorer job. FileContentPart: properties: type: type: string const: file title: Type default: file file_id: type: string format: uuid4 title: File Id type: object required: - file_id title: FileContentPart description: '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.' TextAggregate: properties: feedback_type: type: string const: text title: Feedback Type default: text count: type: integer title: Count unrated_count: type: integer title: Unrated Count type: object required: - count - unrated_count title: TextAggregate MetricNotApplicable: properties: status_type: type: string const: not_applicable title: Status Type default: not_applicable scorer_type: anyOf: - $ref: '#/components/schemas/ScorerType' - type: 'null' metric_key_alias: anyOf: - type: string - type: 'null' title: Metric Key Alias message: type: string title: Message default: Metric not applicable. ems_error_code: anyOf: - type: integer - type: 'null' title: Ems Error Code description: EMS error code from errors.yaml catalog for this not-applicable reason standard_error: anyOf: - $ref: '#/components/schemas/StandardError' - type: 'null' description: Structured EMS error resolved on-the-fly from errors.yaml catalog type: object title: MetricNotApplicable AggregatedTraceViewNode: properties: id: type: string title: Id name: anyOf: - type: string - type: 'null' title: Name type: $ref: '#/components/schemas/StepType' occurrences: type: integer title: Occurrences parent_id: anyOf: - type: string - type: 'null' title: Parent Id has_children: type: boolean title: Has Children metrics: additionalProperties: oneOf: - $ref: '#/components/schemas/SystemMetricInfo' - $ref: '#/components/schemas/CategoricalMetricInfo' discriminator: propertyName: aggregation_type mapping: categorical: '#/components/schemas/CategoricalMetricInfo' numeric: '#/components/schemas/SystemMetricInfo' type: object title: Metrics trace_count: type: integer title: Trace Count weight: type: number title: Weight insights: items: $ref: '#/components/schemas/InsightSummary' type: array title: Insights type: object required: - id - name - type - occurrences - has_children - metrics - trace_count - weight title: AggregatedTraceViewNode MetricError: properties: status_type: type: string const: error title: Status Type default: error scorer_type: anyOf: - $ref: '#/components/schemas/ScorerType' - type: 'null' metric_key_alias: anyOf: - type: string - type: 'null' title: Metric Key Alias message: anyOf: - type: string - type: 'null' title: Message default: An error occured. ems_error_code: anyOf: - type: integer - type: 'null' title: Ems Error Code description: EMS error code from errors.yaml catalog for this metric error standard_error: anyOf: - $ref: '#/components/schemas/StandardError' - type: 'null' description: Structured EMS error resolved on-the-fly from errors.yaml catalog type: object title: MetricError ExtendedControlSpanRecord: properties: type: type: string const: control title: Type description: Type of the trace, span or session. default: control input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: anyOf: - $ref: '#/components/schemas/ControlResult' - type: 'null' description: Output of the trace or span. redacted_output: anyOf: - $ref: '#/components/schemas/ControlResult' - type: 'null' description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: type: string format: uuid4 title: ID description: Galileo ID of the session, trace or span session_id: type: string format: uuid4 title: Session ID description: Galileo ID of the session containing the trace (or the same value as id for a trace) trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) project_id: type: string format: uuid4 title: Project ID description: Galileo ID of the project associated with this trace or span run_id: type: string format: uuid4 title: Run ID description: Galileo ID of the run (log stream or experiment) associated with this trace or span updated_at: anyOf: - type: string format: date-time - type: 'null' title: Last Updated description: Timestamp of the session or trace or span's last update has_children: anyOf: - type: boolean - type: 'null' title: Has Children description: Whether or not this trace or span has child spans metrics_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Batch Id description: Galileo ID of the metrics batch associated with this trace or span session_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Batch Id description: Galileo ID of the metrics batch associated with this trace or span feedback_rating_info: additionalProperties: $ref: '#/components/schemas/FeedbackRatingInfo' type: object title: Feedback Rating Info description: Feedback information related to the record annotations: additionalProperties: additionalProperties: $ref: '#/components/schemas/AnnotationRatingInfo' propertyNames: format: uuid4 type: object propertyNames: format: uuid4 type: object title: Annotations description: Annotations keyed by template ID and annotator ID file_ids: items: type: string format: uuid4 type: array title: File Ids description: IDs of files associated with this record file_modalities: items: $ref: '#/components/schemas/ContentModality' type: array title: File Modalities description: Modalities of files associated with this record annotation_aggregates: additionalProperties: $ref: '#/components/schemas/AnnotationAggregate' propertyNames: format: uuid4 type: object title: Annotation Aggregates description: Annotation aggregate information keyed by template ID annotation_agreement: additionalProperties: type: number propertyNames: format: uuid4 type: object title: Annotation Agreement description: Annotation agreement scores keyed by template ID overall_annotation_agreement: anyOf: - type: number - type: 'null' title: Overall Annotation Agreement description: Average annotation agreement across all templates in the queue annotation_queue_ids: items: type: string format: uuid4 type: array title: Annotation Queue Ids description: IDs of annotation queues this record is in fully_annotated: anyOf: - type: boolean - type: 'null' title: Fully Annotated description: Whether every field is annotated by every annotator in the queue progress_message: type: string title: Progress Message description: Runner progress text written directly to CH span default: '' error_message: type: string title: Error Message description: Runner error text written directly to CH span default: '' metric_info: anyOf: - additionalProperties: oneOf: - $ref: '#/components/schemas/MetricNotComputed' - $ref: '#/components/schemas/MetricPending' - $ref: '#/components/schemas/MetricComputing' - $ref: '#/components/schemas/MetricNotApplicable' - $ref: '#/components/schemas/MetricSuccess' - $ref: '#/components/schemas/MetricError' - $ref: '#/components/schemas/MetricFailed' - $ref: '#/components/schemas/MetricRollUp' discriminator: propertyName: status_type mapping: computing: '#/components/schemas/MetricComputing' error: '#/components/schemas/MetricError' failed: '#/components/schemas/MetricFailed' not_applicable: '#/components/schemas/MetricNotApplicable' not_computed: '#/components/schemas/MetricNotComputed' pending: '#/components/schemas/MetricPending' roll_up: '#/components/schemas/MetricRollUp' success: '#/components/schemas/MetricSuccess' type: object - type: 'null' title: Metric Info description: Detailed information about the metrics associated with this trace or span files: anyOf: - additionalProperties: $ref: '#/components/schemas/FileMetadata' propertyNames: format: uuid4 type: object - type: 'null' title: Files description: File metadata keyed by file ID for files associated with this record parent_id: type: string format: uuid4 title: Parent ID description: Galileo ID of the parent of this span is_complete: type: boolean title: Is Complete description: Whether the parent trace is complete or not default: true step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. control_id: anyOf: - type: integer - type: 'null' title: Control Id description: Identifier of the control definition that produced this span. agent_name: anyOf: - type: string - type: 'null' title: Agent Name description: Normalized agent name associated with this control execution. check_stage: anyOf: - $ref: '#/components/schemas/ControlCheckStage' - type: 'null' description: Execution stage where the control ran, typically 'pre' or 'post'. applies_to: anyOf: - $ref: '#/components/schemas/ControlAppliesTo' - type: 'null' description: Parent execution type the control applied to, for example 'llm_call' or 'tool_call'. evaluator_name: anyOf: - type: string - type: 'null' title: Evaluator Name description: Representative evaluator name for this control span. For composite controls, this is the primary evaluator chosen for observability identity. selector_path: anyOf: - type: string - type: 'null' title: Selector Path description: Representative selector path for this control span. For composite controls, this is the primary selector path chosen for observability identity. type: object required: - id - session_id - project_id - run_id - parent_id title: ExtendedControlSpanRecord RetrieverSpan: properties: type: type: string const: retriever title: Type description: Type of the trace, span or session. default: retriever input: type: string title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: items: $ref: '#/components/schemas/Document-Input' type: array title: Output description: Output of the trace or span. redacted_output: anyOf: - items: $ref: '#/components/schemas/Document-Input' type: array - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: anyOf: - type: string format: uuid4 - type: 'null' title: ID description: Galileo ID of the session, trace or span session_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session ID description: Galileo ID of the session containing the trace or span or session trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. parent_id: anyOf: - type: string format: uuid4 - type: 'null' title: Parent ID description: Galileo ID of the parent of this span spans: items: oneOf: - $ref: '#/components/schemas/AgentSpan' - $ref: '#/components/schemas/WorkflowSpan' - $ref: '#/components/schemas/LlmSpan' - $ref: '#/components/schemas/RetrieverSpan' - $ref: '#/components/schemas/ToolSpan' - $ref: '#/components/schemas/ControlSpan' discriminator: propertyName: type mapping: agent: '#/components/schemas/AgentSpan' control: '#/components/schemas/ControlSpan' llm: '#/components/schemas/LlmSpan' retriever: '#/components/schemas/RetrieverSpan' tool: '#/components/schemas/ToolSpan' workflow: '#/components/schemas/WorkflowSpan' type: array title: Spans description: Child spans. type: object title: RetrieverSpan MCPApprovalRequestEvent: properties: type: type: string const: mcp_approval_request title: Type default: mcp_approval_request id: anyOf: - type: string - type: 'null' title: Id description: Unique identifier for the event status: anyOf: - $ref: '#/components/schemas/EventStatus' - type: 'null' description: Status of the event metadata: anyOf: - additionalProperties: true type: object - type: 'null' title: Metadata description: Provider-specific metadata and additional fields error_message: anyOf: - type: string - type: 'null' title: Error Message description: Error message if the event failed tool_name: anyOf: - type: string - type: 'null' title: Tool Name description: Name of the MCP tool requiring approval tool_invocation: anyOf: - additionalProperties: true type: object - type: 'null' title: Tool Invocation description: Details of the tool invocation requiring approval approved: anyOf: - type: boolean - type: 'null' title: Approved description: Whether the request was approved type: object title: MCPApprovalRequestEvent description: MCP approval request - when human approval is needed for an MCP tool call. LogSpanUpdateRequest: properties: log_stream_id: anyOf: - type: string format: uuid4 - type: 'null' title: Log Stream Id description: Log stream id associated with the traces. experiment_id: anyOf: - type: string format: uuid4 - type: 'null' title: Experiment Id description: Experiment id associated with the traces. metrics_testing_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Testing Id description: Metrics testing id associated with the traces. logging_method: $ref: '#/components/schemas/LoggingMethod' default: api_direct client_version: anyOf: - type: string - type: 'null' title: Client Version reliable: type: boolean title: Reliable description: Whether or not to use reliable logging. If set to False, the method will respond immediately before verifying that the traces have been successfully ingested, and no error message will be returned if ingestion fails. If set to True, the method will wait for the traces to be successfully ingested or return an error message if there is an ingestion failure. default: true span_id: type: string format: uuid4 title: Span Id description: Span id to update. input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Input description: Input of the span. Overwrites previous value if present. output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Input' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Output description: Output of the span. Overwrites previous value if present. tags: anyOf: - items: type: string type: array - type: 'null' title: Tags description: Tags to add to the span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the span. Overwrites previous value if present. duration_ns: anyOf: - type: integer - type: 'null' title: Duration Ns description: Duration in nanoseconds. Overwrites previous value if present. type: object required: - span_id title: LogSpanUpdateRequest description: Request model for updating a span. ExtendedWorkflowSpanRecord: properties: type: type: string const: workflow title: Type description: Type of the trace, span or session. default: workflow input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Output' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Output description: Output of the trace or span. redacted_output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Output' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: type: string format: uuid4 title: ID description: Galileo ID of the session, trace or span session_id: type: string format: uuid4 title: Session ID description: Galileo ID of the session containing the trace (or the same value as id for a trace) trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) project_id: type: string format: uuid4 title: Project ID description: Galileo ID of the project associated with this trace or span run_id: type: string format: uuid4 title: Run ID description: Galileo ID of the run (log stream or experiment) associated with this trace or span updated_at: anyOf: - type: string format: date-time - type: 'null' title: Last Updated description: Timestamp of the session or trace or span's last update has_children: anyOf: - type: boolean - type: 'null' title: Has Children description: Whether or not this trace or span has child spans metrics_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Batch Id description: Galileo ID of the metrics batch associated with this trace or span session_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Batch Id description: Galileo ID of the metrics batch associated with this trace or span feedback_rating_info: additionalProperties: $ref: '#/components/schemas/FeedbackRatingInfo' type: object title: Feedback Rating Info description: Feedback information related to the record annotations: additionalProperties: additionalProperties: $ref: '#/components/schemas/AnnotationRatingInfo' propertyNames: format: uuid4 type: object propertyNames: format: uuid4 type: object title: Annotations description: Annotations keyed by template ID and annotator ID file_ids: items: type: string format: uuid4 type: array title: File Ids description: IDs of files associated with this record file_modalities: items: $ref: '#/components/schemas/ContentModality' type: array title: File Modalities description: Modalities of files associated with this record annotation_aggregates: additionalProperties: $ref: '#/components/schemas/AnnotationAggregate' propertyNames: format: uuid4 type: object title: Annotation Aggregates description: Annotation aggregate information keyed by template ID annotation_agreement: additionalProperties: type: number propertyNames: format: uuid4 type: object title: Annotation Agreement description: Annotation agreement scores keyed by template ID overall_annotation_agreement: anyOf: - type: number - type: 'null' title: Overall Annotation Agreement description: Average annotation agreement across all templates in the queue annotation_queue_ids: items: type: string format: uuid4 type: array title: Annotation Queue Ids description: IDs of annotation queues this record is in fully_annotated: anyOf: - type: boolean - type: 'null' title: Fully Annotated description: Whether every field is annotated by every annotator in the queue progress_message: type: string title: Progress Message description: Runner progress text written directly to CH span default: '' error_message: type: string title: Error Message description: Runner error text written directly to CH span default: '' metric_info: anyOf: - additionalProperties: oneOf: - $ref: '#/components/schemas/MetricNotComputed' - $ref: '#/components/schemas/MetricPending' - $ref: '#/components/schemas/MetricComputing' - $ref: '#/components/schemas/MetricNotApplicable' - $ref: '#/components/schemas/MetricSuccess' - $ref: '#/components/schemas/MetricError' - $ref: '#/components/schemas/MetricFailed' - $ref: '#/components/schemas/MetricRollUp' discriminator: propertyName: status_type mapping: computing: '#/components/schemas/MetricComputing' error: '#/components/schemas/MetricError' failed: '#/components/schemas/MetricFailed' not_applicable: '#/components/schemas/MetricNotApplicable' not_computed: '#/components/schemas/MetricNotComputed' pending: '#/components/schemas/MetricPending' roll_up: '#/components/schemas/MetricRollUp' success: '#/components/schemas/MetricSuccess' type: object - type: 'null' title: Metric Info description: Detailed information about the metrics associated with this trace or span files: anyOf: - additionalProperties: $ref: '#/components/schemas/FileMetadata' propertyNames: format: uuid4 type: object - type: 'null' title: Files description: File metadata keyed by file ID for files associated with this record parent_id: type: string format: uuid4 title: Parent ID description: Galileo ID of the parent of this span is_complete: type: boolean title: Is Complete description: Whether the parent trace is complete or not default: true step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. type: object required: - id - session_id - project_id - run_id - parent_id title: ExtendedWorkflowSpanRecord LogRecordsSortClause: properties: column_id: type: string title: Column Id description: ID of the column to sort. ascending: type: boolean title: Ascending default: true sort_type: type: string const: column title: Sort Type default: column type: object required: - column_id title: LogRecordsSortClause HistogramBucket: properties: lower: type: number title: Lower description: Lower bound of the histogram bucket (inclusive) upper: type: number title: Upper description: Upper bound of the histogram bucket (exclusive, but inclusive for the last bucket) count: type: integer title: Count description: Number of data points that fall within this bucket type: object required: - lower - upper - count title: HistogramBucket MetricPending: properties: status_type: type: string const: pending title: Status Type default: pending scorer_type: anyOf: - $ref: '#/components/schemas/ScorerType' - type: 'null' metric_key_alias: anyOf: - type: string - type: 'null' title: Metric Key Alias type: object title: MetricPending AnnotationTagsAggregate: properties: annotation_type: type: string const: tags title: Annotation Type default: tags counts: additionalProperties: type: integer type: object title: Counts unrated_count: type: integer title: Unrated Count type: object required: - counts - unrated_count title: AnnotationTagsAggregate MetricThreshold: properties: inverted: type: boolean title: Inverted description: Whether the column should be inverted for thresholds, i.e. if True, lower is better. default: false buckets: items: anyOf: - type: integer - type: number type: array title: Buckets description: Threshold buckets for the column. If the column is a metric, these are the thresholds for the column. display_value_levels: items: type: string type: array title: Display Value Levels description: Ordered list of strings that raw values get transformed to for displaying. type: object title: MetricThreshold description: 'Threshold configuration for metrics. Defines how metric values are bucketed and displayed, including whether lower or higher values are considered better.' Document-Input: properties: page_content: type: string title: Page Content description: Content of the document. metadata: additionalProperties: anyOf: - type: boolean - type: string - type: integer - type: number type: object title: Metadata additionalProperties: false type: object required: - page_content title: Document LogRecordsQueryCountResponse: properties: total_count: type: integer title: Total Count description: Total number of records matching the query type: object required: - total_count title: LogRecordsQueryCountResponse PartialExtendedRetrieverSpanRecord: properties: type: type: string const: retriever title: Type description: Type of the trace, span or session. default: retriever input: type: string title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: items: $ref: '#/components/schemas/Document-Output' type: array title: Output description: Output of the trace or span. redacted_output: anyOf: - items: $ref: '#/components/schemas/Document-Output' type: array - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: anyOf: - type: string format: uuid - type: 'null' title: ID description: Galileo ID of the session, trace or span session_id: anyOf: - type: string format: uuid - type: 'null' title: Session ID description: Galileo ID of the session containing the trace (or the same value as id for a trace) trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) project_id: anyOf: - type: string format: uuid - type: 'null' title: Project ID description: Galileo ID of the project associated with this trace or span run_id: anyOf: - type: string format: uuid - type: 'null' title: Run ID description: Galileo ID of the run (log stream or experiment) associated with this trace or span updated_at: anyOf: - type: string format: date-time - type: 'null' title: Last Updated description: Timestamp of the session or trace or span's last update has_children: anyOf: - type: boolean - type: 'null' title: Has Children description: Whether or not this trace or span has child spans metrics_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Batch Id description: Galileo ID of the metrics batch associated with this trace or span session_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Batch Id description: Galileo ID of the metrics batch associated with this trace or span feedback_rating_info: additionalProperties: $ref: '#/components/schemas/FeedbackRatingInfo' type: object title: Feedback Rating Info description: Feedback information related to the record annotations: additionalProperties: additionalProperties: $ref: '#/components/schemas/AnnotationRatingInfo' propertyNames: format: uuid4 type: object propertyNames: format: uuid4 type: object title: Annotations description: Annotations keyed by template ID and annotator ID file_ids: items: type: string format: uuid4 type: array title: File Ids description: IDs of files associated with this record file_modalities: items: $ref: '#/components/schemas/ContentModality' type: array title: File Modalities description: Modalities of files associated with this record annotation_aggregates: additionalProperties: $ref: '#/components/schemas/AnnotationAggregate' propertyNames: format: uuid4 type: object title: Annotation Aggregates description: Annotation aggregate information keyed by template ID annotation_agreement: additionalProperties: type: number propertyNames: format: uuid4 type: object title: Annotation Agreement description: Annotation agreement scores keyed by template ID overall_annotation_agreement: anyOf: - type: number - type: 'null' title: Overall Annotation Agreement description: Average annotation agreement across all templates in the queue annotation_queue_ids: items: type: string format: uuid4 type: array title: Annotation Queue Ids description: IDs of annotation queues this record is in fully_annotated: anyOf: - type: boolean - type: 'null' title: Fully Annotated description: Whether every field is annotated by every annotator in the queue progress_message: type: string title: Progress Message description: Runner progress text written directly to CH span default: '' error_message: type: string title: Error Message description: Runner error text written directly to CH span default: '' metric_info: anyOf: - additionalProperties: oneOf: - $ref: '#/components/schemas/MetricNotComputed' - $ref: '#/components/schemas/MetricPending' - $ref: '#/components/schemas/MetricComputing' - $ref: '#/components/schemas/MetricNotApplicable' - $ref: '#/components/schemas/MetricSuccess' - $ref: '#/components/schemas/MetricError' - $ref: '#/components/schemas/MetricFailed' - $ref: '#/components/schemas/MetricRollUp' discriminator: propertyName: status_type mapping: computing: '#/components/schemas/MetricComputing' error: '#/components/schemas/MetricError' failed: '#/components/schemas/MetricFailed' not_applicable: '#/components/schemas/MetricNotApplicable' not_computed: '#/components/schemas/MetricNotComputed' pending: '#/components/schemas/MetricPending' roll_up: '#/components/schemas/MetricRollUp' success: '#/components/schemas/MetricSuccess' type: object - type: 'null' title: Metric Info description: Detailed information about the metrics associated with this trace or span files: anyOf: - additionalProperties: $ref: '#/components/schemas/FileMetadata' propertyNames: format: uuid4 type: object - type: 'null' title: Files description: File metadata keyed by file ID for files associated with this record parent_id: anyOf: - type: string format: uuid - type: 'null' title: Parent ID description: Galileo ID of the parent of this span is_complete: type: boolean title: Is Complete description: Whether the parent trace is complete or not default: true step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. type: object title: PartialExtendedRetrieverSpanRecord Trace: properties: type: type: string const: trace title: Type description: Type of the trace, span or session. default: trace input: anyOf: - type: string - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: anyOf: - type: string - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Output description: Output of the trace or span. redacted_output: anyOf: - type: string - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: anyOf: - type: string format: uuid4 - type: 'null' title: ID description: Galileo ID of the session, trace or span session_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session ID description: Galileo ID of the session containing the trace or span or session trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. parent_id: anyOf: - type: string format: uuid4 - type: 'null' title: Parent ID description: Galileo ID of the parent of this span spans: items: oneOf: - $ref: '#/components/schemas/AgentSpan' - $ref: '#/components/schemas/WorkflowSpan' - $ref: '#/components/schemas/LlmSpan' - $ref: '#/components/schemas/RetrieverSpan' - $ref: '#/components/schemas/ToolSpan' - $ref: '#/components/schemas/ControlSpan' discriminator: propertyName: type mapping: agent: '#/components/schemas/AgentSpan' control: '#/components/schemas/ControlSpan' llm: '#/components/schemas/LlmSpan' retriever: '#/components/schemas/RetrieverSpan' tool: '#/components/schemas/ToolSpan' workflow: '#/components/schemas/WorkflowSpan' type: array title: Spans description: Child spans. type: object title: Trace ? FilterLeaf_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____ : properties: filter: oneOf: - $ref: '#/components/schemas/LogRecordsIDFilter' - $ref: '#/components/schemas/LogRecordsDateFilter' - $ref: '#/components/schemas/LogRecordsNumberFilter' - $ref: '#/components/schemas/LogRecordsBooleanFilter' - $ref: '#/components/schemas/LogRecordsCollectionFilter' - $ref: '#/components/schemas/LogRecordsTextFilter' - $ref: '#/components/schemas/LogRecordsFullyAnnotatedFilter' title: Filter discriminator: propertyName: type mapping: boolean: '#/components/schemas/LogRecordsBooleanFilter' collection: '#/components/schemas/LogRecordsCollectionFilter' date: '#/components/schemas/LogRecordsDateFilter' fully_annotated: '#/components/schemas/LogRecordsFullyAnnotatedFilter' id: '#/components/schemas/LogRecordsIDFilter' number: '#/components/schemas/LogRecordsNumberFilter' text: '#/components/schemas/LogRecordsTextFilter' type: object required: - filter title: FilterLeaf[Annotated[Union[LogRecordsIDFilter, LogRecordsDateFilter, LogRecordsNumberFilter, LogRecordsBooleanFilter, LogRecordsCollectionFilter, LogRecordsTextFilter, LogRecordsFullyAnnotatedFilter], FieldInfo(annotation=NoneType, required=True, discriminator='type')]] InputTypeEnum: type: string enum: - basic - llm_spans - retriever_spans - sessions_normalized - sessions_trace_io_only - tool_spans - trace_input_only - trace_io_only - trace_normalized - trace_output_only - agent_spans - workflow_spans title: InputTypeEnum description: Enumeration of input types. libs__python__schemas__log_records__feedback__TreeChoiceRating: properties: feedback_type: type: string const: tree_choice title: Feedback Type default: tree_choice value: type: string minLength: 1 title: Value type: object required: - value title: TreeChoiceRating AnnotationAggregate: properties: aggregate: oneOf: - $ref: '#/components/schemas/AnnotationLikeDislikeAggregate' - $ref: '#/components/schemas/AnnotationStarAggregate' - $ref: '#/components/schemas/AnnotationScoreAggregate' - $ref: '#/components/schemas/AnnotationTagsAggregate' - $ref: '#/components/schemas/AnnotationChoiceAggregate' - $ref: '#/components/schemas/AnnotationTreeChoiceAggregate' - $ref: '#/components/schemas/AnnotationTextAggregate' title: Aggregate discriminator: propertyName: annotation_type mapping: choice: '#/components/schemas/AnnotationChoiceAggregate' like_dislike: '#/components/schemas/AnnotationLikeDislikeAggregate' score: '#/components/schemas/AnnotationScoreAggregate' star: '#/components/schemas/AnnotationStarAggregate' tags: '#/components/schemas/AnnotationTagsAggregate' text: '#/components/schemas/AnnotationTextAggregate' tree_choice: '#/components/schemas/AnnotationTreeChoiceAggregate' type: object required: - aggregate title: AnnotationAggregate Histogram: properties: strategy: $ref: '#/components/schemas/HistogramStrategy' description: The binning strategy used to create this histogram edges: items: type: number type: array title: Edges description: List of bin edges (monotonically increasing, length = number of buckets + 1) buckets: items: $ref: '#/components/schemas/HistogramBucket' type: array title: Buckets description: List of histogram buckets containing the binned data total: type: integer title: Total description: Total number of data points in the histogram type: object required: - strategy - edges - buckets - total title: Histogram LogRecordsBooleanFilter: properties: column_id: type: string title: Column Id description: ID of the column to filter. operator: type: string enum: - eq - ne title: Operator default: eq value: type: boolean title: Value type: type: string const: boolean title: Type default: boolean type: object required: - column_id - value title: LogRecordsBooleanFilter LogRecordsAvailableColumnsResponse: properties: columns: items: $ref: '#/components/schemas/LogRecordsColumnInfo' type: array title: Columns type: object title: LogRecordsAvailableColumnsResponse examples: - columns: - applicable_types: - control - tool - session - trace - agent - llm - workflow - retriever category: standard data_type: text description: Input to the trace or span. filter_type: text filterable: true group_label: Standard id: input is_empty: false is_optional: false label: Input multi_valued: false sortable: true - applicable_types: - control - tool - session - trace - agent - llm - workflow - retriever category: standard data_type: text description: Output of the trace or span. filter_type: text filterable: true group_label: Standard id: output is_empty: false is_optional: false label: Output multi_valued: false sortable: true - applicable_types: - control - tool - session - trace - agent - llm - workflow - retriever category: standard data_type: text description: Name of the trace, span or session. filter_type: text filterable: true group_label: Standard id: name is_empty: false is_optional: false label: Name multi_valued: false sortable: true - applicable_types: - control - tool - session - trace - agent - llm - workflow - retriever category: standard data_type: timestamp description: Timestamp of the trace or span's creation. filter_type: date filterable: true group_label: Standard id: created_at is_empty: false is_optional: false label: Created multi_valued: false sortable: true - applicable_types: - control - tool - trace - agent - llm - workflow - retriever category: standard data_type: string_list description: Tags associated with this trace or span. filter_type: collection filterable: true group_label: Standard id: tags is_empty: false is_optional: false label: Tags multi_valued: true sortable: false - applicable_types: - control - tool - trace - agent - llm - workflow - retriever category: standard data_type: integer description: Status code of the trace or span. Used for logging failure or error states. filter_type: number filterable: true group_label: Standard id: status_code is_empty: false is_optional: true label: Status Code multi_valued: false sortable: true - applicable_types: - control - tool - session - trace - agent - llm - workflow - retriever category: standard data_type: text description: A user-provided session, trace or span ID. filter_type: text filterable: true group_label: Standard id: external_id is_empty: false is_optional: true label: External Id multi_valued: false sortable: true - applicable_types: - control - tool - trace - agent - llm - workflow - retriever category: standard data_type: text description: Input to the dataset associated with this trace filter_type: text filterable: true group_label: Standard id: dataset_input is_empty: false is_optional: false label: Dataset Input multi_valued: false sortable: true - applicable_types: - control - tool - trace - agent - llm - workflow - retriever category: standard data_type: text description: Output from the dataset associated with this trace filter_type: text filterable: true group_label: Standard id: dataset_output is_empty: false is_optional: false label: Dataset Output multi_valued: false sortable: true - applicable_types: - control - tool - session - trace - agent - llm - workflow - retriever category: standard data_type: uuid description: Galileo ID of the session, trace or span filter_type: id filterable: true group_label: Standard id: id is_empty: false is_optional: false label: ID multi_valued: false sortable: true - applicable_types: - control - tool - trace - agent - llm - workflow - retriever category: standard data_type: uuid description: Galileo ID of the session containing the trace (or the same value as id for a trace) filter_type: id filterable: true group_label: Standard id: session_id is_empty: false is_optional: false label: Session ID multi_valued: false sortable: true - applicable_types: - control - tool - trace - agent - llm - workflow - retriever category: standard data_type: uuid description: Galileo ID of the project associated with this trace or span filter_type: id filterable: true group_label: Standard id: project_id is_empty: false is_optional: false label: Project ID multi_valued: false sortable: true - applicable_types: - control - tool - trace - agent - llm - workflow - retriever category: standard data_type: uuid description: Galileo ID of the run (log stream or experiment) associated with this trace or span filter_type: id filterable: true group_label: Standard id: run_id is_empty: false is_optional: false label: Run ID multi_valued: false sortable: true - applicable_types: - control - tool - trace - agent - llm - workflow - retriever category: standard data_type: timestamp description: Timestamp of the session or trace or span's last update filter_type: date filterable: true group_label: Standard id: updated_at is_empty: false is_optional: true label: Last Updated multi_valued: false sortable: true - applicable_types: - control - tool - trace - agent - llm - workflow - retriever category: standard data_type: boolean description: Whether or not this trace or span has child spans filter_type: boolean filterable: true group_label: Standard id: has_children is_empty: false is_optional: true label: Has Children multi_valued: false sortable: true - applicable_types: - control - tool - session - trace - agent - llm - workflow - retriever category: standard data_type: text description: Runner progress text written directly to CH span filter_type: text filterable: true group_label: Standard id: progress_message is_empty: false is_optional: false label: Progress Message multi_valued: false sortable: true - applicable_types: - control - tool - session - trace - agent - llm - workflow - retriever category: standard data_type: text description: Runner error text written directly to CH span filter_type: text filterable: true group_label: Standard id: error_message is_empty: false is_optional: false label: Error Message multi_valued: false sortable: true - applicable_types: - control - tool - trace - agent - llm - workflow - retriever category: standard data_type: boolean description: Whether the parent trace is complete or not filter_type: boolean filterable: true group_label: Standard id: is_complete is_empty: false is_optional: false label: Is Complete multi_valued: false sortable: true - allowed_values: - control - tool - session - agent - trace - llm - workflow - retriever applicable_types: - control - tool - agent - llm - workflow - retriever category: standard data_type: text description: Type of the trace, span or session. filter_type: text filterable: true group_label: Standard id: type is_empty: false is_optional: false label: Type multi_valued: false sortable: true - applicable_types: - control - tool - agent - llm - workflow - retriever category: standard data_type: uuid description: Galileo ID of the trace containing the span (or the same value as id for a trace) filter_type: id filterable: true group_label: Standard id: trace_id is_empty: false is_optional: false label: Trace ID multi_valued: false sortable: true - applicable_types: - control - tool - agent - llm - workflow - retriever category: standard data_type: uuid description: Galileo ID of the parent of this span filter_type: id filterable: true group_label: Standard id: parent_id is_empty: false is_optional: false label: Parent ID multi_valued: false sortable: true - applicable_types: - control - tool - agent - llm - workflow - retriever category: standard data_type: integer description: Topological step number of the span. filter_type: number filterable: true group_label: Standard id: step_number is_empty: false is_optional: true label: Step Number multi_valued: false sortable: true - allowed_values: - default - router - judge - classifier - planner - reflection - react - supervisor applicable_types: - agent category: standard data_type: text description: Agent type. filter_type: text filterable: true group_label: Standard id: agent_type is_empty: false is_optional: false label: Agent Type multi_valued: false sortable: true - applicable_types: - llm category: standard data_type: text description: List of available tools passed to the LLM on invocation. filter_type: text filterable: true group_label: Standard id: tools is_empty: false is_optional: false label: Tools multi_valued: false sortable: true - applicable_types: - llm category: standard data_type: text description: Model used for this span. filter_type: text filterable: true group_label: Standard id: model is_empty: false is_optional: true label: Model multi_valued: false sortable: true - applicable_types: - llm category: standard data_type: floating_point description: Temperature used for generation. filter_type: number filterable: true group_label: Standard id: temperature is_empty: false is_optional: true label: Temperature multi_valued: false sortable: true - applicable_types: - llm category: standard data_type: text description: Reason for finishing. filter_type: text filterable: true group_label: Standard id: finish_reason is_empty: false is_optional: true label: Finish Reason multi_valued: false sortable: true - applicable_types: - tool category: standard data_type: text description: ID of the tool call. filter_type: text filterable: true group_label: Standard id: tool_call_id is_empty: false is_optional: true label: Tool Call Id multi_valued: false sortable: true - applicable_types: - control category: standard data_type: integer description: Identifier of the control definition that produced this span. filter_type: number filterable: true group_label: Standard id: control_id is_empty: false is_optional: true label: Control Id multi_valued: false sortable: true - applicable_types: - control category: standard data_type: text description: Normalized agent name associated with this control execution. filter_type: text filterable: true group_label: Standard id: agent_name is_empty: false is_optional: true label: Agent Name multi_valued: false sortable: true - allowed_values: - post - pre applicable_types: - control category: standard data_type: text description: Execution stage where the control ran, typically 'pre' or 'post'. filter_type: text filterable: true group_label: Standard id: check_stage is_empty: false is_optional: true label: Check Stage multi_valued: false sortable: true - allowed_values: - llm_call - tool_call applicable_types: - control category: standard data_type: text description: Parent execution type the control applied to, for example 'llm_call' or 'tool_call'. filter_type: text filterable: true group_label: Standard id: applies_to is_empty: false is_optional: true label: Applies To multi_valued: false sortable: true - applicable_types: - control category: standard data_type: text description: Representative evaluator name for this control span. For composite controls, this is the primary evaluator chosen for observability identity. filter_type: text filterable: true group_label: Standard id: evaluator_name is_empty: false is_optional: true label: Evaluator Name multi_valued: false sortable: true - applicable_types: - control category: standard data_type: text description: Representative selector path for this control span. For composite controls, this is the primary selector path chosen for observability identity. filter_type: text filterable: true group_label: Standard id: selector_path is_empty: false is_optional: true label: Selector Path multi_valued: false sortable: true - applicable_types: [] category: metric data_type: floating_point data_unit: percentage description: Measures the presence and severity of harmful, offensive, or abusive language in the model's response filter_type: number filterable: true group_label: Safety Metrics id: metrics/toxicity is_empty: false is_optional: false label: Output Toxicity (SLM) multi_valued: false roll_up_method: average sortable: true threshold: buckets: - 0.5 - 0.8 display_value_levels: - Low - Medium - High inverted: true DataType: type: string enum: - uuid - text - integer - floating_point - boolean - timestamp - string_list - tag - dataset - prompt - playground - rank - category_count - score_rating_aggregate - star_rating_aggregate - thumb_rating_aggregate - tags_rating_aggregate - text_rating_aggregate - annotation_agreement - fully_annotated title: DataType MetricAggregationDetail: properties: id: type: string title: Id description: Identifier for the metric in the response (e.g., 'w1', 'w2') metric_name: type: string title: Metric Name description: Name of the metric to aggregate aggregation: $ref: '#/components/schemas/MetricAggregation' description: Aggregation type to apply type: object required: - id - metric_name - aggregation title: MetricAggregationDetail libs__python__schemas__log_records__feedback__TextRating: properties: feedback_type: type: string const: text title: Feedback Type default: text value: type: string minLength: 1 title: Value type: object required: - value title: TextRating StepType: type: string enum: - llm - retriever - tool - workflow - agent - control - trace - session title: StepType AnnotationLikeDislikeAggregate: properties: annotation_type: type: string const: like_dislike title: Annotation Type default: like_dislike like_count: type: integer title: Like Count dislike_count: type: integer title: Dislike Count unrated_count: type: integer title: Unrated Count tie_count: anyOf: - type: integer - type: 'null' title: Tie Count type: object required: - like_count - dislike_count - unrated_count title: AnnotationLikeDislikeAggregate InternalToolCall: properties: type: type: string const: internal_tool_call title: Type default: internal_tool_call id: anyOf: - type: string - type: 'null' title: Id description: Unique identifier for the event status: anyOf: - $ref: '#/components/schemas/EventStatus' - type: 'null' description: Status of the event metadata: anyOf: - additionalProperties: true type: object - type: 'null' title: Metadata description: Provider-specific metadata and additional fields error_message: anyOf: - type: string - type: 'null' title: Error Message description: Error message if the event failed name: type: string title: Name description: Name of the internal tool (e.g., 'web_search', 'code_interpreter', 'file_search') input: anyOf: - additionalProperties: true type: object - type: 'null' title: Input description: Input/arguments to the tool call output: anyOf: - additionalProperties: true type: object - type: 'null' title: Output description: Output/results from the tool call type: object required: - name title: InternalToolCall description: '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).' MetricFailed: properties: status_type: type: string const: failed title: Status Type default: failed scorer_type: anyOf: - $ref: '#/components/schemas/ScorerType' - type: 'null' metric_key_alias: anyOf: - type: string - type: 'null' title: Metric Key Alias message: anyOf: - type: string - type: 'null' title: Message default: Metric failed to compute. ems_error_code: anyOf: - type: integer - type: 'null' title: Ems Error Code description: EMS error code from errors.yaml catalog for this metric failure standard_error: anyOf: - $ref: '#/components/schemas/StandardError' - type: 'null' description: Structured EMS error resolved on-the-fly from errors.yaml catalog type: object title: MetricFailed ToolSpan: properties: type: type: string const: tool title: Type description: Type of the trace, span or session. default: tool input: type: string title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: anyOf: - type: string - type: 'null' title: Output description: Output of the trace or span. redacted_output: anyOf: - type: string - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: anyOf: - type: string format: uuid4 - type: 'null' title: ID description: Galileo ID of the session, trace or span session_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session ID description: Galileo ID of the session containing the trace or span or session trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. parent_id: anyOf: - type: string format: uuid4 - type: 'null' title: Parent ID description: Galileo ID of the parent of this span spans: items: oneOf: - $ref: '#/components/schemas/AgentSpan' - $ref: '#/components/schemas/WorkflowSpan' - $ref: '#/components/schemas/LlmSpan' - $ref: '#/components/schemas/RetrieverSpan' - $ref: '#/components/schemas/ToolSpan' - $ref: '#/components/schemas/ControlSpan' discriminator: propertyName: type mapping: agent: '#/components/schemas/AgentSpan' control: '#/components/schemas/ControlSpan' llm: '#/components/schemas/LlmSpan' retriever: '#/components/schemas/RetrieverSpan' tool: '#/components/schemas/ToolSpan' workflow: '#/components/schemas/WorkflowSpan' type: array title: Spans description: Child spans. tool_call_id: anyOf: - type: string - type: 'null' title: Tool Call Id description: ID of the tool call. type: object title: ToolSpan LogSpanUpdateResponse: properties: log_stream_id: anyOf: - type: string format: uuid4 - type: 'null' title: Log Stream Id description: Log stream id associated with the traces. experiment_id: anyOf: - type: string format: uuid4 - type: 'null' title: Experiment Id description: Experiment id associated with the traces. metrics_testing_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Testing Id description: Metrics testing id associated with the traces. project_id: type: string format: uuid4 title: Project Id description: Project id associated with the traces. project_name: type: string title: Project Name description: Project name associated with the traces. session_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Id description: Session id associated with the traces. records_count: type: integer title: Records Count description: Total number of records ingested span_id: type: string format: uuid4 title: Span Id description: Span id associated with the updated span. type: object required: - project_id - project_name - records_count - span_id title: LogSpanUpdateResponse MetricCritiqueContent: properties: critique: type: string title: Critique intended_value: type: boolean title: Intended Value original_explanation: type: string title: Original Explanation type: object required: - critique - intended_value - original_explanation title: MetricCritiqueContent PartialExtendedWorkflowSpanRecord: properties: type: type: string const: workflow title: Type description: Type of the trace, span or session. default: workflow input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Output' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Output description: Output of the trace or span. redacted_output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Output' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: anyOf: - type: string format: uuid - type: 'null' title: ID description: Galileo ID of the session, trace or span session_id: anyOf: - type: string format: uuid - type: 'null' title: Session ID description: Galileo ID of the session containing the trace (or the same value as id for a trace) trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) project_id: anyOf: - type: string format: uuid - type: 'null' title: Project ID description: Galileo ID of the project associated with this trace or span run_id: anyOf: - type: string format: uuid - type: 'null' title: Run ID description: Galileo ID of the run (log stream or experiment) associated with this trace or span updated_at: anyOf: - type: string format: date-time - type: 'null' title: Last Updated description: Timestamp of the session or trace or span's last update has_children: anyOf: - type: boolean - type: 'null' title: Has Children description: Whether or not this trace or span has child spans metrics_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Batch Id description: Galileo ID of the metrics batch associated with this trace or span session_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Batch Id description: Galileo ID of the metrics batch associated with this trace or span feedback_rating_info: additionalProperties: $ref: '#/components/schemas/FeedbackRatingInfo' type: object title: Feedback Rating Info description: Feedback information related to the record annotations: additionalProperties: additionalProperties: $ref: '#/components/schemas/AnnotationRatingInfo' propertyNames: format: uuid4 type: object propertyNames: format: uuid4 type: object title: Annotations description: Annotations keyed by template ID and annotator ID file_ids: items: type: string format: uuid4 type: array title: File Ids description: IDs of files associated with this record file_modalities: items: $ref: '#/components/schemas/ContentModality' type: array title: File Modalities description: Modalities of files associated with this record annotation_aggregates: additionalProperties: $ref: '#/components/schemas/AnnotationAggregate' propertyNames: format: uuid4 type: object title: Annotation Aggregates description: Annotation aggregate information keyed by template ID annotation_agreement: additionalProperties: type: number propertyNames: format: uuid4 type: object title: Annotation Agreement description: Annotation agreement scores keyed by template ID overall_annotation_agreement: anyOf: - type: number - type: 'null' title: Overall Annotation Agreement description: Average annotation agreement across all templates in the queue annotation_queue_ids: items: type: string format: uuid4 type: array title: Annotation Queue Ids description: IDs of annotation queues this record is in fully_annotated: anyOf: - type: boolean - type: 'null' title: Fully Annotated description: Whether every field is annotated by every annotator in the queue progress_message: type: string title: Progress Message description: Runner progress text written directly to CH span default: '' error_message: type: string title: Error Message description: Runner error text written directly to CH span default: '' metric_info: anyOf: - additionalProperties: oneOf: - $ref: '#/components/schemas/MetricNotComputed' - $ref: '#/components/schemas/MetricPending' - $ref: '#/components/schemas/MetricComputing' - $ref: '#/components/schemas/MetricNotApplicable' - $ref: '#/components/schemas/MetricSuccess' - $ref: '#/components/schemas/MetricError' - $ref: '#/components/schemas/MetricFailed' - $ref: '#/components/schemas/MetricRollUp' discriminator: propertyName: status_type mapping: computing: '#/components/schemas/MetricComputing' error: '#/components/schemas/MetricError' failed: '#/components/schemas/MetricFailed' not_applicable: '#/components/schemas/MetricNotApplicable' not_computed: '#/components/schemas/MetricNotComputed' pending: '#/components/schemas/MetricPending' roll_up: '#/components/schemas/MetricRollUp' success: '#/components/schemas/MetricSuccess' type: object - type: 'null' title: Metric Info description: Detailed information about the metrics associated with this trace or span files: anyOf: - additionalProperties: $ref: '#/components/schemas/FileMetadata' propertyNames: format: uuid4 type: object - type: 'null' title: Files description: File metadata keyed by file ID for files associated with this record parent_id: anyOf: - type: string format: uuid - type: 'null' title: Parent ID description: Galileo ID of the parent of this span is_complete: type: boolean title: Is Complete description: Whether the parent trace is complete or not default: true step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. type: object title: PartialExtendedWorkflowSpanRecord AggregatedTraceViewGraph: properties: nodes: items: $ref: '#/components/schemas/AggregatedTraceViewNode' type: array title: Nodes edges: items: $ref: '#/components/schemas/AggregatedTraceViewEdge' type: array title: Edges edge_occurrences_histogram: anyOf: - $ref: '#/components/schemas/Histogram' - type: 'null' description: Histogram of edge occurrence counts across the graph type: object required: - nodes - edges title: AggregatedTraceViewGraph InsightSummary: properties: id: type: string format: uuid4 title: Id title: type: string title: Title observation: type: string title: Observation details: type: string title: Details suggested_action: type: string title: Suggested Action priority: type: integer title: Priority priority_category: anyOf: - type: string enum: - error - warning - info - type: 'null' title: Priority Category type: object required: - id - title - observation - details - suggested_action - priority title: InsightSummary MetricComputing: properties: status_type: type: string const: computing title: Status Type default: computing scorer_type: anyOf: - $ref: '#/components/schemas/ScorerType' - type: 'null' metric_key_alias: anyOf: - type: string - type: 'null' title: Metric Key Alias message: type: string title: Message default: Metric is computing. type: object title: MetricComputing DataUnit: type: string enum: - percentage - nano_seconds - milli_seconds - dollars - count_and_total title: DataUnit ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError ChainPollTemplate: properties: metric_system_prompt: anyOf: - type: string - type: 'null' title: Metric System Prompt description: System prompt for the metric. metric_description: anyOf: - type: string - type: 'null' title: Metric Description description: Description of what the metric should do. value_field_name: type: string title: Value Field Name description: Field name to look for in the chainpoll response, for the rating. default: rating explanation_field_name: type: string title: Explanation Field Name description: Field name to look for in the chainpoll response, for the explanation. default: explanation template: type: string title: Template description: Chainpoll prompt template. metric_few_shot_examples: items: $ref: '#/components/schemas/FewShotExample' type: array title: Metric Few Shot Examples description: Few-shot examples for the metric. response_schema: anyOf: - additionalProperties: true type: object - type: 'null' title: Response Schema description: Response schema for the output type: object required: - template title: ChainPollTemplate description: 'Template for a chainpoll metric prompt, containing all the info necessary to send a chainpoll prompt.' LLMExportFormat: type: string enum: - csv - jsonl - jsonl_flat title: LLMExportFormat MetricCritiqueColumnar: properties: id: type: string format: uuid4 title: Id is_computed: type: boolean title: Is Computed revised_explanation: anyOf: - type: string - type: 'null' title: Revised Explanation critique_info: $ref: '#/components/schemas/MetricCritiqueContent' type: object required: - id - is_computed - revised_explanation - critique_info title: MetricCritiqueColumnar Document-Output: properties: content: type: string title: Content description: Content of the document. metadata: additionalProperties: anyOf: - type: boolean - type: string - type: integer - type: number type: object title: Metadata additionalProperties: false type: object required: - content title: Document BaseRegisteredScorerDB: properties: id: type: string format: uuid4 title: Id name: type: string title: Name score_type: anyOf: - type: string - type: 'null' title: Score Type type: object required: - id - name title: BaseRegisteredScorerDB WorkflowSpan: properties: type: type: string const: workflow title: Type description: Type of the trace, span or session. default: workflow input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - items: $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Input' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Output description: Output of the trace or span. redacted_output: anyOf: - type: string - $ref: '#/components/schemas/galileo_core__schemas__logging__llm__Message' - items: $ref: '#/components/schemas/Document-Input' type: array - items: oneOf: - $ref: '#/components/schemas/TextContentPart' - $ref: '#/components/schemas/FileContentPart' discriminator: propertyName: type mapping: file: '#/components/schemas/FileContentPart' text: '#/components/schemas/TextContentPart' type: array - $ref: '#/components/schemas/ControlResult' - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: anyOf: - type: string format: uuid4 - type: 'null' title: ID description: Galileo ID of the session, trace or span session_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session ID description: Galileo ID of the session containing the trace or span or session trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. parent_id: anyOf: - type: string format: uuid4 - type: 'null' title: Parent ID description: Galileo ID of the parent of this span spans: items: oneOf: - $ref: '#/components/schemas/AgentSpan' - $ref: '#/components/schemas/WorkflowSpan' - $ref: '#/components/schemas/LlmSpan' - $ref: '#/components/schemas/RetrieverSpan' - $ref: '#/components/schemas/ToolSpan' - $ref: '#/components/schemas/ControlSpan' discriminator: propertyName: type mapping: agent: '#/components/schemas/AgentSpan' control: '#/components/schemas/ControlSpan' llm: '#/components/schemas/LlmSpan' retriever: '#/components/schemas/RetrieverSpan' tool: '#/components/schemas/ToolSpan' workflow: '#/components/schemas/WorkflowSpan' type: array title: Spans description: Child spans. type: object title: WorkflowSpan ModalityFilter: properties: name: type: string const: modality title: Name default: modality operator: type: string enum: - eq - ne - one_of - not_in title: Operator value: anyOf: - type: string description: Single enum value - specific options depend on the concrete enum type used example: ENUM_VALUE - items: type: string example: ENUM_VALUE type: array description: Array of enum values example: - ENUM_VALUE_1 - ENUM_VALUE_2 title: Value type: object required: - operator - value title: ModalityFilter description: 'Filters on content modalities in scorer jobs. Matches if at least one of the specified modalities is present.' ? FilterExpression_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____-Input : anyOf: - $ref: '#/components/schemas/FilterLeaf_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____' - $ref: '#/components/schemas/AndNode_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____-Input' - $ref: '#/components/schemas/OrNode_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____-Input' - $ref: '#/components/schemas/NotNode_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____-Input' SelectColumns: properties: column_ids: items: type: string type: array title: Column Ids include_all_metrics: type: boolean title: Include All Metrics default: false include_all_feedback: type: boolean title: Include All Feedback default: false type: object title: SelectColumns StubTraceRecord: properties: spans: items: oneOf: - $ref: '#/components/schemas/ExtendedAgentSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedWorkflowSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedLlmSpanRecord' - $ref: '#/components/schemas/ExtendedToolSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedRetrieverSpanRecordWithChildren' - $ref: '#/components/schemas/ExtendedControlSpanRecord' discriminator: propertyName: type mapping: agent: '#/components/schemas/ExtendedAgentSpanRecordWithChildren' control: '#/components/schemas/ExtendedControlSpanRecord' llm: '#/components/schemas/ExtendedLlmSpanRecord' retriever: '#/components/schemas/ExtendedRetrieverSpanRecordWithChildren' tool: '#/components/schemas/ExtendedToolSpanRecordWithChildren' workflow: '#/components/schemas/ExtendedWorkflowSpanRecordWithChildren' type: array title: Spans type: type: string const: stub_trace title: Type description: Discriminator; identifies this as a synthesized placeholder, not a real trace. default: stub_trace id: type: string format: uuid4 title: Id description: ID of the missing trace, taken from span trace_id references. project_id: anyOf: - type: string format: uuid4 - type: 'null' title: Project Id description: Project ID inferred from child spans, if all agree; otherwise None. run_id: anyOf: - type: string format: uuid4 - type: 'null' title: Run Id description: Run ID inferred from child spans, if all agree; otherwise None. session_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Id description: Session ID inferred from child spans, if all agree; otherwise None. additionalProperties: false type: object required: - id title: StubTraceRecord description: '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.' EventStatus: type: string enum: - in_progress - completed - failed - cancelled - incomplete title: EventStatus description: Common status values for events. MetricRollUp: properties: status_type: type: string const: roll_up title: Status Type default: roll_up scorer_type: anyOf: - $ref: '#/components/schemas/ScorerType' - type: 'null' metric_key_alias: anyOf: - type: string - type: 'null' title: Metric Key Alias value: anyOf: - type: string - type: integer - type: number - type: boolean - type: string format: uuid - type: string format: date-time - $ref: '#/components/schemas/Segment' - $ref: '#/components/schemas/HallucinationSegment' - $ref: '#/components/schemas/Document-Output' - $ref: '#/components/schemas/FeedbackRatingDB' - $ref: '#/components/schemas/FeedbackAggregate' - items: anyOf: - type: string - type: integer - type: number - type: boolean - type: string format: uuid - type: string format: date-time - $ref: '#/components/schemas/Segment' - $ref: '#/components/schemas/HallucinationSegment' - $ref: '#/components/schemas/Document-Output' - $ref: '#/components/schemas/FeedbackRatingDB' - $ref: '#/components/schemas/FeedbackAggregate' - type: 'null' type: array - items: items: anyOf: - type: string - type: integer - type: number - type: boolean - type: string format: uuid - type: string format: date-time - $ref: '#/components/schemas/Segment' - $ref: '#/components/schemas/HallucinationSegment' - $ref: '#/components/schemas/Document-Output' - $ref: '#/components/schemas/FeedbackRatingDB' - $ref: '#/components/schemas/FeedbackAggregate' - type: 'null' type: array type: array - items: items: items: anyOf: - type: string - type: integer - type: number - type: boolean - type: string format: uuid - type: string format: date-time - $ref: '#/components/schemas/Segment' - $ref: '#/components/schemas/HallucinationSegment' - $ref: '#/components/schemas/Document-Output' - $ref: '#/components/schemas/FeedbackRatingDB' - $ref: '#/components/schemas/FeedbackAggregate' - type: 'null' type: array type: array type: array - type: 'null' title: Value explanation: anyOf: - type: string - type: 'null' title: Explanation cost: anyOf: - type: number - type: 'null' title: Cost model_alias: anyOf: - type: string - type: 'null' title: Model Alias num_judges: anyOf: - type: integer - type: 'null' title: Num Judges multijudge_average: anyOf: - type: number - type: 'null' title: Multijudge Average input_tokens: anyOf: - type: integer - type: 'null' title: Input Tokens output_tokens: anyOf: - type: integer - type: 'null' title: Output Tokens total_tokens: anyOf: - type: integer - type: 'null' title: Total Tokens critique: anyOf: - $ref: '#/components/schemas/MetricCritiqueColumnar' - type: 'null' metadata: anyOf: - additionalProperties: true type: object - type: 'null' title: Metadata description: Optional per-row context returned alongside the score by code-based scorers that return a (score, metadata) tuple. Sourced from the {metric_name}_metadata auxiliary key, which is stored as a JSON string in ClickHouse. roll_up_metrics: additionalProperties: anyOf: - type: number - additionalProperties: type: integer type: object type: object title: Roll Up Metrics description: Roll up metrics e.g. sum, average, min, max for numeric, and category_count for categorical metrics. type: object required: - value title: MetricRollUp LogRecordsExportRequest: properties: column_ids: anyOf: - items: type: string type: array - type: 'null' title: Column Ids description: Column IDs to include in the export. Applies only to CSV exports. export_format: $ref: '#/components/schemas/LLMExportFormat' description: Export format default: jsonl redact: type: boolean title: Redact description: Redact sensitive data default: true file_name: anyOf: - type: string - type: 'null' title: File Name description: Optional filename for the exported file export_computed_metrics_only: type: boolean title: Export Computed Metrics Only description: When true, export only enabled scorer metrics with computed values (success or roll_up). For session exports, omit entire sessions unless every enabled metric at session, trace, or span level is ready (success, roll_up, or not_applicable). Not supported with export_format=jsonl_flat (returns 422); use jsonl or csv instead. default: false log_stream_id: anyOf: - type: string format: uuid4 - type: 'null' title: Log Stream Id description: Log stream id associated with the traces. experiment_id: anyOf: - type: string format: uuid4 - type: 'null' title: Experiment Id description: Experiment id associated with the traces. metrics_testing_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Testing Id description: Metrics testing id associated with the traces. filters: items: oneOf: - $ref: '#/components/schemas/LogRecordsIDFilter' - $ref: '#/components/schemas/LogRecordsDateFilter' - $ref: '#/components/schemas/LogRecordsNumberFilter' - $ref: '#/components/schemas/LogRecordsBooleanFilter' - $ref: '#/components/schemas/LogRecordsCollectionFilter' - $ref: '#/components/schemas/LogRecordsTextFilter' - $ref: '#/components/schemas/LogRecordsFullyAnnotatedFilter' discriminator: propertyName: type mapping: boolean: '#/components/schemas/LogRecordsBooleanFilter' collection: '#/components/schemas/LogRecordsCollectionFilter' date: '#/components/schemas/LogRecordsDateFilter' fully_annotated: '#/components/schemas/LogRecordsFullyAnnotatedFilter' id: '#/components/schemas/LogRecordsIDFilter' number: '#/components/schemas/LogRecordsNumberFilter' text: '#/components/schemas/LogRecordsTextFilter' type: array title: Filters description: Filters to apply on the export sort: anyOf: - $ref: '#/components/schemas/LogRecordsSortClause' - type: 'null' description: Sort clause for the export. Defaults to native sort (created_at, id descending). root_type: $ref: '#/components/schemas/RootType' include_code_metric_metadata: type: boolean title: Include Code Metric Metadata description: If True, include per-row scorer metadata (the dict returned alongside the score by code-based scorers via the (score, metadata) tuple-return contract) on each MetricSuccess in the export. Off by default to keep payloads small for callers that don't need it. default: false type: object required: - root_type title: LogRecordsExportRequest description: Request schema for exporting log records (sessions, traces, spans). examples: - column_ids: - input - output - created_at export_format: jsonl filters: - case_sensitive: true name: input operator: eq type: text value: example input log_stream_id: 00000000-0000-0000-0000-000000000000 root_type: trace sort: ascending: false name: created_at sort_type: column AnnotationTextAggregate: properties: annotation_type: type: string const: text title: Annotation Type default: text count: type: integer title: Count unrated_count: type: integer title: Unrated Count type: object required: - count - unrated_count title: AnnotationTextAggregate ErrorType: type: string enum: - llm_api_error - credentials_error - data_validation_error - configuration_error - permission_error - not_found_error - workflow_error - rate_limit_error - system_error - not_applicable_reason - uncataloged_error title: ErrorType FeedbackType: type: string enum: - like_dislike - star - score - tags - text - choice - tree_choice title: FeedbackType ? OrNode_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____-Input : properties: or: items: anyOf: - $ref: '#/components/schemas/FilterLeaf_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____' - $ref: '#/components/schemas/AndNode_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____-Input' - $ref: '#/components/schemas/OrNode_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____-Input' - $ref: '#/components/schemas/NotNode_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____-Input' type: array title: Or type: object required: - or title: OrNode[Annotated[Union[LogRecordsIDFilter, LogRecordsDateFilter, LogRecordsNumberFilter, LogRecordsBooleanFilter, LogRecordsCollectionFilter, LogRecordsTextFilter, LogRecordsFullyAnnotatedFilter], FieldInfo(annotation=NoneType, required=True, discriminator='type')]] ? AndNode_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____-Input : properties: and: items: anyOf: - $ref: '#/components/schemas/FilterLeaf_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____' - $ref: '#/components/schemas/AndNode_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____-Input' - $ref: '#/components/schemas/OrNode_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____-Input' - $ref: '#/components/schemas/NotNode_Annotated_Union_LogRecordsIDFilter__LogRecordsDateFilter__LogRecordsNumberFilter__LogRecordsBooleanFilter__LogRecordsCollectionFilter__LogRecordsTextFilter__LogRecordsFullyAnnotatedFilter___FieldInfo_annotation_NoneType__required_True__discriminator__type____-Input' type: array title: And type: object required: - and title: AndNode[Annotated[Union[LogRecordsIDFilter, LogRecordsDateFilter, LogRecordsNumberFilter, LogRecordsBooleanFilter, LogRecordsCollectionFilter, LogRecordsTextFilter, LogRecordsFullyAnnotatedFilter], FieldInfo(annotation=NoneType, required=True, discriminator='type')]] ExtendedToolSpanRecord: properties: type: type: string const: tool title: Type description: Type of the trace, span or session. default: tool input: type: string title: Input description: Input to the trace or span. default: '' redacted_input: anyOf: - type: string - type: 'null' title: Redacted Input description: Redacted input of the trace or span. output: anyOf: - type: string - type: 'null' title: Output description: Output of the trace or span. redacted_output: anyOf: - type: string - type: 'null' title: Redacted Output description: Redacted output of the trace or span. name: type: string title: Name description: Name of the trace, span or session. default: '' created_at: type: string format: date-time title: Created description: Timestamp of the trace or span's creation. user_metadata: additionalProperties: type: string type: object title: User Metadata description: Metadata associated with this trace or span. tags: items: type: string type: array title: Tags description: Tags associated with this trace or span. status_code: anyOf: - type: integer - type: 'null' title: Status Code description: Status code of the trace or span. Used for logging failure or error states. metrics: $ref: '#/components/schemas/Metrics' description: Metrics associated with this trace or span. external_id: anyOf: - type: string - type: 'null' title: External Id description: A user-provided session, trace or span ID. dataset_input: anyOf: - type: string - type: 'null' title: Dataset Input description: Input to the dataset associated with this trace dataset_output: anyOf: - type: string - type: 'null' title: Dataset Output description: Output from the dataset associated with this trace dataset_metadata: additionalProperties: type: string type: object title: Dataset Metadata description: Metadata from the dataset associated with this trace id: type: string format: uuid4 title: ID description: Galileo ID of the session, trace or span session_id: type: string format: uuid4 title: Session ID description: Galileo ID of the session containing the trace (or the same value as id for a trace) trace_id: anyOf: - type: string format: uuid4 - type: 'null' title: Trace ID description: Galileo ID of the trace containing the span (or the same value as id for a trace) project_id: type: string format: uuid4 title: Project ID description: Galileo ID of the project associated with this trace or span run_id: type: string format: uuid4 title: Run ID description: Galileo ID of the run (log stream or experiment) associated with this trace or span updated_at: anyOf: - type: string format: date-time - type: 'null' title: Last Updated description: Timestamp of the session or trace or span's last update has_children: anyOf: - type: boolean - type: 'null' title: Has Children description: Whether or not this trace or span has child spans metrics_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Metrics Batch Id description: Galileo ID of the metrics batch associated with this trace or span session_batch_id: anyOf: - type: string format: uuid4 - type: 'null' title: Session Batch Id description: Galileo ID of the metrics batch associated with this trace or span feedback_rating_info: additionalProperties: $ref: '#/components/schemas/FeedbackRatingInfo' type: object title: Feedback Rating Info description: Feedback information related to the record annotations: additionalProperties: additionalProperties: $ref: '#/components/schemas/AnnotationRatingInfo' propertyNames: format: uuid4 type: object propertyNames: format: uuid4 type: object title: Annotations description: Annotations keyed by template ID and annotator ID file_ids: items: type: string format: uuid4 type: array title: File Ids description: IDs of files associated with this record file_modalities: items: $ref: '#/components/schemas/ContentModality' type: array title: File Modalities description: Modalities of files associated with this record annotation_aggregates: additionalProperties: $ref: '#/components/schemas/AnnotationAggregate' propertyNames: format: uuid4 type: object title: Annotation Aggregates description: Annotation aggregate information keyed by template ID annotation_agreement: additionalProperties: type: number propertyNames: format: uuid4 type: object title: Annotation Agreement description: Annotation agreement scores keyed by template ID overall_annotation_agreement: anyOf: - type: number - type: 'null' title: Overall Annotation Agreement description: Average annotation agreement across all templates in the queue annotation_queue_ids: items: type: string format: uuid4 type: array title: Annotation Queue Ids description: IDs of annotation queues this record is in fully_annotated: anyOf: - type: boolean - type: 'null' title: Fully Annotated description: Whether every field is annotated by every annotator in the queue progress_message: type: string title: Progress Message description: Runner progress text written directly to CH span default: '' error_message: type: string title: Error Message description: Runner error text written directly to CH span default: '' metric_info: anyOf: - additionalProperties: oneOf: - $ref: '#/components/schemas/MetricNotComputed' - $ref: '#/components/schemas/MetricPending' - $ref: '#/components/schemas/MetricComputing' - $ref: '#/components/schemas/MetricNotApplicable' - $ref: '#/components/schemas/MetricSuccess' - $ref: '#/components/schemas/MetricError' - $ref: '#/components/schemas/MetricFailed' - $ref: '#/components/schemas/MetricRollUp' discriminator: propertyName: status_type mapping: computing: '#/components/schemas/MetricComputing' error: '#/components/schemas/MetricError' failed: '#/components/schemas/MetricFailed' not_applicable: '#/components/schemas/MetricNotApplicable' not_computed: '#/components/schemas/MetricNotComputed' pending: '#/components/schemas/MetricPending' roll_up: '#/components/schemas/MetricRollUp' success: '#/components/schemas/MetricSuccess' type: object - type: 'null' title: Metric Info description: Detailed information about the metrics associated with this trace or span files: anyOf: - additionalProperties: $ref: '#/components/schemas/FileMetadata' propertyNames: format: uuid4 type: object - type: 'null' title: Files description: File metadata keyed by file ID for files associated with this record parent_id: type: string format: uuid4 title: Parent ID description: Galileo ID of the parent of this span is_complete: type: boolean title: Is Complete description: Whether the parent trace is complete or not default: true step_number: anyOf: - type: integer - type: 'null' title: Step Number description: Topological step number of the span. tool_call_id: anyOf: - type: string - type: 'null' title: Tool Call Id description: ID of the tool call. type: object required: - id - session_id - project_id - run_id - parent_id title: ExtendedToolSpanRecord CategoricalMetricInfo: properties: aggregation_type: type: string const: categorical title: Aggregation Type description: 'Discriminator: categorical metrics aggregated as per-label counts' default: categorical name: type: string title: Name description: Unique identifier for the metric label: type: string title: Label description: Human-readable display name for the metric category_counts: additionalProperties: type: integer type: object title: Category Counts description: Count of occurrences per category label across records type: object required: - name - label title: CategoricalMetricInfo securitySchemes: ClassicAPIKeyHeader: type: apiKey in: header name: Galileo-API-Key APIKeyHeader: type: apiKey in: header name: Splunk-AO-API-Key OAuth2PasswordBearer: type: oauth2 flows: password: scopes: {} tokenUrl: https://api.galileo.ai/login HTTPBasic: type: http scheme: basic