Deprecated

Edit Trace

Changed on

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}

Request

  • Base URL
    /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /api/tracing/traces/{trace_id}
  • Auth
    API key in header Authorization

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

  • fc532d6dc820Revision changes
    • info

      added the new optional request property ///

    • info

      added the new optional request property ///

    • info

      added the new optional request property ///

    • info

      added the new optional request property ///////

    • info

      added the new optional request property ///////

    • info

      added the new optional request property ///////

    • info

      added the new optional request property ////////

    • info

      added the new optional request property ////////

    • info

      added the new optional request property ////////

  • a7f9a6823230Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status