Skip to main content
In September 2026, Bland made big, exciting updates to its agent builder. All production agents need to be migrated to the new agent architecture by November 15. Agents are the successor to conversational pathways: the same powerful conversation engine, with a new architecture that places more emphasis on the agent, but still offers the control of pathways, versioned snapshots, environments, and first-class testing. Every path below hands you an agent to review before it takes traffic, so run the simulation suite, test-chat the agent in the dashboard, and verify the lanes that depend on your live data.
Migration is additive. The migration will only create new agents; your existing assets will not be disrupted. Your pathways, their phone numbers, tools, snippets, and live traffic are never modified. Traffic moves to the new agent only when you move it: attach a phone number to the agent, send agent_id in your API requests, or route a pathway’s calls to the agent with a migration split. By default, each of those runs the agent’s production version, so publish one first. See Moving traffic over.

Migration TLDR

Migrate your pathways and personas to agents by November 15, 2026. Nothing is lost if you do not. In the days before November 15, Bland migrates your busiest pathways and personas for you where it can, and publishes each new agent’s production version. Calls still go to the pathway or persona until you move them. The rest stay in Bland Agents on the Pathways and Personas pages, where you can view them and migrate any that have no agent yet. You can’t edit them there. November 15 changes the dashboard only. Your phone numbers, API requests that send pathway_id or persona_id, triggers, SMS and running migration experiments keep working as they do today. Until then you have both dashboards. A workspace with an extension keeps the prior dashboard until its extension ends, and Bland migrates nothing for it. If your account was created after 18 September 2026 you are on Bland Agents only and no action is required of you. Self-serve users have three migration paths they can choose from:
  1. Migrate on your own (with your favorite coding agent like Claude code or Codex)
  2. Migrate and upgrade your agent
  3. Migrate as is
Enterprise accounts do not need to do this themselves. Your Bland partner runs the migration with you. We recommend you don’t wait until the deadline to migrate your agent. This will allow for ample time for testing and promotion.

What it moves

Your organization keeps everything it already has. Phone numbers, tools, secrets, knowledge, connections, voices and triggers belong to the organization rather than to any one pathway, so your agents use the same ones. Some have new names, which Where it went lists. What you migrate is your pathways and personas. Each becomes an agent, and you give that agent a phone number when you are ready for it to take calls. Until you do, nothing is repointed: your phone number still rings the pathway.

What’s different

Pathways and personas both become agents. A pathway’s node graph becomes a pathway inside an agent. A persona’s skills become Prompts. The global prompt that floated beside the graph is now the agent’s system prompt, in its settings. Two things are genuinely new rather than moved. Environments pin a version to staging and production, so shipping is a deliberate act rather than a save. Evaluations score an agent’s behavior and can gate that shipping.

Where it went

Building

A conversational pathway becomes an agent, or a pathway within one, and its nodes become steps inside that pathway. See Agent builder.

Watching

Conversations absorbed three separate log pages. See Conversations. Analytics opens straight into a single page, with no tabs. Boards, reports and analysis presets have no Bland Agents equivalent. Old Analytics links that include a ?tab= value still open the Analytics page.

Dispatching

See Dispatch, Triggers and SIP.

Testing and shipping

Environments, versions and promotion have no equivalent in the prior dashboard. See Environments.

Pick your path

You need an owner, admin, operator or prompter role, and a conversational pathway or persona to move. Every migration starts the same way: in the dashboard, open the agent dropdown in the upper left corner, choose New agent, then Migrate. From there you select the pathway or persona you want to migrate, and choose one of three options. Migrate as is is under Legacy, below the other two. Everything below on this page is downstream of that selection.

Migrate on your own

Hand the migration to Claude Code, Codex, or another coding agent. It connects through the Bland MCP plugin and rebuilds your persona as a new agent you can test and refine step by step.

Migrate and upgrade

Runs simulated conversations through your persona, tests how your calls perform, and uses the results to build an optimized agent. You get an upgrade, not a copy.

Migrate as is

Copies your persona into a new agent exactly as it works today, packaged as a single pathway for the agent to reference. Nothing is simulated or changed.

Migrate as is

Copies your conversational pathway into a new agent as a pathway, one agent per conversational pathway. No rewriting, no simulation. It is the fastest route and the most predictable.
Migrate as is keeps your End Call nodes hanging up, as they did in the pathway. When you migrate a persona, a component exit that had no next step in its pathway returns to the agent instead of ending the call.The import says so when it happens. Add an End call node in the flow if the call should end there.
It also carries a few call-level settings from the number bound to your pathway, such as voice, language and max duration. Anything with no home in agent settings is reported rather than dropped silently, and the number itself is not attached to the agent. This migration path cannot be cancelled once it starts, though it is quick. Running it twice gives you two agents, since nothing is deduplicated: the migration has no memory of having run, so a hesitant second attempt leaves you tidying up. That is safe, because nothing is overwritten. Warnings do not appear in the modal. You get a toast saying how many items are flagged, then a banner over the builder canvas naming the pathway and the count, which you can dismiss. Three smaller things are dropped, each reported as a warning: a pathway’s own global prompt when you migrate a persona, exit pointers on fanned-out components, and tool overrides on a persona’s skills.

Migrate and upgrade

Bland rebuilds the agent from your pathway and checks its behavior against simulated conversations before handing it over. It runs in the background, so you can close the tab.
Those simulations call the endpoints your pathway already has configured. They can create real bookings, send messages, or update records in your own systems.Check what your pathway is connected to before starting. The dashboard warns you about this too.
You can cancel while it runs, up until it starts finalizing. If it finishes without being able to verify behavior, it says so rather than implying it checked.

Migrate on your own

Click Copy setup prompt to give a single prompt that lets your agent drive the whole setup. Learn more is a step-by-step walkthrough for doing the setup yourself, so you understand each piece. The engine behind both is the Norm plugin (norm@bland): it carries the full migration playbook, a deterministic snapshot builder and parity audit, and a convergence loop that will not declare the migration done until the checks are actually green. It talks to your account through the hosted Bland MCP server. There is nothing else to run or configure. The separate bland@bland plugin covers v1 pathways and personas; install both only if you work with both platforms.

Option 1. One prompt, your agent sets everything up

You need a coding agent (for example Claude Code) and a Bland API key for the organization that owns the pathway (app.bland.ai/settings/api-keys). The prompt handles the rest, including installing the plugin for you. In the dashboard steps above you selected the pathway or persona you want to migrate, and its ID fills in the first line of the prompt below. If you are copying the prompt directly instead, fetch the ID of the pathway you are migrating first: it is in the pathway’s URL in the dashboard. Fill in the two blanks and paste:
First paste on a fresh machine: the agent installs the plugin, then hands back to you for the two things only you can do. Enter your API key (stored by the host, outside the conversation) and restart the session. Paste the same prompt again and the migration starts. If the plugin is already set up, the first paste goes straight into the migration.
Never paste your API key into the chat. The prompt above tells the agent not to ask for it. /plugin configure norm@bland stores it in your OS keychain, where the MCP connection reads it without it ever entering the model context.

Option 2. The step-by-step walkthrough

The same flow with you doing the setup, so you know exactly what’s installed and where your key lives.
1

Get your Bland API key

Go to app.bland.ai/settings/api-keys and create (or copy) a key. It must belong to the organization that owns the pathway. If you’re in several orgs, check the org switcher in the dashboard first. Treat the key like a password: it grants full API access to that org.
2

Install your coding agent

If you don’t have one yet, Claude Code is at claude.com/claude-code; the commands below are its syntax. Open a session in any empty folder. The migration works entirely through the Bland API; no codebase is needed.
3

Install the plugin

Inside the session:
The install prompts for your API key and stores it in your OS keychain. Outside the conversation. If it doesn’t prompt (or you skipped it), set it with:
From a shell instead, pass the key on the command line so it never enters a chat:
Then restart the session. Plugins load on startup. Typing /norm should now show the plugin’s commands (/norm:migrate, /norm:validate, /norm:simulate, /norm:build).
4

Find your pathway ID

Open the pathway in the dashboard. The ID is the UUID in the URL, e.g. app.bland.ai/dashboard/convo-pathways?id=<PATHWAY_ID>.
5

Start the migration

Paste, filled in:
Variations:
  • Persona attached to the pathway? Add its ID: …and include my persona <PERSONA_ID>.
  • Prefer to hand over files? Export the pathway JSON and attach it instead of the ID: /norm:migrate Migrate the attached v1 export into a new Bland Agent named "…".
  • Migrating into an existing agent? Say so. Versions are additive, so a migration can land as a new version on an agent you already created.

What the session does

1

Discover

Censuses the export: every node and edge, webhooks and their auth, code snippets and their pinned versions, transfers, knowledge bases, and the variables your callers’ request data must supply.
2

Architect. You approve

Proposes the agent shape: which nodes become which pathways, where the hub routes, what each entry means. It presents this before authoring anything; this is your main steering point.
3

Author

A deterministic builder carries every byte of your content. Prompts, route rules, webhook configs, snippet pins, tools. From your pathway export into the agent snapshot. Your prompts arrive verbatim, not paraphrased. Known pathway quirks are carried bug-for-bug so behavior doesn’t silently change.
4

Audit

A machine parity audit checks the snapshot against your pathway source. Structure, routing, byte-level prompt carriage, and that every snippet and tool made it across. Before any write to your account.
5

Push. Asks first

Pushes the audited snapshot as a new agent version. This is the first write, and the session asks before doing it.
6

Simulate

Designs and runs a simulation suite over the migrated agent’s lanes. Intake, transfers, voicemail, edge cases. And grades results on engine traces, not vibes. Failures loop back into fixes; the loop only completes when the suite is green on the exact bytes that were pushed.
7

Report

A migration report: what mapped where, documented behavioral deltas, carried pathway quirks, the request-data contract, and. Honestly. Any lanes that can only be verified with your real data.
Expect a complex pathway to take a while. The session is mostly hands-off after you approve the architecture, and it will not report success it can’t prove.

After the migration

  • Read the report, especially the “needs verification with your data” list. Lanes gated on your CRM records or live integrations that simulations couldn’t exercise safely.
  • Test-chat the agent in the dashboard against your real scenarios.
  • Update programmatic calls. If your integration places outbound calls, follow Updating programmatic call use with your new Agent to update your requests and post-call result handling.
  • Check your post-call webhook handling. Agent calls send a different post-call webhook, and citations and V1 dispositions don’t run on them. See What changes in the webhook.
  • Move traffic when ready. The migration never touches routing, so your existing pathway keeps answering until you decide otherwise.

Moving traffic over

The migration has changed nothing about how calls are answered. Your phone numbers and API integrations still point where they pointed before, and your pathway still answers them. Moving traffic takes two steps, in this order:
  1. Publish the agent’s production version. A call that doesn’t ask for a specific version runs production. An agent you have built, tested and saved but never published to production can’t take those calls, which is the single most common reason a new agent appears not to answer. See Environments for what publishing and promoting do and how to undo them.
  2. Point traffic at the agent. Attach a phone number to it (see Dispatch), send agent_id instead of pathway_id in your API requests, or route a pathway’s calls to the agent with a migration split.
Attaching a number or changing a request moves that traffic at once, so do the verification above first, on an agent nobody is calling yet. A migration split can move a pathway’s calls in steps instead. An API integration that sends pathway_id can use one without changing its request. See Migrate an API integration without changing its request.

Common failures

You used a method that rebuilds rather than copies. Migrate as is is the one that copies step for step. Run it again with that method and delete the agent you do not want.The same split exists inside the builder: Migrate has a Migrate and upgrade switch on each row, on by default, and turning it off copies the pathway as it is.
It is inside an agent, not on the agent list, because it imports into an agent that already exists. To start from nothing, use New agent then Migrate.
They are still there, in the organization-wide list. A trigger belongs to your organization, and only the ones created from an agent’s own page are filed under that agent. Yours were created before the agent existed, so they stay where they were, and they still start the pathway they were pointed at.
It did not. The migration never changes or deletes a pathway. In Bland Agents, legacy pathways are on the Pathways page and legacy personas are on the Personas page. You can view them there but not edit them. Check you are not looking at the agent list expecting to see it.

Next steps

Agent builder

Where the migrated pathway lands.

Environments

Publish the agent before it can take a call.

Dispatch

Give it a number.

Conversations

Where your call logs went.

Using the MCP server without the plugin

Any MCP client can connect to the Bland MCP server directly, https://api.bland.ai/v1/mcp with your API key as a bearer token (see MCP clients). That gives an agent the raw tools: reading pathways, creating agents, pushing versions, running tests. The migration playbook, parity audit, and convergence loop ship in the plugin, though. For migrations, use the plugin.