---
title: "Changes to Retrieve run trace"
method: GET
path: "/api/v1/runs/{runId}/trace"
---

# Changes to Retrieve run trace

`GET /api/v1/runs/{runId}/trace`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 53 revisions.

- **2026-10-09** `20d6a8f28ae9`: 2 breaking, 1 warning, 5 info
- **2026-06-30** `e82ac1cca8d1`: 1 breaking, 5 warning, 1 info
- **2026-02-24** `6ec7a0ed3a5e`: 1 info

## Changes

- **2026-10-09** `20d6a8f28ae9`: 2 breaking, 1 warning, 5 info
  - added `subschema #1: Trace tree, subschema #2: Trace page` to the response body `oneOf` list for the response status `200`
  - the response's body type changed from `object` to no type for status `200`
  - removed the optional property `trace` from the response with the `200` status
  - added the new optional `query` request parameter `page[after]`
  - added the new optional `query` request parameter `page[size]`
  - added the non-success response with the status `400`
  - added the non-success response with the status `501`
  - added the non-success response with the status `503`
- **2026-06-30** `e82ac1cca8d1`: 1 breaking, 5 warning, 1 info
  - the `trace/rootSpan` response's property type changed from `object` to no type for status `200`
  - removed the optional property `trace/rootSpan/children` from the response with the `200` status
  - removed the optional property `trace/rootSpan/data` from the response with the `200` status
  - removed the optional property `trace/rootSpan/id` from the response with the `200` status
  - removed the optional property `trace/rootSpan/parentId` from the response with the `200` status
  - removed the optional property `trace/rootSpan/runId` from the response with the `200` status
  - added `#/components/schemas/SpanDetailedSummary` to the `trace/rootSpan` response property `allOf` list for the response status `200`
- **2026-02-24** `6ec7a0ed3a5e`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/docs/api/v1/runs/:runId/trace/get.md) - [API](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api.md) - [Page](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/changes/api/v1/runs/:runId/trace/get)