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

# Changes to List prompt versions

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

> Every recorded change to this operation, newest first.

## Timeline

Changed in 11 of 87 revisions.

- **2026-09-10** `fa1484da1b21`: 1 info
- **2026-09-07** `21f0faa20fcc`: 1 breaking, 1 warning, 1 info
- **2026-09-04** `c2502537476f`: 1 warning
- **2026-09-03** `bd512e4428d3`: 1 breaking, 1 warning, 1 info
- **2026-08-12** `8ac3f55fbe00`: 1 warning, 5 info
- **2026-08-11** `d644f4e74b94`: 1 breaking, 3 warning, 2 info
- **2026-05-05** `56885720e560`: 1 breaking, 1 info
- **2026-04-30** `03775acbfa89`: 1 breaking, 28 info
- **2026-04-29** `02361ac1935f`: 27 warning, 2 info
- **2026-04-29** `885be87470ca`: 1 breaking, 28 info
- **2026-04-29** `c81391216eb5`: 27 warning, 4 info

## Changes

- **2026-09-10** `fa1484da1b21`: 1 info
  - added the optional property `data/items/metadata` to the response with the `200` status
- **2026-09-07** `21f0faa20fcc`: 1 breaking, 1 warning, 1 info
  - added `#/components/schemas/PromptMetaInvocationParameters` to the `data/items/invocation_parameters` response property `oneOf` list for the response status `200`
  - added the new `META` enum value to the `data/items/model_provider` response property for the response status `200`
  - added `meta` discriminator mapping keys to the `data/items/invocation_parameters` response property for the response status `200`
- **2026-09-04** `c2502537476f`: 1 warning
  - added the new `MINIMAX` enum value to the `data/items/model_provider` response property for the response status `200`
- **2026-09-03** `bd512e4428d3`: 1 breaking, 1 warning, 1 info
  - added `#/components/schemas/PromptZAIInvocationParameters` to the `data/items/invocation_parameters` response property `oneOf` list for the response status `200`
  - added the new `ZAI` enum value to the `data/items/model_provider` response property for the response status `200`
  - added `zai` discriminator mapping keys to the `data/items/invocation_parameters` response property for the response status `200`
- **2026-08-12** `8ac3f55fbe00`: 1 warning, 5 info
  - removed the optional property `data/items/metadata` from the response with the `200` status
  - removed `meta, zai` discriminator mapping keys from the `data/items/invocation_parameters` response property for the response status `200`
  - removed the `META` enum value from the `data/items/model_provider` response property for the response status `200`
  - removed the `MINIMAX` enum value from the `data/items/model_provider` response property for the response status `200`
  - removed the `ZAI` enum value from the `data/items/model_provider` response property for the response status `200`
  - removed `#/components/schemas/PromptZAIInvocationParameters, #/components/schemas/PromptMetaInvocationParameters` from the `data/items/invocation_parameters` response property `oneOf` list for the response status `200`
- **2026-08-11** `d644f4e74b94`: 1 breaking, 3 warning, 2 info
  - added `#/components/schemas/PromptZAIInvocationParameters, #/components/schemas/PromptMetaInvocationParameters` to the `data/items/invocation_parameters` response property `oneOf` list for the response status `200`
  - added the new `META` enum value to the `data/items/model_provider` response property for the response status `200`
  - added the new `MINIMAX` enum value to the `data/items/model_provider` response property for the response status `200`
  - added the new `ZAI` enum value to the `data/items/model_provider` response property for the response status `200`
  - added the optional property `data/items/metadata` to the response with the `200` status
  - added `meta, zai` discriminator mapping keys to the `data/items/invocation_parameters` response property for the response status `200`
- **2026-05-05** `56885720e560`: 1 breaking, 1 info
  - added `#/components/schemas/PromptToolRaw` to the `data/items/tools/anyOf[subschema #1: PromptTools]/tools/items/` response property `oneOf` list for the response status `200`
  - added `raw` discriminator mapping keys to the `data/items/tools/anyOf[subschema #1: PromptTools]/tools/items/` response property for the response status `200`
- **2026-04-30** `03775acbfa89`: 1 breaking, 28 info
  - added `#/components/schemas/PromptAnthropicThinkingConfigAdaptive` to the `data/items/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/thinking` response property `oneOf` list for the response status `200`
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #10: PromptFireworksInvocationParameters]/fireworks/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #10: PromptFireworksInvocationParameters]/fireworks/stop` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #11: PromptGroqInvocationParameters]/groq/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #11: PromptGroqInvocationParameters]/groq/stop` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #12: PromptMoonshotInvocationParameters]/moonshot/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #12: PromptMoonshotInvocationParameters]/moonshot/stop` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #13: PromptPerplexityInvocationParameters]/perplexity/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #13: PromptPerplexityInvocationParameters]/perplexity/stop` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #14: PromptTogetherInvocationParameters]/together/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #14: PromptTogetherInvocationParameters]/together/stop` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #1: PromptOpenAIInvocationParameters]/openai/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #1: PromptOpenAIInvocationParameters]/openai/stop` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #2: PromptAzureOpenAIInvocationParameters]/azure_openai/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #2: PromptAzureOpenAIInvocationParameters]/azure_openai/stop` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/output_config` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/thinking/oneOf[subschema #2: PromptAnthropicThinkingConfigEnabled]/display` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #4: PromptGoogleInvocationParameters]/google/thinking_config` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #5: PromptDeepSeekInvocationParameters]/deepseek/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #5: PromptDeepSeekInvocationParameters]/deepseek/stop` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #6: PromptXAIInvocationParameters]/xai/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #6: PromptXAIInvocationParameters]/xai/stop` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #7: PromptOllamaInvocationParameters]/ollama/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #7: PromptOllamaInvocationParameters]/ollama/stop` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #8: PromptAwsInvocationParameters]/aws/stop_sequences` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #9: PromptCerebrasInvocationParameters]/cerebras/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #9: PromptCerebrasInvocationParameters]/cerebras/stop` to the response with the `200` status
  - added `adaptive` discriminator mapping keys to the `data/items/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/thinking` response property for the response status `200`
- **2026-04-29** `02361ac1935f`: 27 warning, 2 info
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #10: PromptFireworksInvocationParameters]/fireworks/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #10: PromptFireworksInvocationParameters]/fireworks/stop` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #11: PromptGroqInvocationParameters]/groq/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #11: PromptGroqInvocationParameters]/groq/stop` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #12: PromptMoonshotInvocationParameters]/moonshot/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #12: PromptMoonshotInvocationParameters]/moonshot/stop` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #13: PromptPerplexityInvocationParameters]/perplexity/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #13: PromptPerplexityInvocationParameters]/perplexity/stop` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #14: PromptTogetherInvocationParameters]/together/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #14: PromptTogetherInvocationParameters]/together/stop` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #1: PromptOpenAIInvocationParameters]/openai/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #1: PromptOpenAIInvocationParameters]/openai/stop` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #2: PromptAzureOpenAIInvocationParameters]/azure_openai/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #2: PromptAzureOpenAIInvocationParameters]/azure_openai/stop` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/output_config` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/thinking/oneOf[subschema #2: PromptAnthropicThinkingConfigEnabled]/display` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #4: PromptGoogleInvocationParameters]/google/thinking_config` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #5: PromptDeepSeekInvocationParameters]/deepseek/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #5: PromptDeepSeekInvocationParameters]/deepseek/stop` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #6: PromptXAIInvocationParameters]/xai/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #6: PromptXAIInvocationParameters]/xai/stop` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #7: PromptOllamaInvocationParameters]/ollama/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #7: PromptOllamaInvocationParameters]/ollama/stop` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #8: PromptAwsInvocationParameters]/aws/stop_sequences` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #9: PromptCerebrasInvocationParameters]/cerebras/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #9: PromptCerebrasInvocationParameters]/cerebras/stop` from the response with the `200` status
  - removed `adaptive` discriminator mapping keys from the `data/items/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/thinking` response property for the response status `200`
  - removed `#/components/schemas/PromptAnthropicThinkingConfigAdaptive` from the `data/items/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/thinking` response property `oneOf` list for the response status `200`
- **2026-04-29** `885be87470ca`: 1 breaking, 28 info
  - added `#/components/schemas/PromptAnthropicThinkingConfigAdaptive` to the `data/items/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/thinking` response property `oneOf` list for the response status `200`
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #10: PromptFireworksInvocationParameters]/fireworks/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #10: PromptFireworksInvocationParameters]/fireworks/stop` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #11: PromptGroqInvocationParameters]/groq/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #11: PromptGroqInvocationParameters]/groq/stop` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #12: PromptMoonshotInvocationParameters]/moonshot/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #12: PromptMoonshotInvocationParameters]/moonshot/stop` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #13: PromptPerplexityInvocationParameters]/perplexity/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #13: PromptPerplexityInvocationParameters]/perplexity/stop` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #14: PromptTogetherInvocationParameters]/together/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #14: PromptTogetherInvocationParameters]/together/stop` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #1: PromptOpenAIInvocationParameters]/openai/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #1: PromptOpenAIInvocationParameters]/openai/stop` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #2: PromptAzureOpenAIInvocationParameters]/azure_openai/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #2: PromptAzureOpenAIInvocationParameters]/azure_openai/stop` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/output_config` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/thinking/oneOf[subschema #2: PromptAnthropicThinkingConfigEnabled]/display` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #4: PromptGoogleInvocationParameters]/google/thinking_config` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #5: PromptDeepSeekInvocationParameters]/deepseek/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #5: PromptDeepSeekInvocationParameters]/deepseek/stop` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #6: PromptXAIInvocationParameters]/xai/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #6: PromptXAIInvocationParameters]/xai/stop` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #7: PromptOllamaInvocationParameters]/ollama/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #7: PromptOllamaInvocationParameters]/ollama/stop` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #8: PromptAwsInvocationParameters]/aws/stop_sequences` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #9: PromptCerebrasInvocationParameters]/cerebras/extra_body` to the response with the `200` status
  - added the optional property `data/items/invocation_parameters/oneOf[subschema #9: PromptCerebrasInvocationParameters]/cerebras/stop` to the response with the `200` status
  - added `adaptive` discriminator mapping keys to the `data/items/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/thinking` response property for the response status `200`
- **2026-04-29** `c81391216eb5`: 27 warning, 4 info
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #10: PromptFireworksInvocationParameters]/fireworks/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #10: PromptFireworksInvocationParameters]/fireworks/stop` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #11: PromptGroqInvocationParameters]/groq/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #11: PromptGroqInvocationParameters]/groq/stop` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #12: PromptMoonshotInvocationParameters]/moonshot/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #12: PromptMoonshotInvocationParameters]/moonshot/stop` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #13: PromptPerplexityInvocationParameters]/perplexity/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #13: PromptPerplexityInvocationParameters]/perplexity/stop` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #14: PromptTogetherInvocationParameters]/together/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #14: PromptTogetherInvocationParameters]/together/stop` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #1: PromptOpenAIInvocationParameters]/openai/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #1: PromptOpenAIInvocationParameters]/openai/stop` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #2: PromptAzureOpenAIInvocationParameters]/azure_openai/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #2: PromptAzureOpenAIInvocationParameters]/azure_openai/stop` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/output_config` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/thinking/oneOf[subschema #2: PromptAnthropicThinkingConfigEnabled]/display` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #4: PromptGoogleInvocationParameters]/google/thinking_config` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #5: PromptDeepSeekInvocationParameters]/deepseek/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #5: PromptDeepSeekInvocationParameters]/deepseek/stop` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #6: PromptXAIInvocationParameters]/xai/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #6: PromptXAIInvocationParameters]/xai/stop` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #7: PromptOllamaInvocationParameters]/ollama/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #7: PromptOllamaInvocationParameters]/ollama/stop` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #8: PromptAwsInvocationParameters]/aws/stop_sequences` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #9: PromptCerebrasInvocationParameters]/cerebras/extra_body` from the response with the `200` status
  - removed the optional property `data/items/invocation_parameters/oneOf[subschema #9: PromptCerebrasInvocationParameters]/cerebras/stop` from the response with the `200` status
  - removed `adaptive` discriminator mapping keys from the `data/items/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/thinking` response property for the response status `200`
  - removed `raw` discriminator mapping keys from the `data/items/tools/anyOf[subschema #1: PromptTools]/tools/items/` response property for the response status `200`
  - removed `#/components/schemas/PromptAnthropicThinkingConfigAdaptive` from the `data/items/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/thinking` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/PromptToolRaw` from the `data/items/tools/anyOf[subschema #1: PromptTools]/tools/items/` response property `oneOf` list for the response status `200`

---

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