Create Trace
POST/traces/
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).
Request
Responses
- 202
- 422
Successful Response
Validation Error