Okapi Okapi

Retell AI API states body parameter removal on POST /create-retell-llm

Stops workingin 39 daysSubscribe to Retell AI APIShare

On December 15, 2026, Retell AI API will remove support for the body parameter states on POST /create-retell-llm. Calls sending this parameter will fail after that day. Retell AI API is retiring multi-prompt agents in favor of conversation flow.


Calls it hits

  • POST /create-retell-llm
  • body parameter states

What to use instead of these calls

Build the agent as a conversation flow with POST /create-conversation-flow instead of a multi-prompt Retell LLM. Multi-prompt agents have no direct API equivalent, so rebuilding one as a conversation flow changes how it handles calls and requires testing.

Multi-prompt agents have no direct API equivalent: rebuilding one as a conversation flow changes how it handles calls and needs testing.

In Retell AI API's words

Retell is retiring multi-prompt agents in favor of conversation flow. New multi-prompt creation ends on 12/15/2026, and editing ends on 02/01/2027.

Retell AI API, Announcement

Facts

API
Retell AI API api.retellai.com
Kind
Parameter removal
Takes effect
December 15, 2026
Calls after that day
Fail
Source
Announcement
Last updated
Verified
, against Retell AI API's own pages

Questions

When does this change take effect?

Calls to POST /create-retell-llm, body parameter states on Retell AI API stop working on December 15, 2026.

What happens to calls after December 15, 2026?

They fail from that day.

How do I find the calls this hits in my code?

Okapi reads your repository, finds the calls this change hits and opens a pull request with the fix. It never commits to your branches: every change comes as a pull request you review.


More from Retell AI API 10

  1. PATCH /update-agent/{id}Parameter removal Stopped working
  2. PATCH /update-chat-agent/{id}Parameter removal Stopped working
  3. POST /publish-agent/{id}Endpoint removal Stopped working
  4. POST /publish-chat-agent/{id}Endpoint removal Stopped working
  5. GET /list-agentsEndpoint removal Stopped working
  6. GET /list-chat-agentsEndpoint removal Stopped working
  7. PATCH /v2/update-call/{id}Parameter removal Stopped working
  8. GET /get-agent-versions/{id}Endpoint removal Stopped working
  9. GET /get-chat-agent-versions/{id}Endpoint removal Stopped working
  10. PATCH /update-retell-llm/{id}Parameter removal Stops workingin 87 days

Is your code calling this?

Okapi finds the calls this change hits in your repo and opens the pull request with the fix before December 15, 2026.

Add to GitHub

Get notifications

Subscribe to Retell AI API

Hear about each breaking change Retell AI API announces, in your feed reader, calendar or Slack.

1What to follow

Provider
  • Retell AI API

2Where to get it

/breaking-changes/feed.xml

Paste it into Feedly, Inoreader, NetNewsWire or any reader. New changes show up as they're announced.