---
title: "Changes to Retrieve assistant"
method: GET
path: "/assistants/{assistant_id}"
---

# Changes to Retrieve assistant

`GET /assistants/{assistant_id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 10 of 164 revisions.

- **2026-09-03** `9430b00d75b4` — 1 info
- **2026-08-14** `6ac2618eefd7` — 1 info
- **2026-05-13** `74cbcf73838f` — 11 breaking, 2 warning, 7 info
- **2025-03-11** `6ab43fe7798e` — 2 breaking, 1 info
- **2025-01-31** `fc164a27fdb9` — 2 info
- **2025-01-31** `15156e46769c` — 2 breaking, 1 info
- **2025-01-22** `bdebcdfcbbde` — 2 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` — 11 breaking, 2 warning, 7 info
  - response property `description` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `instructions` 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 `name` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `temperature` 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 `top_p` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `description` response property's maxLength was unset from `512` for the response status `200`
  - the `instructions` response property's maxLength was unset from `256000` for the response status `200`
  - the `name` response property's maxLength was unset from `256` for the response status `200`
  - the `tool_resources` response's property type changed from `object` to no type for status `200`
  - removed the optional property `tool_resources/code_interpreter` from the response with the `200` status
  - removed the optional property `tool_resources/file_search` from the response with the `200` status
  - endpoint deprecated
  - added `#/components/schemas/AssistantsApiResponseFormatOption, subschema #2` to the `response_format` response property `anyOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `tool_resources` response property `anyOf` list for the response status `200`
  - the `strict` response's property default value `false` was removed for the status `200`
  - the `temperature` response's property default value `1` was removed for the status `200`
  - the `top_p` response's property default value `1` was removed for the 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-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 info
  - added `#/components/schemas/AssistantsApiResponseFormatOption, subschema #2` to the `response_format` response property `allOf` 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` — 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-22** `bdebcdfcbbde` — 2 info
  - added `#/components/schemas/AssistantsApiResponseFormatOption, subschema #2` to the `response_format` response property `allOf` 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/assistants/:assistant_id/get.md) · [API](https://skmtc.dev/openai/apis/openapi.md) · [Page](https://skmtc.dev/openai/apis/openapi/changes/assistants/:assistant_id/get)