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

# Changes to List runs

`GET /threads/{thread_id}/runs`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 10 of 163 revisions.

- **2026-09-03** `9430b00d75b4` — 1 info
- **2026-08-14** `6ac2618eefd7` — 1 info
- **2026-05-13** `74cbcf73838f` — 8 breaking, 3 info
- **2025-03-11** `6ab43fe7798e` — 2 breaking, 1 info
- **2025-01-31** `fc164a27fdb9` — 2 breaking, 1 warning, 5 info
- **2025-01-31** `15156e46769c` — 6 breaking, 5 info
- **2025-01-22** `bdebcdfcbbde` — 2 breaking, 1 warning, 5 info
- **2024-09-13** `4c9e3967c707` — 1 info
- **2024-08-23** `5856f8b0c850` — 1 info
- **2024-08-06** `8eca3b09b705` — 1 breaking, 3 info

## Changes

- **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` — 8 breaking, 3 info
  - 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/response_format/oneOf[subschema #4: JSON schema]/json_schema/strict` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data/items/tools/items/oneOf[subschema #3: Function tool]/function/strict` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data/items/truncation_strategy/allOf[subschema #1: Thread Truncation Controls]/last_messages` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `data/items/usage` response's property type changed from `object` to no type for status `200`
  - 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/usage` response property `anyOf` list for the response status `200`
  - the `strict` response's property default value `false` was removed for the status `200`
  - the `strict` response's property default value `false` was removed for the status `200`
- **2025-03-11** `6ab43fe7798e` — 2 breaking, 1 info
  - the response property `data/items/response_format` became nullable for the status `200`
  - added `#/components/schemas/ResponseFormatText, #/components/schemas/ResponseFormatJsonObject, #/components/schemas/ResponseFormatJsonSchema, subschema #1` to the `data/items/response_format` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/AssistantsApiResponseFormatOption, subschema #2` from the `data/items/response_format` response property `allOf` list for the response status `200`
- **2025-01-31** `fc164a27fdb9` — 2 breaking, 1 warning, 5 info
  - the `data/items/truncation_strategy` response's property type changed from `object` to no type for status `200`
  - removed the required property `data/items/truncation_strategy/type` from the response with the `200` status
  - removed the optional property `data/items/truncation_strategy/last_messages` from the response with the `200` status
  - added `#/components/schemas/AssistantsApiResponseFormatOption, subschema #2` to the `data/items/response_format` response property `allOf` list for the response status `200`
  - added `#/components/schemas/AssistantsApiToolChoiceOption, subschema #2` to the `data/items/tool_choice` response property `allOf` list for the response status `200`
  - added `#/components/schemas/TruncationObject, subschema #2` to the `data/items/truncation_strategy` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/AssistantsNamedToolChoice, subschema #1` from the `data/items/tool_choice` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/ResponseFormatText, #/components/schemas/ResponseFormatJsonObject, #/components/schemas/ResponseFormatJsonSchema, subschema #1` from the `data/items/response_format` response property `oneOf` list for the response status `200`
- **2025-01-31** `15156e46769c` — 6 breaking, 5 info
  - the response property `data/items/response_format` became nullable for the status `200`
  - the response property `data/items/tool_choice` became nullable for the status `200`
  - the response property `data/items/truncation_strategy` became nullable for the status `200`
  - added `#/components/schemas/AssistantsNamedToolChoice, subschema #1` to the `data/items/tool_choice` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/ResponseFormatText, #/components/schemas/ResponseFormatJsonObject, #/components/schemas/ResponseFormatJsonSchema, subschema #1` to the `data/items/response_format` response property `oneOf` list for the response status `200`
  - the `data/items/truncation_strategy` response's property type changed from no type to `object` for status `200`
  - added the optional property `data/items/truncation_strategy/last_messages` to the response with the `200` status
  - removed `#/components/schemas/AssistantsApiResponseFormatOption, subschema #2` from the `data/items/response_format` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/AssistantsApiToolChoiceOption, subschema #2` from the `data/items/tool_choice` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/TruncationObject, subschema #2` from the `data/items/truncation_strategy` response property `allOf` list for the response status `200`
  - added the required property `data/items/truncation_strategy/type` to the response with the `200` status
- **2025-01-22** `bdebcdfcbbde` — 2 breaking, 1 warning, 5 info
  - the `data/items/truncation_strategy` response's property type changed from `object` to no type for status `200`
  - removed the required property `data/items/truncation_strategy/type` from the response with the `200` status
  - removed the optional property `data/items/truncation_strategy/last_messages` from the response with the `200` status
  - added `#/components/schemas/AssistantsApiResponseFormatOption, subschema #2` to the `data/items/response_format` response property `allOf` list for the response status `200`
  - added `#/components/schemas/AssistantsApiToolChoiceOption, subschema #2` to the `data/items/tool_choice` response property `allOf` list for the response status `200`
  - added `#/components/schemas/TruncationObject, subschema #2` to the `data/items/truncation_strategy` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/AssistantsNamedToolChoice, subschema #1` from the `data/items/tool_choice` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/ResponseFormatText, #/components/schemas/ResponseFormatJsonObject, #/components/schemas/ResponseFormatJsonSchema, subschema #1` from the `data/items/response_format` response property `oneOf` list for the response status `200`
- **2024-09-13** `4c9e3967c707` — 1 info
  - the response property `data/items/tools/items/oneOf[subschema #2: FileSearch tool]/file_search/ranking_options/score_threshold` became required for the status `200`
- **2024-08-23** `5856f8b0c850` — 1 info
  - added the optional property `data/items/tools/items/oneOf[subschema #2: FileSearch tool]/file_search/ranking_options` to the response with the `200` status
- **2024-08-06** `8eca3b09b705` — 1 breaking, 3 info
  - added `#/components/schemas/ResponseFormatText, #/components/schemas/ResponseFormatJsonObject, #/components/schemas/ResponseFormatJsonSchema` to the `data/items/response_format` response property `oneOf` list for the response status `200`
  - added the optional property `data/items/tools/items/oneOf[subschema #3: Function tool]/function/strict` to the response with the `200` status
  - removed the `none` enum value from the `data/items/response_format/oneOf[subschema #1]/` response property for the response status `200`
  - removed `#/components/schemas/AssistantsApiResponseFormat` from the `data/items/response_format` response property `oneOf` list for the response status `200`

---

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