v54

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

Deprecated

Edit Trace

Replace the spans of an existing trace.

The path trace_id must match the trace_id in the payload. Mismatches return 400. The payload must contain exactly one trace; submitting spans from more than one trace returns 400.

Edit is implemented as a re-ingest: the new spans are written through the same stream as POST /tracing/spans/ingest, and the 202 Accepted response reports how many spans entered the stream. The worker reconciles the trace asynchronously.

put/tracing/traces/{trace_id}

Path parameters

trace_idstring required

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.