Sign in

v21

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01144108427.9 KB
Traces

Get Trace

Get a single trace with its hierarchical span tree.

Args: trace_id: The ID of the trace to retrieve. current_user: The authenticated user (required for authorization).

Returns: TraceRead containing the trace and its hierarchical span tree.

get/api/v1/monitor/traces/{trace_id}

Path parameters

trace_idstring uuid required

Response

Successful Response

endTimestring date-time nullable required
flowIdstring uuid required
idstring uuid required
namestring required
sessionIdstring required
startTimestring date-time nullable required
status'unset' | 'ok' | 'error' required

OpenTelemetry status codes.

  • UNSET: Default status, span has not ended yet
  • OK: Span completed successfully
  • ERROR: Span completed with an error
totalLatencyMsinteger required
totalTokensinteger required