Deprecated

Create Trace

Changed on

Create a trace from one or more spans.

This is the single-trace counterpart to POST /tracing/spans/ingest. Accepts the same OTelTracingRequest body (either spans flat list or traces nested tree) but requires all spans to share a single trace_id.

Returns 202 Accepted with the links for the spans that entered the ingest stream. See Tracing — Async write contract.

Most callers should prefer POST /tracing/spans/ingest (no single-trace restriction) or POST /simple/traces/ (helper for a one-span payload).

post/tracing/traces/

Request

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

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