---
title: "Changes to List run steps"
method: GET
path: "/threads/{thread_id}/runs/{run_id}/steps"
---

# Changes to List run steps

`GET /threads/{thread_id}/runs/{run_id}/steps`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 397 revisions.

- **2026-10-06** `e2f8d8cbc41f`: 1 info
- **2026-09-08** `bb9b3b410112`: 1 info
- **2026-09-03** `9430b00d75b4`: 1 info
- **2026-08-14** `6ac2618eefd7`: 1 info
- **2026-05-13** `74cbcf73838f`: 13 breaking, 2 info
- **2026-04-10** `7c540cce6eb3`: 12 breaking, 5 info
- **2025-03-11** `6ab43fe7798e`: 1 warning
- **2024-08-29** `1dbac0e95bdb`: 3 info
- **2024-08-28** `184dc6e68b58`: 1 warning, 1 info
- **2024-08-23** `5856f8b0c850`: 3 info

## Changes

- **2026-10-06** `e2f8d8cbc41f`: 1 info
  - added the optional property `error/misalignment/review_target` to the response with the `429` status
- **2026-09-08** `bb9b3b410112`: 1 info
  - added the non-success response with the status `429`
- **2026-09-03** `9430b00d75b4`: 1 info
  - added the optional property `error/misalignment` to the response with the `429` status
- **2026-08-14** `6ac2618eefd7`: 1 info
  - added the non-success response with the status `429`
- **2026-05-13** `74cbcf73838f`: 13 breaking, 2 info
  - response property `data/items/cancelled_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data/items/completed_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data/items/expired_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data/items/failed_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data/items/metadata` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data/items/step_details/oneOf[subschema #2: Tool calls]/tool_calls/items/oneOf[subschema #3: Function tool call]/function/output` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `data/items/last_error` response's property type changed from `object` to no type for status `200`
  - the `data/items/usage` response's property type changed from `object` to no type for status `200`
  - removed the required property `data/items/last_error/code` from the response with the `200` status
  - removed the required property `data/items/last_error/message` from the response with the `200` status
  - removed the required property `data/items/usage/completion_tokens` from the response with the `200` status
  - removed the required property `data/items/usage/prompt_tokens` from the response with the `200` status
  - removed the required property `data/items/usage/total_tokens` from the response with the `200` status
  - added `subschema #1, subschema #2` to the `data/items/last_error` response property `anyOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `data/items/usage` response property `anyOf` list for the response status `200`
- **2026-04-10** `7c540cce6eb3`: 12 breaking, 5 info
  - response property `data/items/cancelled_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data/items/completed_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data/items/expired_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data/items/failed_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data/items/metadata` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `data/items/last_error` response's property type changed from `object` to no type for status `200`
  - the `data/items/usage` response's property type changed from `object` to no type for status `200`
  - removed the required property `data/items/last_error/code` from the response with the `200` status
  - removed the required property `data/items/last_error/message` from the response with the `200` status
  - removed the required property `data/items/usage/completion_tokens` from the response with the `200` status
  - removed the required property `data/items/usage/prompt_tokens` from the response with the `200` status
  - removed the required property `data/items/usage/total_tokens` from the response with the `200` status
  - added `#/components/schemas/RunStepDetailsMessageCreationObject, #/components/schemas/RunStepDetailsToolCallsObject` to the `data/items/step_details` response property `anyOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `data/items/last_error` response property `anyOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `data/items/usage` response property `anyOf` list for the response status `200`
  - added discriminator to `data/items/step_details` response property for the response status `200`
  - removed `#/components/schemas/RunStepDetailsMessageCreationObject, #/components/schemas/RunStepDetailsToolCallsObject` from the `data/items/step_details` response property `oneOf` list for the response status `200`
- **2025-03-11** `6ab43fe7798e`: 1 warning
  - added the new `auto` enum value to the `data/items/step_details/oneOf[subschema #2: Tool calls]/tool_calls/items/oneOf[subschema #2: File search tool call]/file_search/ranking_options/ranker` response property for the response status `200`
- **2024-08-29** `1dbac0e95bdb`: 3 info
  - added the new optional `query` request parameter `include[]`
  - added the optional property `data/items/step_details/oneOf[subschema #2: Tool calls]/tool_calls/items/oneOf[subschema #2: File search tool call]/file_search/ranking_options` to the response with the `200` status
  - added the optional property `data/items/step_details/oneOf[subschema #2: Tool calls]/tool_calls/items/oneOf[subschema #2: File search tool call]/file_search/results` to the response with the `200` status
- **2024-08-28** `184dc6e68b58`: 1 warning, 1 info
  - deleted the `query` request parameter `include`
  - added the new optional `query` request parameter `include[]`
- **2024-08-23** `5856f8b0c850`: 3 info
  - added the new optional `query` request parameter `include`
  - added the optional property `data/items/step_details/oneOf[subschema #2: Tool calls]/tool_calls/items/oneOf[subschema #2: File search tool call]/file_search/ranking_options` to the response with the `200` status
  - added the optional property `data/items/step_details/oneOf[subschema #2: Tool calls]/tool_calls/items/oneOf[subschema #2: File search tool call]/file_search/results` to the response with the `200` status

---

[Operation](https://skmtc.dev/openai/apis/openapi/docs/threads/:thread_id/runs/:run_id/steps/get.md) - [API](https://skmtc.dev/openai/apis/openapi.md) - [Page](https://skmtc.dev/openai/apis/openapi/changes/threads/:thread_id/runs/:run_id/steps/get)