---
title: "Changes to Modify run"
method: POST
path: "/threads/{thread_id}/runs/{run_id}"
---

# Changes to Modify run

`POST /threads/{thread_id}/runs/{run_id}`

> Every recorded change to this endpoint, newest first.
> 169 revisions in range; 1 not diffed.

## Timeline

Changed in 10 of 169 revisions.

- **2026-09-03** `9430b00d75b4` — 1 info
- **2026-08-14** `6ac2618eefd7` — 1 info
- **2026-05-13** `74cbcf73838f` — 9 breaking, 4 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` — 9 breaking, 4 info
  - the request property `metadata` became not nullable
  - response property `metadata` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `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 `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 `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 `usage` response's property type changed from `object` to no type for status `200`
  - 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
  - request property `metadata` list-of-types was widened by adding types `null` to media type `application/json`
  - added `subschema #1, subschema #2` to the `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 `response_format` became nullable for the status `200`
  - added `#/components/schemas/ResponseFormatText, #/components/schemas/ResponseFormatJsonObject, #/components/schemas/ResponseFormatJsonSchema, subschema #1` to the `response_format` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/AssistantsApiResponseFormatOption, subschema #2` from the `response_format` response property `allOf` list for the response status `200`
- **2025-01-31** `fc164a27fdb9` — 2 breaking, 1 warning, 5 info
  - the `truncation_strategy` response's property type changed from `object` to no type for status `200`
  - removed the required property `truncation_strategy/type` from the response with the `200` status
  - removed the optional property `truncation_strategy/last_messages` from the response with the `200` status
  - added `#/components/schemas/AssistantsApiResponseFormatOption, subschema #2` to the `response_format` response property `allOf` list for the response status `200`
  - added `#/components/schemas/AssistantsApiToolChoiceOption, subschema #2` to the `tool_choice` response property `allOf` list for the response status `200`
  - added `#/components/schemas/TruncationObject, subschema #2` to the `truncation_strategy` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/AssistantsNamedToolChoice, subschema #1` from the `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 `response_format` response property `oneOf` list for the response status `200`
- **2025-01-31** `15156e46769c` — 6 breaking, 5 info
  - the response property `response_format` became nullable for the status `200`
  - the response property `tool_choice` became nullable for the status `200`
  - the response property `truncation_strategy` became nullable for the status `200`
  - added `#/components/schemas/AssistantsNamedToolChoice, subschema #1` to the `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 `response_format` response property `oneOf` list for the response status `200`
  - the `truncation_strategy` response's property type changed from no type to `object` for status `200`
  - added the optional property `truncation_strategy/last_messages` to the response with the `200` status
  - removed `#/components/schemas/AssistantsApiResponseFormatOption, subschema #2` from the `response_format` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/AssistantsApiToolChoiceOption, subschema #2` from the `tool_choice` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/TruncationObject, subschema #2` from the `truncation_strategy` response property `allOf` list for the response status `200`
  - added the required property `truncation_strategy/type` to the response with the `200` status
- **2025-01-22** `bdebcdfcbbde` — 2 breaking, 1 warning, 5 info
  - the `truncation_strategy` response's property type changed from `object` to no type for status `200`
  - removed the required property `truncation_strategy/type` from the response with the `200` status
  - removed the optional property `truncation_strategy/last_messages` from the response with the `200` status
  - added `#/components/schemas/AssistantsApiResponseFormatOption, subschema #2` to the `response_format` response property `allOf` list for the response status `200`
  - added `#/components/schemas/AssistantsApiToolChoiceOption, subschema #2` to the `tool_choice` response property `allOf` list for the response status `200`
  - added `#/components/schemas/TruncationObject, subschema #2` to the `truncation_strategy` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/AssistantsNamedToolChoice, subschema #1` from the `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 `response_format` response property `oneOf` list for the response status `200`
- **2024-09-13** `4c9e3967c707` — 1 info
  - the response property `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 `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 `response_format` response property `oneOf` list for the response status `200`
  - added the optional property `tools/items/oneOf[subschema #3: Function tool]/function/strict` to the response with the `200` status
  - removed the `none` enum value from the `response_format/oneOf[subschema #1]/` response property for the response status `200`
  - removed `#/components/schemas/AssistantsApiResponseFormat` from the `response_format` response property `oneOf` list for the response status `200`

---

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