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.

Changes

Changed in 11 of the 378 revisions of this API.6432

Aug 3, 2026fc532d6dc8209See the full diff
- ○
  added the new optional request property ///
  new-optional-request-property
- ○
  added the new optional request property ///
  new-optional-request-property
- ○
  added the new optional request property ///
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the new optional request property ////////
  new-optional-request-property
- ○
  added the new optional request property ////////
  new-optional-request-property
- ○
  added the new optional request property ////////
  new-optional-request-property
This revision also has 15 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 19, 2026a7f9a68232302See the full diff
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 14, 2026d7e21f629c881See the full diff
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
May 8, 2026bb630edffa273See the full diff
- ○
  api tag Deprecated added
  api-tag-added
- ○
  api tag Traces removed
  api-tag-removed
- ○
  endpoint deprecated
  endpoint-deprecated
May 2, 20266e37373d45fe2See the full diff
- ○
  api tag Traces added
  api-tag-added
- ○
  api tag Observability removed
  api-tag-removed
This revision also has 11 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 23, 2026925e8b901a263See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
Apr 16, 20268b06b786c9771See the full diff
- ●
  deleted the query request parameter sync
  request-parameter-removed
This revision also has 72 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Mar 7, 202620311f763505611See the full diff
- ▲
  removed from the ///// request property anyOf list
  request-property-any-of-removed
- ▲
  removed from the ////////// request property anyOf list
  request-property-any-of-removed
- ▲
  the response property /// became optional for the status
  response-property-became-optional
- ▲
  the response property /// became optional for the status
  response-property-became-optional
- ▲
  response property links/anyOf[subschema #1]/items/span_id list-of-types was widened by adding types null to media type application/json of response 202
  response-property-list-of-types-widened
- ▲
  response property links/anyOf[subschema #1]/items/trace_id list-of-types was widened by adding types null to media type application/json of response 202
  response-property-list-of-types-widened
- ○
  api operation id edit_trace removed and replaced with edit_trace_tracing
  api-operation-id-removed
- ○
  added to the ///// request property anyOf list
  request-property-any-of-added
- ○
  added to the ////////// request property anyOf list
  request-property-any-of-added
- ○
  the request property ////// became optional
  request-property-became-optional
- ○
  the request property ////// became optional
  request-property-became-optional
- ○
  the request property /////////// became optional
  request-property-became-optional
- ○
  the request property /////////// became optional
  request-property-became-optional
- ○
  request property ////// list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  request property ////// list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  request property /////////// list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  request property /////////// list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 13, 202672fe88316d152See the full diff
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
This revision also has 31 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jan 14, 202653da4c9de2b71See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 56 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history (11 revisions)