Claude
03/08/2026, 1:24 PMAI Evy
03/08/2026, 1:25 PMAI Evy
03/08/2026, 1:25 PMoutbound_agents with weights when creating or updating a phone number. If set and non-empty, one agent will be picked randomly for each outbound call, with probability proportional to the weight. Total weights must add up to 1. [(1) ]()
2. Override Agent ID Per Call
If you need to specify a particular agent for each outbound call (rather than random selection) , you can override the agent ID when initiating the call. The outbound_agent_id on the phone number serves as a default, but you can override it per call.
Here's an example of the outbound_agents configuration:
json
"outbound_agents": [
{
"agent_id": "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD",
"weight": 0.5,
"agent_version": 1
}
]
[(2) ]()
If not set or empty, the system falls back to outbound_agent_id. [(1) ]()AI Evy
03/08/2026, 1:25 PMAI Evy
03/08/2026, 1:25 PMClaude
03/08/2026, 1:31 PMAI Evy
03/08/2026, 1:31 PMAI Evy
03/08/2026, 1:31 PMoutbound_agents field goes in the request body when you create or update a phone number—not in the Create Phone Call request. [(1) ]() [(2) ]()
To set it when creating a phone number:
POST /create-phone-number
[(1) ]()
To update an existing phone number:
PATCH /update-phone-number/{phone_number}
[(2) ]()
Include outbound_agents in the JSON body like this:
json
{
"outbound_agents": [
{
"agent_id": "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD",
"weight": 0.5,
"agent_version": 1
}
]
}
[(1) ]()
If you need to specify a particular agent for a single outbound call instead, use override_agent_id in the Create Phone Call request body. [(3) ]()AI Evy
03/08/2026, 1:31 PMAI Evy
03/08/2026, 1:31 PMAI Evy
03/08/2026, 1:32 PMAI Evy
03/08/2026, 1:32 PMoutbound_agents with weights cannot be added to the Create Phone Call request body. Your JSON is for creating a phone call, but the weighted agents configuration belongs on the phone number itself, not on individual calls. [(1) ]() [(2) ]()
You have two options:
*Option 1: Configure weights on the phone number (separate request) *
Update your phone number with the weighted agents:
json
{
"outbound_agents": [
{
"agent_id": "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD",
"weight": 0.5,
"agent_version": 1
}
]
}
[(2) ]()
Then your Create Phone Call request stays as-is (the system will randomly select from your configured agents) .
Option 2: Use override_agent_id per call
If you need to specify a particular agent for each individual call, keep using agent_id in your Create Phone Call request (which acts as the override) . But this doesn't support weights—it's a direct agent selection. [(3) ]()
The weights feature is designed for random distribution across multiple agents at the phone number level, not for per-call configuration. [(1) ]()AI Evy
03/08/2026, 1:32 PMAI Evy
03/08/2026, 1:32 PMClaude
03/08/2026, 1:34 PMAI Evy
03/08/2026, 1:34 PMAI Evy
03/08/2026, 1:35 PMoverride_agent_id. [(1) ]()
When making an outbound call, include the override_agent_id parameter to select the specific agent for that call:
javascript
const registerCallResponse = await retell.call.createPhoneCall({
from_number: '+14157774444', // replace with the number you purchased
to_number: '+12137774445', // replace with the number you want to call
// Optional: per-call agent selection and overrides
override_agent_id: 'agent_abc123',
override_agent_version: 0, // or omit to use latest
}) ;
This way, for each call you make, you can dynamically choose:
- Your restaurant agent for restaurant-related calls
- Your barber agent for barber-related calls
The override_agent_id parameter lets you override the agent used for that specific call.
So your workflow would be:
1. Buy one phone number
2. When initiating each outbound call, pass the appropriate override_agent_id based on the business type (restaurant vs barber)AI Evy
03/08/2026, 1:35 PMAI Evy
03/08/2026, 1:35 PMClaude
03/08/2026, 3:44 PMAI Evy
03/08/2026, 3:44 PMAI Evy
03/08/2026, 3:44 PMAI Evy
03/08/2026, 3:44 PMAI Evy
03/08/2026, 3:45 PMAI Evy
03/08/2026, 3:45 PMClaude
03/08/2026, 3:45 PMAI Evy
03/08/2026, 3:45 PMAI Evy
03/08/2026, 3:45 PMAI Evy
03/08/2026, 3:45 PMAI Evy
03/08/2026, 3:45 PMClaude
03/08/2026, 3:46 PMAI Evy
03/08/2026, 3:46 PMAI Evy
03/08/2026, 3:46 PMAI Evy
03/08/2026, 3:46 PMAI Evy
03/08/2026, 3:46 PMAI Evy
03/08/2026, 3:46 PM