---
title: "Changes to Create a new prompt"
method: POST
path: "/v1/prompts"
---

# Changes to Create a new prompt

`POST /v1/prompts`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 70 revisions.

- **2026-05-05** `56885720e560` — 1 breaking, 3 info
- **2026-04-29** `885be87470ca` — 1 breaking, 57 info
- **2026-04-29** `c81391216eb5` — 2 breaking, 54 warning, 6 info

## Changes

- **2026-05-05** `56885720e560` — 1 breaking, 3 info
  - added `#/components/schemas/PromptToolRaw` to the `data/tools/anyOf[subschema #1: PromptTools]/tools/items/` response property `oneOf` list for the response status `200`
  - added `raw` discriminator mapping keys to the `version/tools/anyOf[subschema #1: PromptTools]/tools/items/` request property
  - added `#/components/schemas/PromptToolRaw` to the `version/tools/anyOf[subschema #1: PromptTools]/tools/items/` request property `oneOf` list
  - added `raw` discriminator mapping keys to the `data/tools/anyOf[subschema #1: PromptTools]/tools/items/` response property for the response status `200`
- **2026-04-29** `885be87470ca` — 1 breaking, 57 info
  - added `#/components/schemas/PromptAnthropicThinkingConfigAdaptive` to the `data/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/thinking` response property `oneOf` list for the response status `200`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #10: PromptFireworksInvocationParameters]/fireworks/extra_body`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #10: PromptFireworksInvocationParameters]/fireworks/stop`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #11: PromptGroqInvocationParameters]/groq/extra_body`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #11: PromptGroqInvocationParameters]/groq/stop`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #12: PromptMoonshotInvocationParameters]/moonshot/extra_body`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #12: PromptMoonshotInvocationParameters]/moonshot/stop`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #13: PromptPerplexityInvocationParameters]/perplexity/extra_body`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #13: PromptPerplexityInvocationParameters]/perplexity/stop`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #14: PromptTogetherInvocationParameters]/together/extra_body`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #14: PromptTogetherInvocationParameters]/together/stop`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #1: PromptOpenAIInvocationParameters]/openai/extra_body`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #1: PromptOpenAIInvocationParameters]/openai/stop`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #2: PromptAzureOpenAIInvocationParameters]/azure_openai/extra_body`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #2: PromptAzureOpenAIInvocationParameters]/azure_openai/stop`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/extra_body`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/output_config`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/thinking/oneOf[subschema #2: PromptAnthropicThinkingConfigEnabled]/display`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #4: PromptGoogleInvocationParameters]/google/thinking_config`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #5: PromptDeepSeekInvocationParameters]/deepseek/extra_body`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #5: PromptDeepSeekInvocationParameters]/deepseek/stop`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #6: PromptXAIInvocationParameters]/xai/extra_body`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #6: PromptXAIInvocationParameters]/xai/stop`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #7: PromptOllamaInvocationParameters]/ollama/extra_body`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #7: PromptOllamaInvocationParameters]/ollama/stop`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #8: PromptAwsInvocationParameters]/aws/stop_sequences`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #9: PromptCerebrasInvocationParameters]/cerebras/extra_body`
  - added the new optional request property `version/invocation_parameters/oneOf[subschema #9: PromptCerebrasInvocationParameters]/cerebras/stop`
  - added `adaptive` discriminator mapping keys to the `version/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/thinking` request property
  - added `#/components/schemas/PromptAnthropicThinkingConfigAdaptive` to the `version/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/thinking` request property `oneOf` list
  - added the optional property `data/invocation_parameters/oneOf[subschema #10: PromptFireworksInvocationParameters]/fireworks/extra_body` to the response with the `200` status
  - added the optional property `data/invocation_parameters/oneOf[subschema #10: PromptFireworksInvocationParameters]/fireworks/stop` to the response with the `200` status
  - added the optional property `data/invocation_parameters/oneOf[subschema #11: PromptGroqInvocationParameters]/groq/extra_body` to the response with the `200` status
  - added the optional property `data/invocation_parameters/oneOf[subschema #11: PromptGroqInvocationParameters]/groq/stop` to the response with the `200` status
  - added the optional property `data/invocation_parameters/oneOf[subschema #12: PromptMoonshotInvocationParameters]/moonshot/extra_body` to the response with the `200` status
  - added the optional property `data/invocation_parameters/oneOf[subschema #12: PromptMoonshotInvocationParameters]/moonshot/stop` to the response with the `200` status
  - added the optional property `data/invocation_parameters/oneOf[subschema #13: PromptPerplexityInvocationParameters]/perplexity/extra_body` to the response with the `200` status
  - added the optional property `data/invocation_parameters/oneOf[subschema #13: PromptPerplexityInvocationParameters]/perplexity/stop` to the response with the `200` status
  - added the optional property `data/invocation_parameters/oneOf[subschema #14: PromptTogetherInvocationParameters]/together/extra_body` to the response with the `200` status
  - added the optional property `data/invocation_parameters/oneOf[subschema #14: PromptTogetherInvocationParameters]/together/stop` to the response with the `200` status
  - …18 more
- **2026-04-29** `c81391216eb5` — 2 breaking, 54 warning, 6 info
  - removed `#/components/schemas/PromptAnthropicThinkingConfigAdaptive` from the `version/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/thinking` request property `oneOf` list
  - removed `#/components/schemas/PromptToolRaw` from the `version/tools/anyOf[subschema #1: PromptTools]/tools/items/` request property `oneOf` list
  - removed the request property `version/invocation_parameters/oneOf[subschema #10: PromptFireworksInvocationParameters]/fireworks/extra_body`
  - removed the request property `version/invocation_parameters/oneOf[subschema #10: PromptFireworksInvocationParameters]/fireworks/stop`
  - removed the request property `version/invocation_parameters/oneOf[subschema #11: PromptGroqInvocationParameters]/groq/extra_body`
  - removed the request property `version/invocation_parameters/oneOf[subschema #11: PromptGroqInvocationParameters]/groq/stop`
  - removed the request property `version/invocation_parameters/oneOf[subschema #12: PromptMoonshotInvocationParameters]/moonshot/extra_body`
  - removed the request property `version/invocation_parameters/oneOf[subschema #12: PromptMoonshotInvocationParameters]/moonshot/stop`
  - removed the request property `version/invocation_parameters/oneOf[subschema #13: PromptPerplexityInvocationParameters]/perplexity/extra_body`
  - removed the request property `version/invocation_parameters/oneOf[subschema #13: PromptPerplexityInvocationParameters]/perplexity/stop`
  - removed the request property `version/invocation_parameters/oneOf[subschema #14: PromptTogetherInvocationParameters]/together/extra_body`
  - removed the request property `version/invocation_parameters/oneOf[subschema #14: PromptTogetherInvocationParameters]/together/stop`
  - removed the request property `version/invocation_parameters/oneOf[subschema #1: PromptOpenAIInvocationParameters]/openai/extra_body`
  - removed the request property `version/invocation_parameters/oneOf[subschema #1: PromptOpenAIInvocationParameters]/openai/stop`
  - removed the request property `version/invocation_parameters/oneOf[subschema #2: PromptAzureOpenAIInvocationParameters]/azure_openai/extra_body`
  - removed the request property `version/invocation_parameters/oneOf[subschema #2: PromptAzureOpenAIInvocationParameters]/azure_openai/stop`
  - removed the request property `version/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/extra_body`
  - removed the request property `version/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/output_config`
  - removed the request property `version/invocation_parameters/oneOf[subschema #3: PromptAnthropicInvocationParameters]/anthropic/thinking/oneOf[subschema #2: PromptAnthropicThinkingConfigEnabled]/display`
  - removed the request property `version/invocation_parameters/oneOf[subschema #4: PromptGoogleInvocationParameters]/google/thinking_config`
  - removed the request property `version/invocation_parameters/oneOf[subschema #5: PromptDeepSeekInvocationParameters]/deepseek/extra_body`
  - removed the request property `version/invocation_parameters/oneOf[subschema #5: PromptDeepSeekInvocationParameters]/deepseek/stop`
  - removed the request property `version/invocation_parameters/oneOf[subschema #6: PromptXAIInvocationParameters]/xai/extra_body`
  - removed the request property `version/invocation_parameters/oneOf[subschema #6: PromptXAIInvocationParameters]/xai/stop`
  - removed the request property `version/invocation_parameters/oneOf[subschema #7: PromptOllamaInvocationParameters]/ollama/extra_body`
  - removed the request property `version/invocation_parameters/oneOf[subschema #7: PromptOllamaInvocationParameters]/ollama/stop`
  - removed the request property `version/invocation_parameters/oneOf[subschema #8: PromptAwsInvocationParameters]/aws/stop_sequences`
  - removed the request property `version/invocation_parameters/oneOf[subschema #9: PromptCerebrasInvocationParameters]/cerebras/extra_body`
  - removed the request property `version/invocation_parameters/oneOf[subschema #9: PromptCerebrasInvocationParameters]/cerebras/stop`
  - removed the optional property `data/invocation_parameters/oneOf[subschema #10: PromptFireworksInvocationParameters]/fireworks/extra_body` from the response with the `200` status
  - removed the optional property `data/invocation_parameters/oneOf[subschema #10: PromptFireworksInvocationParameters]/fireworks/stop` from the response with the `200` status
  - removed the optional property `data/invocation_parameters/oneOf[subschema #11: PromptGroqInvocationParameters]/groq/extra_body` from the response with the `200` status
  - removed the optional property `data/invocation_parameters/oneOf[subschema #11: PromptGroqInvocationParameters]/groq/stop` from the response with the `200` status
  - removed the optional property `data/invocation_parameters/oneOf[subschema #12: PromptMoonshotInvocationParameters]/moonshot/extra_body` from the response with the `200` status
  - removed the optional property `data/invocation_parameters/oneOf[subschema #12: PromptMoonshotInvocationParameters]/moonshot/stop` from the response with the `200` status
  - removed the optional property `data/invocation_parameters/oneOf[subschema #13: PromptPerplexityInvocationParameters]/perplexity/extra_body` from the response with the `200` status
  - removed the optional property `data/invocation_parameters/oneOf[subschema #13: PromptPerplexityInvocationParameters]/perplexity/stop` from the response with the `200` status
  - removed the optional property `data/invocation_parameters/oneOf[subschema #14: PromptTogetherInvocationParameters]/together/extra_body` from the response with the `200` status
  - removed the optional property `data/invocation_parameters/oneOf[subschema #14: PromptTogetherInvocationParameters]/together/stop` from the response with the `200` status
  - removed the optional property `data/invocation_parameters/oneOf[subschema #1: PromptOpenAIInvocationParameters]/openai/extra_body` from the response with the `200` status
  - …22 more

---

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