> ## Documentation Index
> Fetch the complete documentation index at: https://docs.retellai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Multi-prompt agents

> Migrate multi-prompt agents to conversation flow in Retell AI. Creation ends on 12/15/2026 and editing ends on 02/01/2027; review and switch your traffic.

## Conversation flow replaces multi-prompt agents

Retell is retiring multi-prompt agents in favor of [conversation flow](https://docs.retellai.com/build/conversation-flow/overview.md). 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](https://docs.retellai.com/api-references/update-retell-llm.md) 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. Retell builds a separate conversation flow agent named `<agent name> (Conversation Flow)` with a new agent ID, then opens it. Your source agent and its phone-number assignments stay unchanged.

The conversion maps each state to a node and carries over your tools, settings, tags, and dynamic variables. If something can't carry over cleanly — for example a voice the converted model doesn't support — the conversion flags it as a warning to review.

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](https://docs.retellai.com/test/llm-playground.md) or [simulation testing](https://docs.retellai.com/test/llm-simulation-testing.md). 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](https://docs.retellai.com/api-references/create-conversation-flow.md) and [Update Conversation Flow](https://docs.retellai.com/api-references/update-conversation-flow.md), before the relevant cutoff.

Automatic migration does not update your integration code.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.