---
title: "Changes to Retrieve all messages in a conversation."
method: GET
path: "/v1/conversations/{conversation_id}/messages"
---

# Changes to Retrieve all messages in a conversation.

`GET /v1/conversations/{conversation_id}/messages`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 14 revisions.

- **2026-10-12** `6c349f3bdef6`: 5 warning
- **2026-07-13** `5a5c361558bb`: 2 breaking, 2 info
- **2026-04-07** `ff8a7389b7a4`: 50 info
- **2026-03-01** `37659aafcad6`: 3 breaking, 18 info

## Changes

- **2026-10-12** `6c349f3bdef6`: 5 warning
  - added the new `mistral_mcp` enum value to the `messages/items/anyOf[subschema #1: MessageInputEntry]/content/anyOf[subschema #2: MessageInputContentChunks]/items/anyOf[subschema #3: ToolFileChunk]/tool/anyOf[subschema #1: BuiltInConnectors]/` response property for the response status `200`
  - added the new `mistral_mcp` enum value to the `messages/items/anyOf[subschema #1: MessageInputEntry]/content/anyOf[subschema #2: MessageInputContentChunks]/items/anyOf[subschema #5: ThinkChunk]/thinking/items/anyOf[subschema #2: ToolReferenceChunk]/tool/anyOf[subschema #1: BuiltInConnectors]/` response property for the response status `200`
  - added the new `mistral_mcp` enum value to the `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #3: ToolFileChunk]/tool/anyOf[subschema #1: BuiltInConnectors]/` response property for the response status `200`
  - added the new `mistral_mcp` enum value to the `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #5: ThinkChunk]/thinking/items/anyOf[subschema #2: ToolReferenceChunk]/tool/anyOf[subschema #1: BuiltInConnectors]/` response property for the response status `200`
  - added the new `mistral_mcp` enum value to the `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #6: ToolReferenceChunk]/tool/anyOf[subschema #1: BuiltInConnectors]/` response property for the response status `200`
- **2026-07-13** `5a5c361558bb`: 2 breaking, 2 info
  - response property `messages/items/anyOf[subschema #1: MessageInputEntry]/content/anyOf[subschema #2: MessageInputContentChunks]/items/anyOf[subschema #5: ThinkChunk]/thinking/items/anyOf[subschema #3: ReferenceChunk]/reference_ids/items/` list-of-types was widened by adding types `string` to media type `application/json` of response `200`
  - response property `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #5: ThinkChunk]/thinking/items/anyOf[subschema #3: ReferenceChunk]/reference_ids/items/` list-of-types was widened by adding types `string` to media type `application/json` of response `200`
  - added the optional property `messages/items/anyOf[subschema #1: MessageInputEntry]/content/anyOf[subschema #2: MessageInputContentChunks]/items/anyOf[subschema #5: ThinkChunk]/signature` to the response with the `200` status
  - added the optional property `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #5: ThinkChunk]/signature` to the response with the `200` status
- **2026-04-07** `ff8a7389b7a4`: 50 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
  - added `#/components/schemas/ImageDetail` to the `messages/items/anyOf[subschema #1: MessageInputEntry]/content/anyOf[subschema #2: MessageInputContentChunks]/items/anyOf[subschema #2: ImageURLChunk]/image_url/anyOf[subschema #1: ImageURL]/detail` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/ImageDetail` to the `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #2: ImageURLChunk]/image_url/anyOf[subschema #1: ImageURL]/detail` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/ToolReferenceChunk` to the `messages/items/anyOf[subschema #1: MessageInputEntry]/content/anyOf[subschema #2: MessageInputContentChunks]/items/anyOf[subschema #5: ThinkChunk]/thinking/items/` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/ToolReferenceChunk` to the `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #5: ThinkChunk]/thinking/items/` response property `anyOf` list for the response status `200`
  - removed `subschema #1` from the `messages/items/anyOf[subschema #1: MessageInputEntry]/content/anyOf[subschema #2: MessageInputContentChunks]/items/anyOf[subschema #2: ImageURLChunk]/image_url/anyOf[subschema #1: ImageURL]/detail` response property `anyOf` list for the response status `200`
  - removed `subschema #1` from the `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #2: ImageURLChunk]/image_url/anyOf[subschema #1: ImageURL]/detail` response property `anyOf` list for the response status `200`
  - the `object` response property const value `conversation.messages` was added for the status `200`
  - the `object` response property const value `entry` was added for the status `200`
  - the `object` response property const value `entry` was added for the status `200`
  - the `role` response property const value `assistant` was added for the status `200`
  - the `type` response property const value `document_url` was added for the status `200`
  - the `type` response property const value `document_url` was added for the status `200`
  - the `type` response property const value `image_url` was added for the status `200`
  - the `type` response property const value `image_url` was added for the status `200`
  - the `type` response property const value `message.input` was added for the status `200`
  - the `type` response property const value `message.output` was added for the status `200`
  - the `type` response property const value `reference` was added for the status `200`
  - the `type` response property const value `reference` was added for the status `200`
  - the `type` response property const value `text` was added for the status `200`
  - the `type` response property const value `text` was added for the status `200`
  - the `type` response property const value `text` was added for the status `200`
  - the `type` response property const value `text` was added for the status `200`
  - the `type` response property const value `thinking` was added for the status `200`
  - the `type` response property const value `thinking` was added for the status `200`
  - the `type` response property const value `tool_file` was added for the status `200`
  - the `type` response property const value `tool_file` was added for the status `200`
  - the `type` response property const value `tool_reference` was added for the status `200`
  - removed the `assistant` enum value from the `messages/items/anyOf[subschema #2: MessageOutputEntry]/role` response property for the response status `200`
  - removed the `conversation.messages` enum value from the `object` response property for the response status `200`
  - removed the `document_url` enum value from the `messages/items/anyOf[subschema #1: MessageInputEntry]/content/anyOf[subschema #2: MessageInputContentChunks]/items/anyOf[subschema #4: DocumentURLChunk]/type` response property for the response status `200`
  - removed the `document_url` enum value from the `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #4: DocumentURLChunk]/type` response property for the response status `200`
  - removed the `entry` enum value from the `messages/items/anyOf[subschema #1: MessageInputEntry]/object` response property for the response status `200`
  - removed the `entry` enum value from the `messages/items/anyOf[subschema #2: MessageOutputEntry]/object` response property for the response status `200`
  - removed the `image_url` enum value from the `messages/items/anyOf[subschema #1: MessageInputEntry]/content/anyOf[subschema #2: MessageInputContentChunks]/items/anyOf[subschema #2: ImageURLChunk]/type` response property for the response status `200`
  - removed the `image_url` enum value from the `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #2: ImageURLChunk]/type` response property for the response status `200`
  - removed the `message.input` enum value from the `messages/items/anyOf[subschema #1: MessageInputEntry]/type` response property for the response status `200`
  - removed the `message.output` enum value from the `messages/items/anyOf[subschema #2: MessageOutputEntry]/type` response property for the response status `200`
  - removed the `reference` enum value from the `messages/items/anyOf[subschema #1: MessageInputEntry]/content/anyOf[subschema #2: MessageInputContentChunks]/items/anyOf[subschema #5: ThinkChunk]/thinking/items/anyOf[subschema #1: ReferenceChunk -> subschema #3: ReferenceChunk]/type` response property for the response status `200`
  - …10 more
- **2026-03-01** `37659aafcad6`: 3 breaking, 18 info
  - the `messages/items/anyOf[subschema #1: MessageInputEntry]/content/anyOf[subschema #2: MessageInputContentChunks]/items/anyOf[subschema #3: ToolFileChunk]/tool` response's property type changed from `string` to no type for status `200`
  - the `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #3: ToolFileChunk]/tool` response's property type changed from `string` to no type for status `200`
  - the `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #6: ToolReferenceChunk]/tool` response's property type changed from `string` to no type for status `200`
  - added `#/components/schemas/BuiltInConnectors, subschema #2` to the `messages/items/anyOf[subschema #1: MessageInputEntry]/content/anyOf[subschema #2: MessageInputContentChunks]/items/anyOf[subschema #3: ToolFileChunk]/tool` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/BuiltInConnectors, subschema #2` to the `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #3: ToolFileChunk]/tool` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/BuiltInConnectors, subschema #2` to the `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #6: ToolReferenceChunk]/tool` response property `anyOf` list for the response status `200`
  - removed the `code_interpreter` enum value from the `messages/items/anyOf[subschema #1: MessageInputEntry]/content/anyOf[subschema #2: MessageInputContentChunks]/items/anyOf[subschema #3: ToolFileChunk]/tool` response property for the response status `200`
  - removed the `code_interpreter` enum value from the `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #3: ToolFileChunk]/tool` response property for the response status `200`
  - removed the `code_interpreter` enum value from the `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #6: ToolReferenceChunk]/tool` response property for the response status `200`
  - removed the `document_library` enum value from the `messages/items/anyOf[subschema #1: MessageInputEntry]/content/anyOf[subschema #2: MessageInputContentChunks]/items/anyOf[subschema #3: ToolFileChunk]/tool` response property for the response status `200`
  - removed the `document_library` enum value from the `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #3: ToolFileChunk]/tool` response property for the response status `200`
  - removed the `document_library` enum value from the `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #6: ToolReferenceChunk]/tool` response property for the response status `200`
  - removed the `image_generation` enum value from the `messages/items/anyOf[subschema #1: MessageInputEntry]/content/anyOf[subschema #2: MessageInputContentChunks]/items/anyOf[subschema #3: ToolFileChunk]/tool` response property for the response status `200`
  - removed the `image_generation` enum value from the `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #3: ToolFileChunk]/tool` response property for the response status `200`
  - removed the `image_generation` enum value from the `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #6: ToolReferenceChunk]/tool` response property for the response status `200`
  - removed the `web_search` enum value from the `messages/items/anyOf[subschema #1: MessageInputEntry]/content/anyOf[subschema #2: MessageInputContentChunks]/items/anyOf[subschema #3: ToolFileChunk]/tool` response property for the response status `200`
  - removed the `web_search` enum value from the `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #3: ToolFileChunk]/tool` response property for the response status `200`
  - removed the `web_search` enum value from the `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #6: ToolReferenceChunk]/tool` response property for the response status `200`
  - removed the `web_search_premium` enum value from the `messages/items/anyOf[subschema #1: MessageInputEntry]/content/anyOf[subschema #2: MessageInputContentChunks]/items/anyOf[subschema #3: ToolFileChunk]/tool` response property for the response status `200`
  - removed the `web_search_premium` enum value from the `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #3: ToolFileChunk]/tool` response property for the response status `200`
  - removed the `web_search_premium` enum value from the `messages/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #6: ToolReferenceChunk]/tool` response property for the response status `200`

---

[Operation](https://skmtc.dev/mistral/apis/mistral-ai-api/docs/v1/conversations/:conversation_id/messages/get.md) - [API](https://skmtc.dev/mistral/apis/mistral-ai-api.md) - [Page](https://skmtc.dev/mistral/apis/mistral-ai-api/changes/v1/conversations/:conversation_id/messages/get)