--- title: "Changes to Create a prompt version" method: POST path: "/api/prompts/{prompt_id}/versions/" --- # Changes to Create a prompt version `POST /api/prompts/{prompt_id}/versions/` > Every recorded change to this operation, newest first. ## Timeline Changed in 6 of 19 revisions. - **2026-10-21** `c30bcb383ee8`: 33 breaking, 20 info - **2026-10-02** `b830b79cfd52`: 4 warning, 3 info - **2026-09-17** `6fa8242da8c2`: 1 warning, 1 info - **2026-09-12** `22b868ef3f22`: 1 info - **2026-08-13** `4e064cf81dae`: 32 breaking, 20 warning, 22 info - **2026-07-31** `c26d550029f8`: 16 breaking, 6 warning, 52 info ## Changes - **2026-10-21** `c30bcb383ee8`: 33 breaking, 20 info - request body became required - the `messages` request property's minItems was increased to `1` - removed `#/components/schemas/ApiPromptsPromptIdVersionsPostRequestBodyContentApplicationJsonSchemaJsonSchema, subschema #2` from the `json_schema` request property `oneOf` list - removed `#/components/schemas/ApiPromptsPromptIdVersionsPostRequestBodyContentApplicationJsonSchemaResponseFormat, subschema #2` from the `response_format` request property `oneOf` list - removed `#/components/schemas/ApiPromptsPromptIdVersionsPostRequestBodyContentApplicationJsonSchemaThinking, subschema #2` from the `thinking` request property `oneOf` list - removed `subschema #1, subschema #2` from the `messages/items/content` request property `oneOf` list - removed `subschema #1, subschema #2` from the `tool_choice` request property `oneOf` list - the `json_schema` request property type changed from no type to `object` - the `response_format` request property type changed from no type to `object` - the `thinking` request property type changed from no type to `object` - the response property `description` became nullable for the status `201` - the response property `fallback_models` became nullable for the status `201` - the response property `frequency_penalty` became nullable for the status `201` - the response property `json_schema` became nullable for the status `201` - the response property `load_balance_models` became nullable for the status `201` - the response property `max_tokens` became nullable for the status `201` - the response property `presence_penalty` became nullable for the status `201` - the response property `reasoning_effort` became nullable for the status `201` - the response property `response_format` became nullable for the status `201` - the response property `seed` became nullable for the status `201` - the response property `temperature` became nullable for the status `201` - the response property `thinking` became nullable for the status `201` - the response property `tools` became nullable for the status `201` - the response property `top_p` became nullable for the status `201` - the response property `verbosity` became nullable for the status `201` - added `subschema #1, subschema #2` to the `tool_choice` response property `oneOf` list for the response status `201` - the `frequency_penalty` response's property type changed from `number, null` to `number`, and format from `double` to no format for status `201` - the `json_schema` response's property type changed from no type to `object` for status `201` - the `presence_penalty` response's property type changed from `number, null` to `number`, and format from `double` to no format for status `201` - the `response_format` response's property type changed from no type to `object` for status `201` - the `temperature` response's property type changed from `number, null` to `number`, and format from `double` to no format for status `201` - the `thinking` response's property type changed from no type to `object` for status `201` - the `top_p` response's property type changed from `number, null` to `number`, and format from `double` to no format for status `201` - api operation id `prompts_createPromptVersion` removed and replaced with `createPromptVersion` - the endpoint scheme security `DashboardJwt` was added to the API - api tag `Prompts` added - api tag `prompts` removed - the request property `json_schema` became nullable - the request property `reasoning_effort` became nullable - the request property `response_format` became nullable - …13 more - **2026-10-02** `b830b79cfd52`: 4 warning, 3 info - removed the request property `deploy` - removed the optional property `error` from the response with the `400` status - removed the optional property `error` from the response with the `404` status - removed the optional property `is_deployed` from the response with the `201` status - added the non-success response with the status `403` - removed the non-success response with the status `401` - added the required property `detail` to the response with the `404` status - **2026-09-17** `6fa8242da8c2`: 1 warning, 1 info - deleted the `header` request parameter `Authorization` - the endpoint scheme security `RespanApiKey` was added to the API - **2026-09-12** `22b868ef3f22`: 1 info - api operation id `create-prompt-version` removed and replaced with `prompts_createPromptVersion` - **2026-08-13** `4e064cf81dae`: 32 breaking, 20 warning, 22 info - the request property `fallback_models` became not nullable - the request property `frequency_penalty` became not nullable - the request property `load_balance_models` became not nullable - the request property `max_tokens` became not nullable - the request property `presence_penalty` became not nullable - the request property `temperature` became not nullable - the request property `tools` became not nullable - the request property `top_p` became not nullable - the request property `messages` became required - removed `#/components/schemas/PromptChatMessageContent1` from the `messages/items/content` request property `oneOf` list - removed `#/components/schemas/PromptThinkingConfig` from the `thinking` request property `oneOf` list - removed `#/components/schemas/PromptToolChoice, subschema #2` from the `tool_choice` request property `oneOf` list - removed `#/components/schemas/PublicPromptVersionCreateRequestJsonSchema` from the `json_schema` request property `oneOf` list - removed `#/components/schemas/PublicPromptVersionCreateRequestResponseFormat` from the `response_format` request property `oneOf` list - the response property `description` became nullable for the status `201` - the response property `thinking/oneOf[subschema #2]/` became nullable for the status `201` - the response property `edited_by` became optional for the status `201` - the response property `id` became optional for the status `201` - the response property `prompt_version_id` became optional for the status `201` - the response property `readonly` became optional for the status `201` - the response property `updated_at` became optional for the status `201` - the response property `version` became optional for the status `201` - added `#/components/schemas/ApiPromptsPromptIdVersionsPostResponsesContentApplicationJsonSchemaJsonSchema` to the `json_schema` response property `oneOf` list for the response status `201` - added `#/components/schemas/ApiPromptsPromptIdVersionsPostResponsesContentApplicationJsonSchemaResponseFormat` to the `response_format` response property `oneOf` list for the response status `201` - added `#/components/schemas/ApiPromptsPromptIdVersionsPostResponsesContentApplicationJsonSchemaThinking` to the `thinking` response property `oneOf` list for the response status `201` - added `subschema #1, subschema #2` to the `tool_choice` response property `oneOf` list for the response status `201` - the `edited_by` response's property type changed from `integer, null` to `object` for status `201` - removed the required property `messages/items/content` from the response with the `201` status - removed the required property `messages/items/role` from the response with the `201` status - removed the required property `prompt` from the response with the `201` status - removed the required property `tools/items/function` from the response with the `201` status - removed the required property `tools/items/type` from the response with the `201` status - removed the request property `created_at` - removed the request property `load_balance_models/items/credentials` - removed the request property `load_balance_models/items/model` - removed the request property `load_balance_models/items/weight` - removed the request property `messages/items/id` - removed the request property `messages/items/model` - removed the request property `messages/items/tool_call_id` - removed the request property `messages/items/tool_calls` - …34 more - **2026-07-31** `c26d550029f8`: 16 breaking, 6 warning, 52 info - added the new required request property `messages/items/content` - added the new required request property `messages/items/role` - added the new required request property `prompt` - added the new required request property `tools/items/function` - the request property `thinking/oneOf[subschema #2]/` became not nullable - the request property `tool_choice/oneOf[subschema #2]/` became not nullable - removed `#/components/schemas/ApiPromptsPromptIdVersionsPostRequestBodyContentApplicationJsonSchemaJsonSchema` from the `json_schema` request property `oneOf` list - removed `#/components/schemas/ApiPromptsPromptIdVersionsPostRequestBodyContentApplicationJsonSchemaResponseFormat` from the `response_format` request property `oneOf` list - removed `#/components/schemas/ApiPromptsPromptIdVersionsPostRequestBodyContentApplicationJsonSchemaThinking` from the `thinking` request property `oneOf` list - removed `#/components/schemas/ApiPromptsPromptIdVersionsPostRequestBodyContentApplicationJsonSchemaToolChoice` from the `tool_choice` request property `oneOf` list - the response property `edited_by` became nullable for the status `201` - added `#/components/schemas/PromptThinkingConfig` to the `thinking` response property `oneOf` list for the response status `201` - added `#/components/schemas/PromptToolChoice` to the `tool_choice` response property `oneOf` list for the response status `201` - added `#/components/schemas/PublicPromptVersionCreateJsonSchema` to the `json_schema` response property `oneOf` list for the response status `201` - added `#/components/schemas/PublicPromptVersionCreateResponseFormat` to the `response_format` response property `oneOf` list for the response status `201` - the `edited_by` response's property type changed from `object` to `integer, null` for status `201` - removed the request property `deploy` - removed the optional property `edited_by/email` from the response with the `201` status - removed the optional property `edited_by/first_name` from the response with the `201` status - removed the optional property `edited_by/id` from the response with the `201` status - removed the optional property `edited_by/last_name` from the response with the `201` status - removed the optional property `is_deployed` from the response with the `201` status - added the new optional request property `created_at` - added the new optional request property `load_balance_models/items/credentials` - added the new optional request property `load_balance_models/items/model` - added the new optional request property `load_balance_models/items/weight` - added the new optional request property `messages/items/id` - added the new optional request property `messages/items/model` - added the new optional request property `messages/items/tool_call_id` - added the new optional request property `messages/items/tool_calls` - added the new optional request property `parent_prompt` - added the new required request property `tools/items/type` with a default value - the request property `fallback_models` became nullable - the request property `frequency_penalty` became nullable - the request property `load_balance_models` became nullable - the request property `max_tokens` became nullable - the request property `presence_penalty` became nullable - the request property `temperature` became nullable - the request property `tools` became nullable - the request property `top_p` became nullable - …34 more --- [Operation](https://skmtc.dev/keywordsai/apis/respan-api/docs/api/prompts/:prompt_id/versions/post.md) - [API](https://skmtc.dev/keywordsai/apis/respan-api.md) - [Page](https://skmtc.dev/keywordsai/apis/respan-api/changes/api/prompts/:prompt_id/versions/post)