Traces

Create Trace

Changed on

Create a single trace from the canonical Trace shape.

Accepts one trace (trace_id plus a nested spans tree) and returns the resulting trace_id. The payload is internally normalized into the same ingest pipeline as POST /tracing/spans/ingest.

Returns 202 Accepted. The async write contract applies — see Tracing — Async write contract.

Use this when you want to operate on whole traces in the list-shaped Trace payload. For flat-list ingestion or multiple traces in one call, use POST /traces/ingest (plural).

post/traces/

Request

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

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.

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 ///////

  • a7f9a6823230Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status