v55

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

Traces

Edit Trace

Replace a trace's spans using the canonical Trace shape.

Path trace_id must match the trace_id inside the payload's trace.trace_id. Mismatches return 400. The payload must describe exactly one trace.

Edit re-ingests the spans through the same stream as POST /tracing/spans/ingest. Returns 202 Accepted once the spans are queued. The worker reconciles the trace asynchronously.

put/traces/{trace_id}

Path parameters

trace_idstring required

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.