Galileo Technologies trace API
The trace API from Galileo Technologies — 89 operation(s) for trace.
The trace API from Galileo Technologies — 89 operation(s) for trace.
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:
applicatio
# --- truncated at 32 KB (597 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/galileo-technologies/refs/heads/main/openapi/galileo-technologies-trace-api-openapi.yml