--- title: "Changes to POST /create-agent-version/{agent_id}" method: POST path: "/create-agent-version/{agent_id}" --- # Changes to POST /create-agent-version/{agent_id} `POST /create-agent-version/{agent_id}` > Every recorded change to this operation, newest first. ## Timeline Changed in 9 of 48 revisions. - **2026-10-29** `b982b63b07d0`: 1 warning - **2026-10-26** `6e88894224e1`: 2 warning - **2026-10-26** `474643b1662e`: 12 info - **2026-10-21** `72b7c6dff614`: 8 info - **2026-10-16** `ca41f0dbb297`: 2 breaking, 53 warning, 25 info - **2026-05-18** `6342a9990108`: 2 warning - **2026-05-11** `7c30e3ea2536`: 2 warning - **2026-05-08** `a109c375a367`: 2 warning - **2026-05-07** `f1a0d7c1e36c`: 1 info ## Changes - **2026-10-29** `b982b63b07d0`: 1 warning - added the new `drama-3` enum value to the `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/voice_model` response property for the response status `201` - **2026-10-26** `6e88894224e1`: 2 warning - added the new `gpt-6.1-terra` enum value to the `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` response property for the response status `201` - added the new `gpt-6.1-terra` enum value to the `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_model` response property for the response status `201` - **2026-10-26** `474643b1662e`: 12 info - added the optional property `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/post_session_tools/items/allOf[subschema #1]/oneOf[#/components/schemas/AppTool]/execution_status_variable` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/post_session_tools/items/allOf[subschema #1]/oneOf[#/components/schemas/CodeTool]/execution_status_variable` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/post_session_tools/items/allOf[subschema #1]/oneOf[#/components/schemas/CustomTool]/execution_status_variable` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/pre_session_tools/items/allOf[subschema #1]/oneOf[#/components/schemas/AppTool]/execution_status_variable` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/pre_session_tools/items/allOf[subschema #1]/oneOf[#/components/schemas/CodeTool]/execution_status_variable` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/pre_session_tools/items/allOf[subschema #1]/oneOf[#/components/schemas/CustomTool]/execution_status_variable` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/post_session_tools/items/allOf[subschema #1]/oneOf[#/components/schemas/AppTool]/execution_status_variable` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/post_session_tools/items/allOf[subschema #1]/oneOf[#/components/schemas/CodeTool]/execution_status_variable` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/post_session_tools/items/allOf[subschema #1]/oneOf[#/components/schemas/CustomTool]/execution_status_variable` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/pre_session_tools/items/allOf[subschema #1]/oneOf[#/components/schemas/AppTool]/execution_status_variable` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/pre_session_tools/items/allOf[subschema #1]/oneOf[#/components/schemas/CodeTool]/execution_status_variable` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/pre_session_tools/items/allOf[subschema #1]/oneOf[#/components/schemas/CustomTool]/execution_status_variable` to the response with the `201` status - **2026-10-21** `72b7c6dff614`: 8 info - added the optional property `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/post_session_tools/items/allOf[subschema #1]/oneOf[#/components/schemas/AppTool]/parameters/items/additionalProperties` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/post_session_tools/items/allOf[subschema #1]/oneOf[#/components/schemas/CustomTool]/parameters/additionalProperties` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/pre_session_tools/items/allOf[subschema #1]/oneOf[#/components/schemas/AppTool]/parameters/items/additionalProperties` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/pre_session_tools/items/allOf[subschema #1]/oneOf[#/components/schemas/CustomTool]/parameters/additionalProperties` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/post_session_tools/items/allOf[subschema #1]/oneOf[#/components/schemas/AppTool]/parameters/items/additionalProperties` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/post_session_tools/items/allOf[subschema #1]/oneOf[#/components/schemas/CustomTool]/parameters/additionalProperties` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/pre_session_tools/items/allOf[subschema #1]/oneOf[#/components/schemas/AppTool]/parameters/items/additionalProperties` to the response with the `201` status - added the optional property `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/pre_session_tools/items/allOf[subschema #1]/oneOf[#/components/schemas/CustomTool]/parameters/additionalProperties` to the response with the `201` status - **2026-10-16** `ca41f0dbb297`: 2 breaking, 53 warning, 25 info - added `#/components/schemas/Language` to the `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/language` response property `oneOf` list for the response status `201` - added `#/components/schemas/Language` to the `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/language` response property `oneOf` list for the response status `201` - removed the optional property `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/analysis_successful_prompt` from the response with the `201` status - removed the optional property `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/analysis_summary_prompt` from the response with the `201` status - removed the optional property `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/analysis_user_sentiment_prompt` from the response with the `201` status - removed the optional property `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/voice_emotion` from the response with the `201` status - removed the optional property `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/voicemail_detection_timeout_ms` from the response with the `201` status - removed the optional property `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/voicemail_message` from the response with the `201` status - removed the optional property `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/analysis_successful_prompt` from the response with the `201` status - removed the optional property `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/analysis_summary_prompt` from the response with the `201` status - removed the optional property `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/analysis_user_sentiment_prompt` from the response with the `201` status - added the new `assemblyai` enum value to the `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/custom_stt_config/provider/allOf[#/components/schemas/AsrProvider]/` response property for the response status `201` - added the new `claude-5-opus` enum value to the `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` response property for the response status `201` - added the new `claude-5-opus` enum value to the `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_model` response property for the response status `201` - added the new `claude-5-sonnet` enum value to the `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` response property for the response status `201` - added the new `claude-5-sonnet` enum value to the `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_model` response property for the response status `201` - added the new `claude-5.5-haiku` enum value to the `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` response property for the response status `201` - added the new `claude-5.5-haiku` enum value to the `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_model` response property for the response status `201` - added the new `claude-5.5-opus` enum value to the `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` response property for the response status `201` - added the new `claude-5.5-opus` enum value to the `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_model` response property for the response status `201` - added the new `claude-5.5-sonnet` enum value to the `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` response property for the response status `201` - added the new `claude-5.5-sonnet` enum value to the `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_model` response property for the response status `201` - added the new `eleven_v3_conversational` enum value to the `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/voice_model` response property for the response status `201` - added the new `eleven_v4` enum value to the `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/voice_model` response property for the response status `201` - added the new `eleven_v4_turbo` enum value to the `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/voice_model` response property for the response status `201` - added the new `gemini-3.5-flash` enum value to the `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` response property for the response status `201` - added the new `gemini-3.5-flash` enum value to the `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_model` response property for the response status `201` - added the new `gemini-3.5-flash-lite` enum value to the `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` response property for the response status `201` - added the new `gemini-3.5-flash-lite` enum value to the `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_model` response property for the response status `201` - added the new `gemini-3.6-flash` enum value to the `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` response property for the response status `201` - added the new `gemini-3.6-flash` enum value to the `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_model` response property for the response status `201` - added the new `gemini-3.7-flash` enum value to the `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` response property for the response status `201` - added the new `gemini-3.7-flash` enum value to the `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_model` response property for the response status `201` - added the new `gemini-3.8-flash` enum value to the `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` response property for the response status `201` - added the new `gemini-3.8-flash` enum value to the `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_model` response property for the response status `201` - added the new `gemini-4-argon` enum value to the `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` response property for the response status `201` - added the new `gemini-4-argon` enum value to the `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_model` response property for the response status `201` - added the new `gpt-5.6-luna` enum value to the `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` response property for the response status `201` - added the new `gpt-5.6-luna` enum value to the `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/post_chat_analysis_model` response property for the response status `201` - added the new `gpt-5.6-terra` enum value to the `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` response property for the response status `201` - …40 more - **2026-05-18** `6342a9990108`: 2 warning - removed the optional property `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/is_public` from the response with the `201` status - removed the optional property `oneOf[#/components/schemas/ChatAgentResponse]/allOf[#/components/schemas/ChatAgentRequest]/is_public` from the response with the `201` status - **2026-05-11** `7c30e3ea2536`: 2 warning - added the new `s2.1-pro` enum value to the `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/voice_model` response property for the response status `201` - added the new `sonic-3.5` enum value to the `oneOf[#/components/schemas/AgentResponse]/allOf[#/components/schemas/AgentRequest]/voice_model` response property for the response status `201` - **2026-05-08** `a109c375a367`: 2 warning - removed the optional property `oneOf[#/components/schemas/AgentResponse]/allOf[subschema #3]/response_engine_data` from the response with the `201` status - removed the optional property `oneOf[#/components/schemas/ChatAgentResponse]/allOf[subschema #3]/response_engine_data` from the response with the `201` status - **2026-05-07** `f1a0d7c1e36c`: 1 info - endpoint added --- [Operation](https://skmtc.dev/retellai/apis/retell-sdk/docs/create-agent-version/:agent_id/post.md) - [API](https://skmtc.dev/retellai/apis/retell-sdk.md) - [Page](https://skmtc.dev/retellai/apis/retell-sdk/changes/create-agent-version/:agent_id/post)