---
title: "Changes to Modifies an assistant."
method: POST
path: "/assistants/{assistant_id}"
---

# Changes to Modifies an assistant.

`POST /assistants/{assistant_id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 35 revisions.

- **2024-10-23** `b60d5559d515` — 2 breaking, 2 info
- **2024-09-12** `501122aa32ad` — 1 breaking, 1 info
- **2024-08-29** `1dbac0e95bdb` — 2 info
- **2024-08-06** `4097c2f86beb` — 2 breaking, 2 info
- **2024-08-06** `c36d30a94622` — 1 breaking, 1 warning, 4 info
- **2024-06-03** `0577fd0d08da` — 2 info

## Changes

- **2024-10-23** `b60d5559d515` — 2 breaking, 2 info
  - removed `subschema #1` from the `response_format` request property `oneOf` list
  - added `subschema #1: Behavior` to the `response_format` response property `oneOf` list for the response status `200`
  - added `subschema #1: Behavior` to the `response_format` request property `oneOf` list
  - removed `subschema #1` from the `response_format` response property `oneOf` list for the response status `200`
- **2024-09-12** `501122aa32ad` — 1 breaking, 1 info
  - the request property `tools/items/oneOf[subschema #2: FileSearch tool]/file_search/ranking_options/score_threshold` became required
  - the response property `tools/items/oneOf[subschema #2: FileSearch tool]/file_search/ranking_options/score_threshold` became required for the status `200`
- **2024-08-29** `1dbac0e95bdb` — 2 info
  - added the new optional request property `tools/items/oneOf[subschema #2: FileSearch tool]/file_search/ranking_options`
  - 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** `4097c2f86beb` — 2 breaking, 2 info
  - removed `#/components/schemas/AssistantsApiResponseFormat` from the `response_format` request property `oneOf` list
  - added `#/components/schemas/ResponseFormatText, #/components/schemas/ResponseFormatJsonObject, #/components/schemas/ResponseFormatJsonSchema` to the `response_format` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/ResponseFormatText, #/components/schemas/ResponseFormatJsonObject, #/components/schemas/ResponseFormatJsonSchema` to the `response_format` request property `oneOf` list
  - removed `#/components/schemas/AssistantsApiResponseFormat` from the `response_format` response property `oneOf` list for the response status `200`
- **2024-08-06** `c36d30a94622` — 1 breaking, 1 warning, 4 info
  - removed the enum value `none` of the request property `response_format/oneOf[subschema #1]/`
  - added the new `json_schema` enum value to the `response_format/oneOf[#/components/schemas/AssistantsApiResponseFormat]/type` response property for the response status `200`
  - added the new optional request property `tools/items/oneOf[subschema #3: Function tool]/function/strict`
  - added the new `json_schema` enum value to the request property `response_format/oneOf[#/components/schemas/AssistantsApiResponseFormat]/type`
  - 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`
- **2024-06-03** `0577fd0d08da` — 2 info
  - added the new optional request property `tools/items/oneOf[subschema #2: FileSearch tool]/file_search`
  - added the optional property `tools/items/oneOf[subschema #2: FileSearch tool]/file_search` to the response with the `200` status

---

[Operation](https://skmtc.dev/openai/apis/openai-api-2/docs/assistants/:assistant_id/post.md) · [API](https://skmtc.dev/openai/apis/openai-api-2.md) · [Page](https://skmtc.dev/openai/apis/openai-api-2/changes/assistants/:assistant_id/post)
