---
title: "Changes to Create a agent that can be used within a conversation."
method: POST
path: "/v1/agents"
---

# Changes to Create a agent that can be used within a conversation.

`POST /v1/agents`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 14 revisions.

- **2026-09-23** `fa73befe1c61`: 1 info
- **2026-07-13** `5a5c361558bb`: 1 breaking, 3 info
- **2026-04-07** `ff8a7389b7a4`: 1 breaking, 23 info

## Changes

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

---

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