---
title: "Changes to Create a prompt version"
method: POST
path: "/v2/prompts/{prompt_id}/versions"
---

# Changes to Create a prompt version

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

> Every recorded change to this operation, newest first.
> 55 revisions in range; 1 not diffed.

## Timeline

Changed in 4 of 55 revisions.

- **2026-08-27** `9263b98aaefb`: 1 info
- **2026-08-10** `4d95080d8ffb`: 1 breaking, 1 warning
- **2026-08-07** `1e87d8a4cf69`: 4 breaking, 4 warning
- **2026-08-06** `4f94eb2fd1ab`: 25 breaking, 40 warning, 37 info

## Changes

- **2026-08-27** `9263b98aaefb`: 1 info
  - added the optional property `invocation_params/allOf[#/components/schemas/InvocationParams]/service_tier` to the response with the `201` status
- **2026-08-10** `4d95080d8ffb`: 1 breaking, 1 warning
  - added `#/components/schemas/ToolConfigRequest` to the `invocation_params/tool_config` request property `allOf` list
  - removed `#/components/schemas/ToolConfig` from the `invocation_params/tool_config` request property `allOf` list
- **2026-08-07** `1e87d8a4cf69`: 4 breaking, 4 warning
  - added `#/components/schemas/AnthropicHeadersRequest` to the `provider_params/anthropic_headers` request property `allOf` list
  - added `#/components/schemas/AzureParamsRequest` to the `provider_params/azure_params` request property `allOf` list
  - added `#/components/schemas/BedrockOptionsRequest` to the `provider_params/bedrock_options` request property `allOf` list
  - added `#/components/schemas/ResponseFormatRequest` to the `invocation_params/response_format` request property `allOf` list
  - removed `#/components/schemas/AnthropicHeaders` from the `provider_params/anthropic_headers` request property `allOf` list
  - removed `#/components/schemas/AzureParams` from the `provider_params/azure_params` request property `allOf` list
  - removed `#/components/schemas/BedrockOptions` from the `provider_params/bedrock_options` request property `allOf` list
  - removed `#/components/schemas/ResponseFormat` from the `invocation_params/response_format` request property `allOf` list
- **2026-08-06** `4f94eb2fd1ab`: 25 breaking, 40 warning, 37 info
  - added `#/components/schemas/AnthropicHeaders` to the `provider_params/anthropic_headers` request property `allOf` list
  - added `#/components/schemas/AzureParams` to the `provider_params/azure_params` request property `allOf` list
  - added `#/components/schemas/BedrockOptions` to the `provider_params/bedrock_options` request property `allOf` list
  - added `#/components/schemas/ResponseFormat` to the `invocation_params/response_format` request property `allOf` list
  - added `#/components/schemas/ToolConfig` to the `invocation_params/tool_config` request property `allOf` list
  - removed the enum value `assistant` of the request property `messages/items/role`
  - removed the enum value `awsBedrock` of the request property `provider`
  - removed the enum value `azureOpenAI` of the request property `provider`
  - removed the enum value `custom` of the request property `provider`
  - removed the enum value `f_string` of the request property `input_variable_format`
  - removed the enum value `function` of the request property `messages/items/tool_calls/items/type`
  - removed the enum value `mustache` of the request property `input_variable_format`
  - removed the enum value `none` of the request property `input_variable_format`
  - removed the enum value `openAI` of the request property `provider`
  - removed the enum value `system` of the request property `messages/items/role`
  - removed the enum value `tool` of the request property `messages/items/role`
  - removed the enum value `user` of the request property `messages/items/role`
  - removed the enum value `vertexAI` of the request property `provider`
  - the `invocation_params/response_format` request property type changed from `object` to no type
  - the `invocation_params/tool_config` request property type changed from `object` to no type
  - the `provider_params/anthropic_headers` request property type changed from `object` to no type
  - the `provider_params/azure_params` request property type changed from `object` to no type
  - the `provider_params/bedrock_options` request property type changed from `object` to no type
  - the `invocation_params` response's property type changed from `object` to no type for status `201`
  - the `provider_params` response's property type changed from `object` to no type for status `201`
  - removed the request property `invocation_params/response_format/json_schema`
  - removed the request property `invocation_params/response_format/type`
  - removed the request property `invocation_params/tool_config/tool_choice`
  - removed the request property `invocation_params/tool_config/tools`
  - removed the request property `provider_params/anthropic_headers/anthropic_beta`
  - removed the request property `provider_params/azure_params/azure_deployment_name`
  - removed the request property `provider_params/azure_params/azure_openai_endpoint`
  - removed the request property `provider_params/azure_params/azure_openai_version`
  - removed the request property `provider_params/bedrock_options/use_converse_endpoint`
  - removed the request property `provider_params/custom_provider_params`
  - removed the optional property `invocation_params/frequency_penalty` from the response with the `201` status
  - removed the optional property `invocation_params/max_completion_tokens` from the response with the `201` status
  - removed the optional property `invocation_params/max_tokens` from the response with the `201` status
  - removed the optional property `invocation_params/presence_penalty` from the response with the `201` status
  - removed the optional property `invocation_params/response_format` from the response with the `201` status
  - …62 more

---

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