Okapi Okapi

Retell AI API · Endpoint removal

outbound_agent_id on POST /create-phone-number stops working

Stopped working

Calls to POST /create-phone-number, body parameter outbound_agent_id on Retell AI API stopped working on March 31, 2026.

What to use instead of these calls

Send outbound_agents instead: a list of {agent_id, agent_version, weight} entries whose weights sum to 1 (one agent: weight 1).

Calls it hits

  • POST /create-phone-number
  • body parameter outbound_agent_id

After 03/31/2026, the deprecated single-agent fields will no longer be supported.

Retell AI API, Announcement

Facts

API
Retell AI API api.retellai.com
Kind
Endpoint removal
Takes effect
March 31, 2026
Calls after that day
Fail
Source
Announcement
Last updated

More from Retell AI API

Know before your API calls break.

Okapi finds the calls a breaking change hits in your code and opens the pull request that fixes them.

Add to GitHub