---
title: "Changes to List all versions of an agent."
method: GET
path: "/v1/agents/{agent_id}/versions"
---

# Changes to List all versions of an agent.

`GET /v1/agents/{agent_id}/versions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 14 revisions.

- **2026-09-23** `fa73befe1c61`: 1 info
- **2026-07-13** `5a5c361558bb`: 2 info
- **2026-04-07** `ff8a7389b7a4`: 1 breaking, 13 info
- **2026-03-01** `37659aafcad6`: 1 info

## Changes

- **2026-09-23** `fa73befe1c61`: 1 info
  - added the optional property `items/owner_id` to the response with the `200` status
- **2026-07-13** `5a5c361558bb`: 2 info
  - added `#/components/schemas/ReasoningEffort` to the `items/completion_args/reasoning_effort` response property `anyOf` list for the response status `200`
  - removed `subschema #1` from the `items/completion_args/reasoning_effort` response property `anyOf` list for the response status `200`
- **2026-04-07** `ff8a7389b7a4`: 1 breaking, 13 info
  - added `#/components/schemas/CustomConnector` to the `items/tools/items/` response property `oneOf` list for the response status `200`
  - 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 the optional property `items/completion_args/reasoning_effort` to the response with the `200` status
  - added the optional property `items/guardrails` to the response with the `200` status
  - added the optional property `items/tools/items/oneOf[subschema #2: WebSearchTool]/tool_configuration` to the response with the `200` status
  - added the optional property `items/tools/items/oneOf[subschema #3: WebSearchPremiumTool]/tool_configuration` to the response with the `200` status
  - added the optional property `items/tools/items/oneOf[subschema #4: CodeInterpreterTool]/tool_configuration` to the response with the `200` status
  - added the optional property `items/tools/items/oneOf[subschema #5: ImageGenerationTool]/tool_configuration` to the response with the `200` status
  - added the optional property `items/tools/items/oneOf[subschema #6: DocumentLibraryTool]/tool_configuration` to the response with the `200` status
  - added the optional property `items/version_message` to the response with the `200` status
  - the `object` response property const value `agent` was added for the status `200`
  - added `connector` discriminator mapping keys to the `items/tools/items/` response property for the response status `200`
  - removed the `agent` enum value from the `items/object` response property for the response status `200`
- **2026-03-01** `37659aafcad6`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/mistral/apis/mistral-ai-api/docs/v1/agents/:agent_id/versions/get.md) - [API](https://skmtc.dev/mistral/apis/mistral-ai-api.md) - [Page](https://skmtc.dev/mistral/apis/mistral-ai-api/changes/v1/agents/:agent_id/versions/get)