v55

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

Create Trace

Create a single trace from the canonical Trace shape.

Accepts one trace (trace_id plus a nested spans tree) and returns the resulting trace_id. The payload is internally normalized into the same ingest pipeline as POST /tracing/spans/ingest.

Returns 202 Accepted. The async write contract applies — see Tracing — Async write contract.

Use this when you want to operate on whole traces in the list-shaped Trace payload. For flat-list ingestion or multiple traces in one call, use POST /traces/ingest (plural).

post/traces/

Request body

Response

Successful Response

countinteger

1 if a trace_id was returned, 0 otherwise.

trace_idstring nullable

32-char hex UUID identifying the trace that was created or edited.