Jep
05/04/2026, 11:59 AMAI Evy
05/04/2026, 11:59 AMAI Evy
05/04/2026, 11:59 AMtools and tool_ids fields on conversation nodes with type: "conversation"
What to check in your workflows:
Look for conversation nodes that use tools. These need to be migrated to use type: "subagent" instead .
How to identify affected nodes:
- Check if you have any nodes with type: "conversation" that also have tools or tool_ids fields
- These could be in your Conversation Flows or Conversation Flow Components
Migration steps:
For conversation nodes with tools, change type from "conversation" to "subagent". If the node uses a static_text instruction, change it to prompt. All other fields remain the same .
What happens on 04/18/2026:
- Existing conversation nodes with tools will be automatically migrated to type: "subagent"
- The API will stop accepting tools or tool_ids fields on type: "conversation" nodes
If you're still unable to locate the deprecated API usage in your workflows, the deprecation might be occurring in API calls rather than in the dashboard UI. Check any custom code or integrations that interact with the Create/Update Conversation Flow APIs .AI Evy
05/04/2026, 11:59 AMAI Evy
05/04/2026, 11:59 AMJep
05/04/2026, 12:01 PMJep
05/04/2026, 12:11 PMAI Evy
05/04/2026, 12:11 PMAI Evy
05/04/2026, 12:11 PMAI Evy
05/04/2026, 12:11 PMAI Evy
05/04/2026, 12:11 PMJep
05/04/2026, 12:12 PMAI Evy
05/04/2026, 12:12 PMAI Evy
05/04/2026, 12:13 PMinbound_agent_id
- outbound_agent_id
- inbound_agent_version
- outbound_agent_version
What to use instead:
Replace the deprecated fields with these new array-based fields:
- inbound_agents - array of agents with weights for inbound calls [(1) ]()
- outbound_agents - array of agents with weights for outbound calls
- inbound_sms_agents - array of agents with weights for inbound SMS
- outbound_sms_agents - array of agents with weights for outbound SMS
Where to check for usage:
The deprecated fields appear in these Phone Number API endpoints:
- Update Phone Number (PATCH /update-phone-number/{phone_number})
- List Phone Numbers (GET /get-phone-number/{phone_number}) [(2) ]()
- Get Phone Number [(3) ]()
To identify the affected code:
Look for any API calls in your codebase that use inbound_agent_id, outbound_agent_id, inbound_agent_version, or outbound_agent_version when working with phone numbers. These are likely in your backend integration code rather than the dashboard UI.
The new agent arrays support weighted routing - one agent is picked randomly for each call with probability proportional to the weight, and total weights must add up to 1 [(1) ]() [(2) ](AI Evy
05/04/2026, 12:13 PMAI Evy
05/04/2026, 12:13 PMJep
05/04/2026, 12:21 PMAI Evy
05/04/2026, 12:21 PMAI Evy
05/04/2026, 12:22 PMcreate-phone-call API is not affected by the Phone Number API deprecation [(1) ]() .
The deprecation specifically targets the Phone Number APIs - Update Phone Number, List Phone Numbers, and Get Phone Number - which manage phone number configurations [(2) ]() . The deprecated fields are inbound_agent_id, outbound_agent_id, inbound_agent_version, and outbound_agent_version .
The create-phone-call API uses different parameters: from_number, to_number, override_agent_id, and override_agent_version [(1) ]() . These fields are not being deprecated and will continue to work as expected .
What you need to check:
Look for any code that calls the Phone Number management endpoints (update, list, or get phone number details) , not the create-phone-call endpoint [(2) ]() .AI Evy
05/04/2026, 12:22 PMAI Evy
05/04/2026, 12:22 PMJep
05/04/2026, 12:28 PMAI Evy
05/04/2026, 12:28 PMAI Evy
05/04/2026, 12:28 PMjavascript
const phoneNumberResponse = await client.phoneNumber.retrieve('+14157774444') ;
[(3) ]()
or
javascript
const phoneNumberResponses = await client.phoneNumber.list() ;AI Evy
05/04/2026, 12:28 PMinbound_agent_id, outbound_agent_id, inbound_agent_version, outbound_agent_version) [(4) ]() .
What to do:
Since Retell's log analysis detected usage from your organization, the deprecated API calls are happening somewhere. Check:
- Any automation tools or integrations that might be managing phone numbers
- Third-party platforms that integrate with Retell
- Any scripts that retrieve phone number configurations
If you still can't locate the usage, contact Retell support directly at support@retellai.com with your organization ID to get specific details about where the deprecated API calls are originating.AI Evy
05/04/2026, 12:28 PMAI Evy
05/04/2026, 12:28 PM