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

# Changes to Retrieve run step

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

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 88 revisions.

- **2026-10-06** `487892d3954e`: 1 info
- **2026-10-05** `7f654af7f94f`: 13 breaking, 1 warning, 3 info

## Changes

- **2026-10-06** `487892d3954e`: 1 info
  - added the optional property `error/misalignment/review_target` to the response with the `429` status
- **2026-10-05** `7f654af7f94f`: 13 breaking, 1 warning, 3 info
  - response property `cancelled_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `completed_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `expired_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `failed_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `metadata` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `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 `last_error` response's property type changed from `object` to no type for status `200`
  - the `usage` response's property type changed from `object` to no type for status `200`
  - removed the required property `last_error/code` from the response with the `200` status
  - removed the required property `last_error/message` from the response with the `200` status
  - removed the required property `usage/completion_tokens` from the response with the `200` status
  - removed the required property `usage/prompt_tokens` from the response with the `200` status
  - removed the required property `usage/total_tokens` from the response with the `200` status
  - added the new `auto` enum value to the `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`
  - added the non-success response with the status `429`
  - added `subschema #1, subschema #2` to the `last_error` response property `anyOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `usage` response property `anyOf` list for the response status `200`

---

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