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.Documentation Index
Fetch the complete documentation index at: https://docs.retellai.com/llms.txt
Use this file to discover all available pages before exploring further.
Legacy list endpoints & analysis prompt fields removed
Legacy list endpoints and analysis prompt fields will be removed. Migrate to the versioned list endpoints (v2/v3) and topost_call_analysis_data / post_chat_analysis_data system presets.Impacted API endpoints:- List Batch Tests, List Conversation Flow Components, List Conversation Flows, List Phone Numbers, List Retell LLMs, List Test Case Definitions, List Test Runs, List Calls, List Chats — endpoints replaced by versioned (v2/v3) equivalents
- Create Agent, Update Agent, Create Chat Agent, Update Chat Agent — fields:
analysis_summary_prompt,analysis_successful_prompt,analysis_user_sentiment_prompt
Conversation node tools moved to subagent nodes
Thetools and tool_ids fields on type: "conversation" nodes are deprecated in favor of the new subagent node type.Impacted API endpoints:- Create Conversation Flow, Update Conversation Flow, Get Conversation Flow, List Conversation Flows, Create Conversation Flow Component, Update Conversation Flow Component, Get Conversation Flow Component, List Conversation Flow Components — fields:
tools,tool_ids(ontype: "conversation"nodes)
Phone number single-agent fields moved to weighted lists
The single-agent fields on phone number configuration are deprecated in favor of the weighted*_agents lists.Impacted API endpoints:- Create Phone Number, Import Phone Number, Update Phone Number, Get Phone Number, List Phone Numbers — fields:
inbound_agent_id,inbound_agent_version,outbound_agent_id,outbound_agent_version,inbound_sms_agent_id,inbound_sms_agent_version,outbound_sms_agent_id,outbound_sms_agent_version
Cold transfer mode selection
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:- Create Retell LLM, Update Retell LLM, Create Conversation Flow, Update Conversation Flow, Create Conversation Flow Component, Update Conversation Flow Component — field:
show_transferee_as_caller