--- title: "Changes to POST /v2/create-phone-call" method: POST path: "/v2/create-phone-call" --- # Changes to POST /v2/create-phone-call `POST /v2/create-phone-call` > Every recorded change to this endpoint, newest first. ## Timeline Changed in 21 of 28 revisions. - **2026-05-28** `40402ca870b9` — 2 breaking, 2 warning - **2026-05-18** `6342a9990108` — 2 breaking, 1 warning - **2026-05-12** `6dff2a12f866` — 3 breaking - **2026-05-11** `7c30e3ea2536` — 3 info - **2026-05-08** `7dd16ddf69d8` — 1 warning - **2026-05-07** `f1a0d7c1e36c` — 3 breaking, 5 info - **2026-04-28** `1b4a9d84942a` — 5 breaking, 3 info - **2026-04-27** `a44406f743c2` — 65 breaking, 1 info - **2026-04-20** `8ee53928bf31` — 2 warning, 7 info - **2026-04-01** `56de19127afb` — 1 breaking, 3 info - **2026-03-19** `3aa6f6e028ef` — 4 breaking, 6 info - **2026-03-17** `424df3aa7900` — 1 warning, 4 info - **2026-03-09** `8fbf8c54a142` — 7 breaking, 2 warning, 9 info - **2026-02-26** `e89903d2c910` — 3 warning, 1 info - **2026-02-23** `bcff6899fa2a` — 6 info - **2026-02-18** `fa2738401683` — 1 warning - **2026-02-11** `076d0088c7ed` — 2 info - **2026-02-10** `0bf5cea5dfcc` — 6 warning, 2 info - **2026-02-06** `dfad228ab4a4` — 1 breaking, 3 info - **2026-01-23** `427e77039f39` — 1 breaking, 10 info - **2026-01-19** `9dbbdaf34f4b` — 1 info ## Changes - **2026-05-28** `40402ca870b9` — 2 breaking, 2 warning - added `#/components/schemas/InjectedUtterance` to the `allOf[#/components/schemas/V2CallBase]/scrubbed_transcript_with_tool_calls/items/` response property `oneOf` list for the response status `201` - added `#/components/schemas/InjectedUtterance` to the `allOf[#/components/schemas/V2CallBase]/transcript_with_tool_calls/items/` response property `oneOf` list for the response status `201` - changed the pattern of the request property `override_agent_version/oneOf[subschema #2]/` from `^(latest|(?!(?:v\d+)$)[a-z][a-z0-9_-]{0,19})$` to `^(latest|latest_published|(?!(?:latest|latest_published|v\d+)$)[a-z][a-z0-9_-]{0,19})$` - added the new `no_concurrency_fallback` enum value to the `allOf[#/components/schemas/V2CallBase]/disconnection_reason` response property for the response status `201` - **2026-05-18** `6342a9990108` — 2 breaking, 1 warning - added `#/components/schemas/SmsUtterance` to the `allOf[#/components/schemas/V2CallBase]/scrubbed_transcript_with_tool_calls/items/` response property `oneOf` list for the response status `201` - added `#/components/schemas/SmsUtterance` to the `allOf[#/components/schemas/V2CallBase]/transcript_with_tool_calls/items/` response property `oneOf` list for the response status `201` - removed the request property `agent_override/agent/is_public` - **2026-05-12** `6dff2a12f866` — 3 breaking - the `retell_llm_dynamic_variables/additionalProperties/` request property type changed from no type to `string` - the `allOf[#/components/schemas/V2CallBase]/collected_dynamic_variables/additionalProperties/` response's property type changed from no type to `string` for status `201` - the `allOf[#/components/schemas/V2CallBase]/retell_llm_dynamic_variables/additionalProperties/` response's property type changed from no type to `string` for status `201` - **2026-05-11** `7c30e3ea2536` — 3 info - added the new `gpt-realtime-2` enum value to the request property `agent_override/retell_llm/s2s_model` - added the new `s2.1-pro` enum value to the request property `agent_override/agent/voice_model` - added the new `sonic-3.5` enum value to the request property `agent_override/agent/voice_model` - **2026-05-08** `7dd16ddf69d8` — 1 warning - changed the pattern of the request property `override_agent_version/oneOf[subschema #2]/` from `^[a-z0-9_-]+$` to `^(latest|(?!(?:v\d+)$)[a-z][a-z0-9_-]{0,19})$` - **2026-05-07** `f1a0d7c1e36c` — 3 breaking, 5 info - removed the enum value `gemini-2.5-flash` of the request property `agent_override/agent/post_call_analysis_model` - removed the enum value `gemini-2.5-flash` of the request property `agent_override/conversation_flow/model_choice/oneOf[#/components/schemas/ModelChoiceCascading]/model` - removed the enum value `gemini-2.5-flash` of the request property `agent_override/retell_llm/model` - added the new optional request property `agent_override/agent/allow_dtmf_interruption` - added the new optional request property `agent_override/agent/call_screening_option` - added the new optional request property `agent_override/agent/ivr_option/detection_prompt` - added the new optional request property `agent_override/agent/voicemail_option/detection_prompt` - request property `override_agent_version` list-of-types was widened by adding types `string` to media type `application/json` - **2026-04-28** `1b4a9d84942a` — 5 breaking, 3 info - added `#/components/schemas/AsrProvider` to the `agent_override/agent/custom_stt_config/provider` request property `allOf` list - removed the enum value `azure` of the request property `agent_override/agent/custom_stt_config/provider` - removed the enum value `deepgram` of the request property `agent_override/agent/custom_stt_config/provider` - removed the enum value `soniox` of the request property `agent_override/agent/custom_stt_config/provider` - the `agent_override/agent/custom_stt_config/provider` request property type changed from `string` to no type - added the new `gpt-5.5` enum value to the request property `agent_override/agent/post_call_analysis_model` - added the new `gpt-5.5` enum value to the request property `agent_override/conversation_flow/model_choice/oneOf[#/components/schemas/ModelChoiceCascading]/model` - added the new `gpt-5.5` enum value to the request property `agent_override/retell_llm/model` - **2026-04-27** `a44406f743c2` — 65 breaking, 1 info - removed the enum value `af-ZA` of the request property `agent_override/agent/language` - removed the enum value `ar-SA` of the request property `agent_override/agent/language` - removed the enum value `az-AZ` of the request property `agent_override/agent/language` - removed the enum value `bg-BG` of the request property `agent_override/agent/language` - removed the enum value `bs-BA` of the request property `agent_override/agent/language` - removed the enum value `ca-ES` of the request property `agent_override/agent/language` - removed the enum value `cs-CZ` of the request property `agent_override/agent/language` - removed the enum value `cy-GB` of the request property `agent_override/agent/language` - removed the enum value `da-DK` of the request property `agent_override/agent/language` - removed the enum value `de-DE` of the request property `agent_override/agent/language` - removed the enum value `el-GR` of the request property `agent_override/agent/language` - removed the enum value `en-AU` of the request property `agent_override/agent/language` - removed the enum value `en-GB` of the request property `agent_override/agent/language` - removed the enum value `en-IN` of the request property `agent_override/agent/language` - removed the enum value `en-NZ` of the request property `agent_override/agent/language` - removed the enum value `en-US` of the request property `agent_override/agent/language` - removed the enum value `es-419` of the request property `agent_override/agent/language` - removed the enum value `es-ES` of the request property `agent_override/agent/language` - removed the enum value `fa-IR` of the request property `agent_override/agent/language` - removed the enum value `fi-FI` of the request property `agent_override/agent/language` - removed the enum value `fil-PH` of the request property `agent_override/agent/language` - removed the enum value `fr-CA` of the request property `agent_override/agent/language` - removed the enum value `fr-FR` of the request property `agent_override/agent/language` - removed the enum value `gl-ES` of the request property `agent_override/agent/language` - removed the enum value `he-IL` of the request property `agent_override/agent/language` - removed the enum value `hi-IN` of the request property `agent_override/agent/language` - removed the enum value `hr-HR` of the request property `agent_override/agent/language` - removed the enum value `hu-HU` of the request property `agent_override/agent/language` - removed the enum value `hy-AM` of the request property `agent_override/agent/language` - removed the enum value `id-ID` of the request property `agent_override/agent/language` - removed the enum value `is-IS` of the request property `agent_override/agent/language` - removed the enum value `it-IT` of the request property `agent_override/agent/language` - removed the enum value `ja-JP` of the request property `agent_override/agent/language` - removed the enum value `kk-KZ` of the request property `agent_override/agent/language` - removed the enum value `kn-IN` of the request property `agent_override/agent/language` - removed the enum value `ko-KR` of the request property `agent_override/agent/language` - removed the enum value `lt-LT` of the request property `agent_override/agent/language` - removed the enum value `lv-LV` of the request property `agent_override/agent/language` - removed the enum value `mk-MK` of the request property `agent_override/agent/language` - removed the enum value `mr-IN` of the request property `agent_override/agent/language` - …26 more - **2026-04-20** `8ee53928bf31` — 2 warning, 7 info - removed the request property `agent_override/agent/normalize_for_speech` - added the new `manual_stopped` enum value to the `allOf[#/components/schemas/V2CallBase]/disconnection_reason` response property for the response status `201` - added the new `gemini-3.1-flash-lite` enum value to the request property `agent_override/agent/post_call_analysis_model` - added the new `gemini-3.1-flash-lite` enum value to the request property `agent_override/conversation_flow/model_choice/oneOf[#/components/schemas/ModelChoiceCascading]/model` - added the new `gemini-3.1-flash-lite` enum value to the request property `agent_override/retell_llm/model` - added the new `s2-pro` enum value to the request property `agent_override/agent/voice_model` - added the new `soniox` enum value to the request property `agent_override/agent/custom_stt_config/provider` - added the optional property `allOf[#/components/schemas/V2CallBase]/scrubbed_transcript_with_tool_calls/items/oneOf[#/components/schemas/NodeTransitionUtterance]/transition_type` to the response with the `201` status - added the optional property `allOf[#/components/schemas/V2CallBase]/transcript_with_tool_calls/items/oneOf[#/components/schemas/NodeTransitionUtterance]/transition_type` to the response with the `201` status - **2026-04-01** `56de19127afb` — 1 breaking, 3 info - removed `#/components/schemas/StringAnalysisData, #/components/schemas/EnumAnalysisData, #/components/schemas/BooleanAnalysisData, #/components/schemas/NumberAnalysisData` from the `agent_override/agent/post_call_analysis_data/items/` request property `oneOf` list - added the new optional request property `agent_override/agent/handbook_config` - added the new optional request property `agent_override/agent/timezone` - added `#/components/schemas/AnalysisData, #/components/schemas/CallPresetAnalysisData` to the `agent_override/agent/post_call_analysis_data/items/` request property `oneOf` list - **2026-03-19** `3aa6f6e028ef` — 4 breaking, 6 info - removed the enum value `gpt-4o-mini-realtime` of the request property `agent_override/retell_llm/s2s_model` - removed the enum value `gpt-4o-realtime` of the request property `agent_override/retell_llm/s2s_model` - removed the enum value `sonic-2` of the request property `agent_override/agent/voice_model` - removed the enum value `sonic-turbo` of the request property `agent_override/agent/voice_model` - added the new `gpt-5.4-mini` enum value to the request property `agent_override/agent/post_call_analysis_model` - added the new `gpt-5.4-mini` enum value to the request property `agent_override/conversation_flow/model_choice/oneOf[#/components/schemas/ModelChoiceCascading]/model` - added the new `gpt-5.4-mini` enum value to the request property `agent_override/retell_llm/model` - added the new `gpt-5.4-nano` enum value to the request property `agent_override/agent/post_call_analysis_model` - added the new `gpt-5.4-nano` enum value to the request property `agent_override/conversation_flow/model_choice/oneOf[#/components/schemas/ModelChoiceCascading]/model` - added the new `gpt-5.4-nano` enum value to the request property `agent_override/retell_llm/model` - **2026-03-17** `424df3aa7900` — 1 warning, 4 info - removed the request property `agent_override/agent/enable_voicemail_detection` - added the new `gpt-5.4` enum value to the request property `agent_override/agent/post_call_analysis_model` - added the new `gpt-5.4` enum value to the request property `agent_override/conversation_flow/model_choice/oneOf[#/components/schemas/ModelChoiceCascading]/model` - added the new `gpt-5.4` enum value to the request property `agent_override/retell_llm/model` - added the new `gpt-realtime-1.5` enum value to the request property `agent_override/retell_llm/s2s_model` - **2026-03-09** `8fbf8c54a142` — 7 breaking, 2 warning, 9 info - the `agent_override/agent/post_call_analysis_data/items/oneOf[#/components/schemas/BooleanAnalysisData]/name` request property's minLength was increased from `0` to `1` - the `agent_override/agent/post_call_analysis_data/items/oneOf[#/components/schemas/EnumAnalysisData]/name` request property's minLength was increased from `0` to `1` - the `agent_override/agent/post_call_analysis_data/items/oneOf[#/components/schemas/NumberAnalysisData]/name` request property's minLength was increased from `0` to `1` - the `agent_override/agent/post_call_analysis_data/items/oneOf[#/components/schemas/StringAnalysisData]/name` request property's minLength was increased from `0` to `1` - the `from_number` request property's minLength was increased from `0` to `1` - the `override_agent_id` request property's minLength was increased from `0` to `1` - the `to_number` request property's minLength was increased from `0` to `1` - the `agent_override/agent/ring_duration_ms` request property's max was set to `300000.00` - the `agent_override/agent/ring_duration_ms` request property's min was set to `5000.00` - added the new optional request property `agent_override/agent/post_call_analysis_data/items/oneOf[#/components/schemas/BooleanAnalysisData]/required` - added the new optional request property `agent_override/agent/post_call_analysis_data/items/oneOf[#/components/schemas/EnumAnalysisData]/required` - added the new optional request property `agent_override/agent/post_call_analysis_data/items/oneOf[#/components/schemas/NumberAnalysisData]/required` - added the new optional request property `agent_override/agent/post_call_analysis_data/items/oneOf[#/components/schemas/StringAnalysisData]/required` - the request property `agent_override/agent/custom_stt_config` became nullable - added the new `claude-4.6-sonnet` enum value to the request property `agent_override/agent/post_call_analysis_model` - added the new `claude-4.6-sonnet` enum value to the request property `agent_override/conversation_flow/model_choice/oneOf[#/components/schemas/ModelChoiceCascading]/model` - added the new `claude-4.6-sonnet` enum value to the request property `agent_override/retell_llm/model` - added the new `eleven_v3` enum value to the request property `agent_override/agent/voice_model` - **2026-02-26** `e89903d2c910` — 3 warning, 1 info - added the new `ivr_reached` enum value to the `allOf[#/components/schemas/V2CallBase]/disconnection_reason` response property for the response status `201` - added the new `transfer_bridged` enum value to the `allOf[#/components/schemas/V2CallBase]/disconnection_reason` response property for the response status `201` - added the new `transfer_cancelled` enum value to the `allOf[#/components/schemas/V2CallBase]/disconnection_reason` response property for the response status `201` - added the new optional request property `agent_override/agent/enable_dynamic_responsiveness` - **2026-02-23** `bcff6899fa2a` — 6 info - added the new optional request property `agent_override/agent/analysis_user_sentiment_prompt` - added the new optional request property `agent_override/agent/data_storage_retention_days` - added the new `s1` enum value to the request property `agent_override/agent/voice_model` - added the optional property `allOf[#/components/schemas/V2CallBase]/scrubbed_transcript_with_tool_calls/items/oneOf[#/components/schemas/ToolCallResultUtterance]/successful` to the response with the `201` status - added the optional property `allOf[#/components/schemas/V2CallBase]/transcript_with_tool_calls/items/oneOf[#/components/schemas/ToolCallResultUtterance]/successful` to the response with the `201` status - removed the `ivr_reached` enum value from the `allOf[#/components/schemas/V2CallBase]/disconnection_reason` response property for the response status `201` - **2026-02-18** `fa2738401683` — 1 warning - added the new `ivr_reached` enum value to the `allOf[#/components/schemas/V2CallBase]/disconnection_reason` response property for the response status `201` - **2026-02-11** `076d0088c7ed` — 2 info - added the new `cs-CZ` enum value to the request property `agent_override/agent/language` - added the new `speech-2.8-turbo` enum value to the request property `agent_override/agent/voice_model` - **2026-02-10** `0bf5cea5dfcc` — 6 warning, 2 info - the `agent_override/agent/interruption_sensitivity` request property's max was set to `1.00` - the `agent_override/agent/responsiveness` request property's max was set to `1.00` - the `agent_override/agent/voice_speed` request property's max was set to `2.00` - the `agent_override/agent/interruption_sensitivity` request property's min was set to `0.00` - the `agent_override/agent/responsiveness` request property's min was set to `0.00` - the `agent_override/agent/voice_speed` request property's min was set to `0.50` - added the new optional request property `agent_override/agent/webhook_events` - added the optional property `allOf[#/components/schemas/V2CallBase]/call_cost/product_costs/items/is_transfer_leg_cost` to the response with the `201` status - **2026-02-06** `dfad228ab4a4` — 1 breaking, 3 info - removed the enum value `none` of the request property `agent_override/agent/denoising_mode` - added the new optional request property `agent_override/agent/enable_dynamic_voice_speed` - added the new optional request property `agent_override/agent/guardrail_config` - added the new `no-denoise` enum value to the request property `agent_override/agent/denoising_mode` - **2026-01-23** `427e77039f39` — 1 breaking, 10 info - request property `agent_override/agent/voice_emotion` was restricted to a list of enum values - added the new `angry` enum value to the request property `agent_override/agent/voice_emotion` - added the new `calm` enum value to the request property `agent_override/agent/voice_emotion` - added the new `fearful` enum value to the request property `agent_override/agent/voice_emotion` - added the new `happy` enum value to the request property `agent_override/agent/voice_emotion` - added the new `none` enum value to the request property `agent_override/agent/denoising_mode` - added the new `sad` enum value to the request property `agent_override/agent/voice_emotion` - added the new `surprised` enum value to the request property `agent_override/agent/voice_emotion` - added the new `sympathetic` enum value to the request property `agent_override/agent/voice_emotion` - added the new `undefined` enum value to the request property `agent_override/agent/voice_emotion` - added the optional property `allOf[#/components/schemas/V2CallBase]/transfer_end_timestamp` to the response with the `201` status - **2026-01-19** `9dbbdaf34f4b` — 1 info - added the new optional request property `agent_override/agent/voice_emotion` --- [Operation](https://skmtc.dev/retellai/apis/retell-sdk/docs/v2/create-phone-call/post.md) · [API](https://skmtc.dev/retellai/apis/retell-sdk.md) · [Page](https://skmtc.dev/retellai/apis/retell-sdk/changes/v2/create-phone-call/post)