Delete a Web Agent
Deleting a Web Agent removes it from the workspace with everything that belongs to it. A deleted agent cannot be restored.
Before you begin
- Remove the agent from your app: the script tag, or the
@faustine-ai/web-agentcall that has the agent's ID. Deleting the agent in the portal does not change your site, and a page that still has the snippet keeps requesting an agent that no longer exists. - To stop offering the agent without losing its work, remove the snippet and keep the agent.
Delete the agent
To delete a Web Agent:
- In the portal, go to Web Agents and select your agent.
- Select the Settings tab, then Danger zone.
- Under Delete this assistant, enter the agent's name. The name has to match exactly, including capitals.
- Select Delete assistant.
The portal returns to the Web Agents list.
The list has the same action. Open the menu on the agent's card, select Delete, and confirm with Delete in the dialog. The dialog does not ask for the name.
What is deleted
| Deleted | Detail |
|---|---|
| The draft and every published version | Actions, persona, look and feel, and the Guide's screens and tasks. |
| Environments | With their variable values, allowed domains and deployments. |
| Knowledge files | The files uploaded to the agent. |
| Test suites | With their generated scripts. |
| Uploaded code | The ZIP archive, when the agent was created from one. |
| Next.js adapter credentials | Setup codes and tokens issued for the agent. |
Your repository and the connection to your Git provider are not touched. The workspace's model provider stays as it is.
The agent's ID is not reused. An agent you create afterwards has a new ID, and its snippet replaces the old one.
Next steps
- Create a Web Agent: start again from the same repository.
- Roll back to an earlier version: undo a bad release without deleting the agent.
- Versions, environments and deployments: what an agent is made of.
Last updated November 11, 2026