--- title: "Changes to POST /create-agent" method: POST path: "/create-agent" --- # Changes to POST /create-agent `POST /create-agent` > Every recorded change to this endpoint, newest first. ## Timeline Changed in 18 of 28 revisions. - **2026-05-18** `6342a9990108` — 2 warning - **2026-05-11** `7c30e3ea2536` — 2 warning, 2 info - **2026-05-08** `a109c375a367` — 1 warning - **2026-05-07** `f1a0d7c1e36c` — 1 breaking, 11 info - **2026-04-28** `1b4a9d84942a` — 6 breaking, 1 warning, 5 info - **2026-04-27** `a44406f743c2` — 67 breaking, 65 info - **2026-04-20** `8ee53928bf31` — 5 warning, 3 info - **2026-04-01** `56de19127afb` — 2 breaking, 6 info - **2026-03-19** `3aa6f6e028ef` — 2 breaking, 2 warning, 4 info - **2026-03-17** `424df3aa7900` — 3 warning, 1 info - **2026-03-09** `8fbf8c54a142` — 5 breaking, 4 warning, 11 info - **2026-02-26** `e89903d2c910` — 2 info - **2026-02-23** `bcff6899fa2a` — 1 warning, 5 info - **2026-02-11** `076d0088c7ed` — 2 warning, 2 info - **2026-02-10** `0bf5cea5dfcc` — 6 warning, 2 info - **2026-02-06** `dfad228ab4a4` — 1 breaking, 1 warning, 6 info - **2026-01-23** `427e77039f39` — 1 breaking, 9 warning, 9 info - **2026-01-19** `9dbbdaf34f4b` — 2 info ## Changes - **2026-05-18** `6342a9990108` — 2 warning - removed the request property `allOf[#/components/schemas/AgentRequest]/is_public` - removed the optional property `allOf[#/components/schemas/AgentRequest]/is_public` from the response with the `201` status - **2026-05-11** `7c30e3ea2536` — 2 warning, 2 info - added the new `s2.1-pro` enum value to the `allOf[#/components/schemas/AgentRequest]/voice_model` response property for the response status `201` - added the new `sonic-3.5` enum value to the `allOf[#/components/schemas/AgentRequest]/voice_model` response property for the response status `201` - added the new `s2.1-pro` enum value to the request property `allOf[#/components/schemas/AgentRequest]/voice_model` - added the new `sonic-3.5` enum value to the request property `allOf[#/components/schemas/AgentRequest]/voice_model` - **2026-05-08** `a109c375a367` — 1 warning - removed the optional property `allOf[subschema #3]/response_engine_data` from the response with the `201` status - **2026-05-07** `f1a0d7c1e36c` — 1 breaking, 11 info - removed the enum value `gemini-2.5-flash` of the request property `allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` - added the new optional request property `allOf[#/components/schemas/AgentRequest]/allow_dtmf_interruption` - added the new optional request property `allOf[#/components/schemas/AgentRequest]/call_screening_option` - added the new optional request property `allOf[#/components/schemas/AgentRequest]/ivr_option/detection_prompt` - added the new optional request property `allOf[#/components/schemas/AgentRequest]/voicemail_option/detection_prompt` - added `subschema #1, subschema #3` to the response body `allOf` list for the response status `201` - removed `subschema #1, subschema #3` from the response body `allOf` list for the response status `201` - added the optional property `allOf[#/components/schemas/AgentRequest]/allow_dtmf_interruption` to the response with the `201` status - added the optional property `allOf[#/components/schemas/AgentRequest]/call_screening_option` to the response with the `201` status - added the optional property `allOf[#/components/schemas/AgentRequest]/ivr_option/detection_prompt` to the response with the `201` status - added the optional property `allOf[#/components/schemas/AgentRequest]/voicemail_option/detection_prompt` to the response with the `201` status - removed the `gemini-2.5-flash` enum value from the `allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` response property for the response status `201` - **2026-04-28** `1b4a9d84942a` — 6 breaking, 1 warning, 5 info - added `#/components/schemas/AsrProvider` to the `allOf[#/components/schemas/AgentRequest]/custom_stt_config/provider` request property `allOf` list - removed the enum value `azure` of the request property `allOf[#/components/schemas/AgentRequest]/custom_stt_config/provider` - removed the enum value `deepgram` of the request property `allOf[#/components/schemas/AgentRequest]/custom_stt_config/provider` - removed the enum value `soniox` of the request property `allOf[#/components/schemas/AgentRequest]/custom_stt_config/provider` - the `allOf[#/components/schemas/AgentRequest]/custom_stt_config/provider` request property type changed from `string` to no type - the `allOf[#/components/schemas/AgentRequest]/custom_stt_config/provider` response's property type changed from `string` to no type for status `201` - added the new `gpt-5.5` enum value to the `allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` response property for the response status `201` - added the new `gpt-5.5` enum value to the request property `allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` - added `#/components/schemas/AsrProvider` to the `allOf[#/components/schemas/AgentRequest]/custom_stt_config/provider` response property `allOf` list for the response status `201` - removed the `azure` enum value from the `allOf[#/components/schemas/AgentRequest]/custom_stt_config/provider` response property for the response status `201` - removed the `deepgram` enum value from the `allOf[#/components/schemas/AgentRequest]/custom_stt_config/provider` response property for the response status `201` - removed the `soniox` enum value from the `allOf[#/components/schemas/AgentRequest]/custom_stt_config/provider` response property for the response status `201` - **2026-04-27** `a44406f743c2` — 67 breaking, 65 info - removed the enum value `af-ZA` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `ar-SA` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `az-AZ` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `bg-BG` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `bs-BA` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `ca-ES` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `cs-CZ` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `cy-GB` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `da-DK` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `de-DE` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `el-GR` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `en-AU` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `en-GB` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `en-IN` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `en-NZ` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `en-US` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `es-419` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `es-ES` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `fa-IR` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `fi-FI` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `fil-PH` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `fr-CA` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `fr-FR` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `gl-ES` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `he-IL` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `hi-IN` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `hr-HR` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `hu-HU` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `hy-AM` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `id-ID` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `is-IS` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `it-IT` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `ja-JP` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `kk-KZ` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `kn-IN` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `ko-KR` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `lt-LT` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `lv-LV` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `mk-MK` of the request property `allOf[#/components/schemas/AgentRequest]/language` - removed the enum value `mr-IN` of the request property `allOf[#/components/schemas/AgentRequest]/language` - …92 more - **2026-04-20** `8ee53928bf31` — 5 warning, 3 info - removed the request property `allOf[#/components/schemas/AgentRequest]/normalize_for_speech` - removed the optional property `allOf[#/components/schemas/AgentRequest]/normalize_for_speech` from the response with the `201` status - added the new `gemini-3.1-flash-lite` enum value to the `allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` response property for the response status `201` - added the new `s2-pro` enum value to the `allOf[#/components/schemas/AgentRequest]/voice_model` response property for the response status `201` - added the new `soniox` enum value to the `allOf[#/components/schemas/AgentRequest]/custom_stt_config/provider` response property for the response status `201` - added the new `gemini-3.1-flash-lite` enum value to the request property `allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` - added the new `s2-pro` enum value to the request property `allOf[#/components/schemas/AgentRequest]/voice_model` - added the new `soniox` enum value to the request property `allOf[#/components/schemas/AgentRequest]/custom_stt_config/provider` - **2026-04-01** `56de19127afb` — 2 breaking, 6 info - removed `#/components/schemas/StringAnalysisData, #/components/schemas/EnumAnalysisData, #/components/schemas/BooleanAnalysisData, #/components/schemas/NumberAnalysisData` from the `allOf[#/components/schemas/AgentRequest]/post_call_analysis_data/items/` request property `oneOf` list - added `#/components/schemas/AnalysisData, #/components/schemas/CallPresetAnalysisData` to the `allOf[#/components/schemas/AgentRequest]/post_call_analysis_data/items/` response property `oneOf` list for the response status `201` - added the new optional request property `allOf[#/components/schemas/AgentRequest]/handbook_config` - added the new optional request property `allOf[#/components/schemas/AgentRequest]/timezone` - added `#/components/schemas/AnalysisData, #/components/schemas/CallPresetAnalysisData` to the `allOf[#/components/schemas/AgentRequest]/post_call_analysis_data/items/` request property `oneOf` list - added the optional property `allOf[#/components/schemas/AgentRequest]/handbook_config` to the response with the `201` status - added the optional property `allOf[#/components/schemas/AgentRequest]/timezone` to the response with the `201` status - removed `#/components/schemas/StringAnalysisData, #/components/schemas/EnumAnalysisData, #/components/schemas/BooleanAnalysisData, #/components/schemas/NumberAnalysisData` from the `allOf[#/components/schemas/AgentRequest]/post_call_analysis_data/items/` response property `oneOf` list for the response status `201` - **2026-03-19** `3aa6f6e028ef` — 2 breaking, 2 warning, 4 info - removed the enum value `sonic-2` of the request property `allOf[#/components/schemas/AgentRequest]/voice_model` - removed the enum value `sonic-turbo` of the request property `allOf[#/components/schemas/AgentRequest]/voice_model` - added the new `gpt-5.4-mini` enum value to the `allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` response property for the response status `201` - added the new `gpt-5.4-nano` enum value to the `allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` response property for the response status `201` - added the new `gpt-5.4-mini` enum value to the request property `allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` - added the new `gpt-5.4-nano` enum value to the request property `allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` - removed the `sonic-2` enum value from the `allOf[#/components/schemas/AgentRequest]/voice_model` response property for the response status `201` - removed the `sonic-turbo` enum value from the `allOf[#/components/schemas/AgentRequest]/voice_model` response property for the response status `201` - **2026-03-17** `424df3aa7900` — 3 warning, 1 info - removed the request property `allOf[#/components/schemas/AgentRequest]/enable_voicemail_detection` - removed the optional property `allOf[#/components/schemas/AgentRequest]/enable_voicemail_detection` from the response with the `201` status - added the new `gpt-5.4` enum value to the `allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` response property for the response status `201` - added the new `gpt-5.4` enum value to the request property `allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` - **2026-03-09** `8fbf8c54a142` — 5 breaking, 4 warning, 11 info - the `allOf[#/components/schemas/AgentRequest]/post_call_analysis_data/items/oneOf[#/components/schemas/BooleanAnalysisData]/name` request property's minLength was increased from `0` to `1` - the `allOf[#/components/schemas/AgentRequest]/post_call_analysis_data/items/oneOf[#/components/schemas/EnumAnalysisData]/name` request property's minLength was increased from `0` to `1` - the `allOf[#/components/schemas/AgentRequest]/post_call_analysis_data/items/oneOf[#/components/schemas/NumberAnalysisData]/name` request property's minLength was increased from `0` to `1` - the `allOf[#/components/schemas/AgentRequest]/post_call_analysis_data/items/oneOf[#/components/schemas/StringAnalysisData]/name` request property's minLength was increased from `0` to `1` - the response property `allOf[#/components/schemas/AgentRequest]/custom_stt_config` became nullable for the status `201` - the `allOf[#/components/schemas/AgentRequest]/ring_duration_ms` request property's max was set to `300000.00` - the `allOf[#/components/schemas/AgentRequest]/ring_duration_ms` request property's min was set to `5000.00` - added the new `claude-4.6-sonnet` enum value to the `allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` response property for the response status `201` - added the new `eleven_v3` enum value to the `allOf[#/components/schemas/AgentRequest]/voice_model` response property for the response status `201` - added the new optional request property `allOf[#/components/schemas/AgentRequest]/post_call_analysis_data/items/oneOf[#/components/schemas/BooleanAnalysisData]/required` - added the new optional request property `allOf[#/components/schemas/AgentRequest]/post_call_analysis_data/items/oneOf[#/components/schemas/EnumAnalysisData]/required` - added the new optional request property `allOf[#/components/schemas/AgentRequest]/post_call_analysis_data/items/oneOf[#/components/schemas/NumberAnalysisData]/required` - added the new optional request property `allOf[#/components/schemas/AgentRequest]/post_call_analysis_data/items/oneOf[#/components/schemas/StringAnalysisData]/required` - the request property `allOf[#/components/schemas/AgentRequest]/custom_stt_config` became nullable - added the new `claude-4.6-sonnet` enum value to the request property `allOf[#/components/schemas/AgentRequest]/post_call_analysis_model` - added the new `eleven_v3` enum value to the request property `allOf[#/components/schemas/AgentRequest]/voice_model` - added the optional property `allOf[#/components/schemas/AgentRequest]/post_call_analysis_data/items/oneOf[#/components/schemas/BooleanAnalysisData]/required` to the response with the `201` status - added the optional property `allOf[#/components/schemas/AgentRequest]/post_call_analysis_data/items/oneOf[#/components/schemas/EnumAnalysisData]/required` to the response with the `201` status - added the optional property `allOf[#/components/schemas/AgentRequest]/post_call_analysis_data/items/oneOf[#/components/schemas/NumberAnalysisData]/required` to the response with the `201` status - added the optional property `allOf[#/components/schemas/AgentRequest]/post_call_analysis_data/items/oneOf[#/components/schemas/StringAnalysisData]/required` to the response with the `201` status - **2026-02-26** `e89903d2c910` — 2 info - added the new optional request property `allOf[#/components/schemas/AgentRequest]/enable_dynamic_responsiveness` - added the optional property `allOf[#/components/schemas/AgentRequest]/enable_dynamic_responsiveness` to the response with the `201` status - **2026-02-23** `bcff6899fa2a` — 1 warning, 5 info - added the new `s1` enum value to the `allOf[#/components/schemas/AgentRequest]/voice_model` response property for the response status `201` - added the new optional request property `allOf[#/components/schemas/AgentRequest]/analysis_user_sentiment_prompt` - added the new optional request property `allOf[#/components/schemas/AgentRequest]/data_storage_retention_days` - added the new `s1` enum value to the request property `allOf[#/components/schemas/AgentRequest]/voice_model` - added the optional property `allOf[#/components/schemas/AgentRequest]/analysis_user_sentiment_prompt` to the response with the `201` status - added the optional property `allOf[#/components/schemas/AgentRequest]/data_storage_retention_days` to the response with the `201` status - **2026-02-11** `076d0088c7ed` — 2 warning, 2 info - added the new `cs-CZ` enum value to the `allOf[#/components/schemas/AgentRequest]/language` response property for the response status `201` - added the new `speech-2.8-turbo` enum value to the `allOf[#/components/schemas/AgentRequest]/voice_model` response property for the response status `201` - added the new `cs-CZ` enum value to the request property `allOf[#/components/schemas/AgentRequest]/language` - added the new `speech-2.8-turbo` enum value to the request property `allOf[#/components/schemas/AgentRequest]/voice_model` - **2026-02-10** `0bf5cea5dfcc` — 6 warning, 2 info - the `allOf[#/components/schemas/AgentRequest]/interruption_sensitivity` request property's max was set to `1.00` - the `allOf[#/components/schemas/AgentRequest]/responsiveness` request property's max was set to `1.00` - the `allOf[#/components/schemas/AgentRequest]/voice_speed` request property's max was set to `2.00` - the `allOf[#/components/schemas/AgentRequest]/interruption_sensitivity` request property's min was set to `0.00` - the `allOf[#/components/schemas/AgentRequest]/responsiveness` request property's min was set to `0.00` - the `allOf[#/components/schemas/AgentRequest]/voice_speed` request property's min was set to `0.50` - added the new optional request property `allOf[#/components/schemas/AgentRequest]/webhook_events` - added the optional property `allOf[#/components/schemas/AgentRequest]/webhook_events` to the response with the `201` status - **2026-02-06** `dfad228ab4a4` — 1 breaking, 1 warning, 6 info - removed the enum value `none` of the request property `allOf[#/components/schemas/AgentRequest]/denoising_mode` - added the new `no-denoise` enum value to the `allOf[#/components/schemas/AgentRequest]/denoising_mode` response property for the response status `201` - added the new optional request property `allOf[#/components/schemas/AgentRequest]/enable_dynamic_voice_speed` - added the new optional request property `allOf[#/components/schemas/AgentRequest]/guardrail_config` - added the new `no-denoise` enum value to the request property `allOf[#/components/schemas/AgentRequest]/denoising_mode` - added the optional property `allOf[#/components/schemas/AgentRequest]/enable_dynamic_voice_speed` to the response with the `201` status - added the optional property `allOf[#/components/schemas/AgentRequest]/guardrail_config` to the response with the `201` status - removed the `none` enum value from the `allOf[#/components/schemas/AgentRequest]/denoising_mode` response property for the response status `201` - **2026-01-23** `427e77039f39` — 1 breaking, 9 warning, 9 info - request property `allOf[#/components/schemas/AgentRequest]/voice_emotion` was restricted to a list of enum values - added the new `angry` enum value to the `allOf[#/components/schemas/AgentRequest]/voice_emotion` response property for the response status `201` - added the new `calm` enum value to the `allOf[#/components/schemas/AgentRequest]/voice_emotion` response property for the response status `201` - added the new `fearful` enum value to the `allOf[#/components/schemas/AgentRequest]/voice_emotion` response property for the response status `201` - added the new `happy` enum value to the `allOf[#/components/schemas/AgentRequest]/voice_emotion` response property for the response status `201` - added the new `none` enum value to the `allOf[#/components/schemas/AgentRequest]/denoising_mode` response property for the response status `201` - added the new `sad` enum value to the `allOf[#/components/schemas/AgentRequest]/voice_emotion` response property for the response status `201` - added the new `surprised` enum value to the `allOf[#/components/schemas/AgentRequest]/voice_emotion` response property for the response status `201` - added the new `sympathetic` enum value to the `allOf[#/components/schemas/AgentRequest]/voice_emotion` response property for the response status `201` - added the new `undefined` enum value to the `allOf[#/components/schemas/AgentRequest]/voice_emotion` response property for the response status `201` - added the new `angry` enum value to the request property `allOf[#/components/schemas/AgentRequest]/voice_emotion` - added the new `calm` enum value to the request property `allOf[#/components/schemas/AgentRequest]/voice_emotion` - added the new `fearful` enum value to the request property `allOf[#/components/schemas/AgentRequest]/voice_emotion` - added the new `happy` enum value to the request property `allOf[#/components/schemas/AgentRequest]/voice_emotion` - added the new `none` enum value to the request property `allOf[#/components/schemas/AgentRequest]/denoising_mode` - added the new `sad` enum value to the request property `allOf[#/components/schemas/AgentRequest]/voice_emotion` - added the new `surprised` enum value to the request property `allOf[#/components/schemas/AgentRequest]/voice_emotion` - added the new `sympathetic` enum value to the request property `allOf[#/components/schemas/AgentRequest]/voice_emotion` - added the new `undefined` enum value to the request property `allOf[#/components/schemas/AgentRequest]/voice_emotion` - **2026-01-19** `9dbbdaf34f4b` — 2 info - added the new optional request property `allOf[#/components/schemas/AgentRequest]/voice_emotion` - added the optional property `allOf[#/components/schemas/AgentRequest]/voice_emotion` to the response with the `201` status --- [Operation](https://skmtc.dev/retellai/apis/retell-sdk/docs/create-agent/post.md) · [API](https://skmtc.dev/retellai/apis/retell-sdk.md) · [Page](https://skmtc.dev/retellai/apis/retell-sdk/changes/create-agent/post)