v54

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-03522891921.1 KB

Deprecated

Create Trace

Create a trace from one or more spans.

This is the single-trace counterpart to POST /tracing/spans/ingest. Accepts the same OTelTracingRequest body (either spans flat list or traces nested tree) but requires all spans to share a single trace_id.

Returns 202 Accepted with the links for the spans that entered the ingest stream. See Tracing — Async write contract.

Most callers should prefer POST /tracing/spans/ingest (no single-trace restriction) or POST /simple/traces/ (helper for a one-span payload).

post/tracing/traces/

Request body

tracesobject nullable

Nested tree of spans keyed by trace_id → span name, with children under each node's spans field. This matches the shape returned by POST /tracing/spans/query with focus="trace".

Response

Successful Response

countinteger

Number of spans that were accepted and published to the ingest stream. Compare against the number of spans you sent to detect partial failures.