TRtriggerdotdev
runs

Retrieve run trace

Changed on

Returns the OTel trace subtree for the requested run — the run's span as rootSpan, its ancestor chain, and its descendant spans. For child or nested runs in a large trace, this is scoped to that run rather than the trace-wide root. Pass page[size] or page[after] to page the trace as flat spans instead; paging works for runs at the root of their trace.

get/api/v1/runs/{runId}/trace

Request

Query parameters

page[size]integer

Turns on paging. Spans per page; values are clamped to 1,000–10,000. Defaults to 10,000 when only page[after] is sent.

page[after]string

Turns on paging. The pagination.next cursor from the previous page, passed back unchanged. Omit it for the first page.

Response

Successful request. Without page parameters, the nested trace tree. With them, one page of flat spans.

OR

Changes

  • 20d6a8f28ae9Revision changes
    • breaking

      added subschema #1: Trace tree subschema #2: Trace page to the response body oneOf list for the response status

    • breaking

      the response's body type changed from object to no type for status

    • warning

      removed the optional property from the response with the status

    • info

      added the new optional query request parameter page[after]

    • info

      added the new optional query request parameter page[size]

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • e82ac1cca8d1Revision changes
    • breaking

      the / response's property type changed from object to no type for status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • info

      added to the / response property allOf list for the response status