---
title: "Changes to Create prompt version"
method: POST
path: "/v1/prompts/{prompt_identifier}/versions"
---

# Changes to Create prompt version

`POST /v1/prompts/{prompt_identifier}/versions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 87 revisions.

- **2026-09-10** `fa1484da1b21`: 2 info
- **2026-09-07** `21f0faa20fcc`: 1 breaking, 1 warning, 4 info
- **2026-09-04** `c2502537476f`: 1 warning, 1 info
- **2026-09-03** `bd512e4428d3`: 1 breaking, 1 warning, 4 info
- **2026-08-26** `2924d881cbad`: 1 info
- **2026-08-12** `8ac3f55fbe00`: 1 breaking
- **2026-08-11** `d644f4e74b94`: 1 info

## Changes

- **2026-09-10** `fa1484da1b21`: 2 info
  - added the new optional request property `version/metadata`
  - added the optional property `data/metadata` to the response with the `201` status
- **2026-09-07** `21f0faa20fcc`: 1 breaking, 1 warning, 4 info
  - added `#/components/schemas/PromptMetaInvocationParameters` to the `data/invocation_parameters` response property `oneOf` list for the response status `201`
  - added the new `META` enum value to the `data/model_provider` response property for the response status `201`
  - added `meta` discriminator mapping keys to the `version/invocation_parameters` request property
  - added the new `META` enum value to the request property `version/model_provider`
  - added `#/components/schemas/PromptMetaInvocationParameters` to the `version/invocation_parameters` request property `oneOf` list
  - added `meta` discriminator mapping keys to the `data/invocation_parameters` response property for the response status `201`
- **2026-09-04** `c2502537476f`: 1 warning, 1 info
  - added the new `MINIMAX` enum value to the `data/model_provider` response property for the response status `201`
  - added the new `MINIMAX` enum value to the request property `version/model_provider`
- **2026-09-03** `bd512e4428d3`: 1 breaking, 1 warning, 4 info
  - added `#/components/schemas/PromptZAIInvocationParameters` to the `data/invocation_parameters` response property `oneOf` list for the response status `201`
  - added the new `ZAI` enum value to the `data/model_provider` response property for the response status `201`
  - added `zai` discriminator mapping keys to the `version/invocation_parameters` request property
  - added the new `ZAI` enum value to the request property `version/model_provider`
  - added `#/components/schemas/PromptZAIInvocationParameters` to the `version/invocation_parameters` request property `oneOf` list
  - added `zai` discriminator mapping keys to the `data/invocation_parameters` response property for the response status `201`
- **2026-08-26** `2924d881cbad`: 1 info
  - endpoint added
- **2026-08-12** `8ac3f55fbe00`: 1 breaking
  - api removed without deprecation
- **2026-08-11** `d644f4e74b94`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/arize-ai/apis/arize-phoenix-rest-api/docs/v1/prompts/:prompt_identifier/versions/post.md) - [API](https://skmtc.dev/arize-ai/apis/arize-phoenix-rest-api.md) - [Page](https://skmtc.dev/arize-ai/apis/arize-phoenix-rest-api/changes/v1/prompts/:prompt_identifier/versions/post)