---
title: "CreatePromptVersion"
method: POST
path: "/v2/prompts/{prompt_id}/versions"
tags: ["beta.prompts"]
---

# CreatePromptVersion

`POST /v2/prompts/{prompt_id}/versions`

CreatePromptVersion

## Path parameters

- `prompt_id` string, required

## Request body

- object
  - `definition` PromptDefinition, required — Versioned prompt content.
    - `content` string, required — Prompt template content.
    - `variables` PromptVariable[] — Variables used by the prompt.
      - `name` string — Stable object name.
  - `notes` string, nullable — Notes for this version.
  - `aliases` string[] — Aliases pointing to this version.

## Response `200`

Success

- CreatePromptVersionResponse
  - `version` integer
  - `deduplicated` boolean

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/revisions/61436a496404/schema)