Agent lifecycle
Reverting a draft, resetting build settings, archiving an agent, restoring it, and deleting it for good.
The agent's Settings > Archive and delete page holds the actions that undo work or retire an agent.
- Draft: revert to the live version, or reset build settings. Both change the draft only.
- Archive or delete this agent: archive the agent, or delete it for good.
All four need access to the whole workspace. A collaborator sees the page but can't run them, even with edit access.
Reverting a draft
Revert draft to live version copies the published version back over the draft, discarding every change since the last publish. It replaces the draft's prompt, greetings, tools, knowledge base and variables, and its voice, model, speech, timezone, privacy and silent-caller settings.
Only available when there is a draft to revert. The live version is untouched throughout and you can edit the draft again afterwards, but the discarded draft is gone.
Resetting build settings
Reset build settings to defaults returns the draft's model, voice, speech recognition and ambience settings to the platform defaults. Prompt, tools, variables, knowledge base, recognition hints and privacy settings are untouched.
Only applies to a draft. Create one first if the latest version is published.
Resetting clears the selected voice. Pick one again before you publish.
Archiving an agent
Archiving is a reversible soft delete. Confirm by typing the agent's slug.
Agent slug support-line
Type to confirm support-lineWhat archiving does:
- Removes the agent from the workspace agents list.
- Unassigns any phone number pointed at the agent.
- Takes its share link page offline, without clearing the link itself.
- Leaves calls already in progress alone.
- Leaves the agent reachable at its own address, so a bookmark still opens it.
The line does not go quiet at once
Archiving unassigns the agent's phone number. The agent stops taking new calls shortly afterwards, not the moment you confirm. Place a test call if you need to confirm the line is quiet.
The number stays in the workspace
Archiving does not release the number. It appears unassigned in Phone numbers, where you can point it at another agent or remove it from the workspace.
If number unassignment fails
The agent is still archived and the number stays routed to it. The confirmation message names the number or tells you to check Phone numbers settings. Either way, unassign it manually.
Restoring an agent
Restoring clears the archive and the agent reappears in the workspace list. Nothing is lost while archived: versions, tools, variables, transcripts and analytics are all still there.
The one thing restoring does not put back is the phone number. Assign one again from Phone numbers.
Restore from the workspace agents list: open the Trash tray, find the agent and choose Restore. The in-app assistant and the MCP server can do it too.
Permanent deletion
Permanent deletion removes the agent and cascades to every version, tool, variable, scenario and test result, its knowledge base, and every call with its transcript and recording. Its share link stops working. There is no recovery and no waiting period.
The agent must be archived first. The UI archives and deletes in one confirmed
action. A direct API call, the MCP server's permanent_delete_agent and the
in-app assistant refuse a live agent until it has been archived with
archive_agent, which stops its calls and unassigns its numbers. The numbers
stay in the workspace.
Archive instead unless it has to be erased
Archiving costs nothing and is reversible, so prefer it unless the agent genuinely has to be erased.
What survives what
| Action | Draft | Published version | Calls and transcripts | Phone number | Recoverable |
|---|---|---|---|---|---|
| Revert draft | Replaced | Kept | Kept | Still assigned | The live version is untouched, but the discarded draft is gone |
| Reset build settings | Model, voice, speech and ambience reset | Kept | Kept | Still assigned | Re-pick the settings |
| Archive | Kept | Kept | Kept | Unassigned, kept by the workspace | Yes, restore it, then assign a number again |
| Permanent delete | Gone | Gone | Gone | Unassigned, kept by the workspace | No |
Deleting a whole workspace is a different action with a seven-day recovery window. See access control.