Skip to main content

​
Conversation flow replaces multi-prompt agents

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. Single prompt and conversation flow agents aren’t affected.

​
What’s changing

  • Already in effect: The dashboard no longer offers new multi-prompt agents or lets you assign them to new phone numbers. Update Retell LLM also rejects adding the first state to a single prompt LLM. Existing phone assignments keep working.
  • 12/15/2026: New multi-prompt creation ends, including through the API, dashboard duplication, and import.
  • 02/01/2027: Editing existing multi-prompt agents ends.
Existing multi-prompt agents continue handling calls during migration. Retell will migrate remaining multi-prompt agents to conversation flow after editing ends.

​
Migrate your agents

Delete any multi-prompt agents you no longer need. For agents you still use, follow the steps below.
1

Create or open the conversation flow copy

Find Multi-Prompt agents in the Agents list and open an agent, then choose Convert to conversation flow in its deprecation banner. Conductor opens and builds a separate conversation flow agent with a new agent ID, running on the Advanced model tier (3 credits) for the conversion. Your source agent and its phone-number assignments stay unchanged.If Open converted agent appears, open that copy instead of converting again.
2

Review and test

Review the generated flow and tools, then test with the LLM playground or simulation testing. Conversion can change how the agent handles calls.
3

Switch your phone numbers

Existing phone assignments continue using the original agent until you switch them. After testing, open the assigned number in Phone Numbers and choose Switch to converted agent when available, or assign the new agent manually. Review the selected agent version after switching.
4

Update integrations

Update code, batch calls, and transfers that use the old agent ID. If your integration creates or edits multi-prompt Retell LLMs, move those operations to the conversation flow APIs, such as Create Conversation Flow and Update Conversation Flow, before the relevant cutoff.Automatic migration does not update your integration code.