Skip to main content
This section tracks upcoming and some past deprecations across the Retell API. Click the RSS button at the top of the page to subscribe and receive notifications when new deprecations are announced.
08/31/2026
APIUpcoming
The override_dynamic_variables input on Update Call is deprecated, and Update Call becomes ended-calls-only. Changes you make through Update Call — including data_storage_setting, which previously took effect mid-call — now apply only to ended calls. Use the new Update Live Call API to override dynamic variables or change data_storage_setting on ongoing calls.Impacted API endpoints:Read more.
06/15/2026
APIUpcoming
Legacy list endpoints and analysis prompt fields will be removed. Migrate to the versioned list endpoints (v2/v3) and to post_call_analysis_data / post_chat_analysis_data system presets.Impacted API endpoints:Read more.
05/25/2026
Models
Claude and Gemini models are being deprecated and automatically migrated to newer versions on 5/25/2026.Read more.
04/18/2026
API
The tools and tool_ids fields on type: "conversation" nodes are deprecated in favor of the new subagent node type.Impacted API endpoints:Read more.
04/03/2026
Models
OpenAI Realtime and Cartesia Sonic models are being deprecated and replaced with newer versions. After 4/3/2026, the deprecated models will no longer be available.Read more.
03/31/2026
API
The single-agent fields on phone number configuration are deprecated in favor of the weighted *_agents lists.Impacted API endpoints:Read more.
01/23/2026
API
show_transferee_as_caller no longer toggles SIP REFER vs SIP INVITE in Cold Transfer options. Use the new cold_transfer_mode parameter instead; show_transferee_as_caller now only controls caller ID display under sip_invite.Impacted API endpoints:Read more.