---
title: "Changes to List prompt versions"
method: GET
path: "/v2/prompts/{prompt_id}/versions"
---

# Changes to List prompt versions

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

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

## Timeline

Changed in 2 of 55 revisions.

- **2026-08-27** `9263b98aaefb`: 1 info
- **2026-08-06** `4f94eb2fd1ab`: 2 breaking, 30 warning, 16 info

## Changes

- **2026-08-27** `9263b98aaefb`: 1 info
  - added the optional property `prompt_versions/items/invocation_params/allOf[#/components/schemas/InvocationParams]/service_tier` to the response with the `200` status
- **2026-08-06** `4f94eb2fd1ab`: 2 breaking, 30 warning, 16 info
  - the `prompt_versions/items/invocation_params` response's property type changed from `object` to no type for status `200`
  - the `prompt_versions/items/provider_params` response's property type changed from `object` to no type for status `200`
  - removed the optional property `prompt_versions/items/invocation_params/frequency_penalty` from the response with the `200` status
  - removed the optional property `prompt_versions/items/invocation_params/max_completion_tokens` from the response with the `200` status
  - removed the optional property `prompt_versions/items/invocation_params/max_tokens` from the response with the `200` status
  - removed the optional property `prompt_versions/items/invocation_params/presence_penalty` from the response with the `200` status
  - removed the optional property `prompt_versions/items/invocation_params/response_format` from the response with the `200` status
  - removed the optional property `prompt_versions/items/invocation_params/stop` from the response with the `200` status
  - removed the optional property `prompt_versions/items/invocation_params/temperature` from the response with the `200` status
  - removed the optional property `prompt_versions/items/invocation_params/tool_config` from the response with the `200` status
  - removed the optional property `prompt_versions/items/invocation_params/top_p` from the response with the `200` status
  - removed the optional property `prompt_versions/items/provider_params/anthropic_headers` from the response with the `200` status
  - removed the optional property `prompt_versions/items/provider_params/anthropic_version` from the response with the `200` status
  - removed the optional property `prompt_versions/items/provider_params/azure_params` from the response with the `200` status
  - removed the optional property `prompt_versions/items/provider_params/bedrock_options` from the response with the `200` status
  - removed the optional property `prompt_versions/items/provider_params/custom_provider_params` from the response with the `200` status
  - removed the optional property `prompt_versions/items/provider_params/region` from the response with the `200` status
  - removed the optional property `prompt_versions/items/tool_config` from the response with the `200` status
  - added the new `ANTHROPIC` enum value to the `prompt_versions/items/provider` response property for the response status `200`
  - added the new `ASSISTANT` enum value to the `prompt_versions/items/messages/items/role` response property for the response status `200`
  - added the new `AWS_BEDROCK` enum value to the `prompt_versions/items/provider` response property for the response status `200`
  - added the new `AZURE_OPEN_AI` enum value to the `prompt_versions/items/provider` response property for the response status `200`
  - added the new `CUSTOM` enum value to the `prompt_versions/items/provider` response property for the response status `200`
  - added the new `FUNCTION` enum value to the `prompt_versions/items/messages/items/tool_calls/items/type` response property for the response status `200`
  - added the new `F_STRING` enum value to the `prompt_versions/items/input_variable_format` response property for the response status `200`
  - added the new `MUSTACHE` enum value to the `prompt_versions/items/input_variable_format` response property for the response status `200`
  - added the new `NONE` enum value to the `prompt_versions/items/input_variable_format` response property for the response status `200`
  - added the new `OPEN_AI` enum value to the `prompt_versions/items/provider` response property for the response status `200`
  - added the new `SYSTEM` enum value to the `prompt_versions/items/messages/items/role` response property for the response status `200`
  - added the new `TOOL` enum value to the `prompt_versions/items/messages/items/role` response property for the response status `200`
  - added the new `USER` enum value to the `prompt_versions/items/messages/items/role` response property for the response status `200`
  - added the new `VERTEX_AI` enum value to the `prompt_versions/items/provider` response property for the response status `200`
  - api operation id `prompt_versions_list` removed and replaced with `list_prompt_versions`
  - added `#/components/schemas/InvocationParams` to the `prompt_versions/items/invocation_params` response property `allOf` list for the response status `200`
  - added `#/components/schemas/ProviderParams` to the `prompt_versions/items/provider_params` response property `allOf` list for the response status `200`
  - removed the `assistant` enum value from the `prompt_versions/items/messages/items/role` response property for the response status `200`
  - removed the `awsBedrock` enum value from the `prompt_versions/items/provider` response property for the response status `200`
  - removed the `azureOpenAI` enum value from the `prompt_versions/items/provider` response property for the response status `200`
  - removed the `custom` enum value from the `prompt_versions/items/provider` response property for the response status `200`
  - removed the `f_string` enum value from the `prompt_versions/items/input_variable_format` response property for the response status `200`
  - …8 more

---

[Operation](https://skmtc.dev/arize-ai/apis/arize-rest-api/docs/v2/prompts/:prompt_id/versions/get.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/get)