Delete an Agent or Agent Version

Delete an agent or agent version to remove it entirely from Agentforce Builder. You can’t recover the agent after its deleted.

Delete an Agent Version

Required Editions

Available in: Lightning Experience

Available in: Enterprise, Performance, Unlimited, and Developer Editions. Required add-on licenses vary by agent type.

User Permissions Needed
To create an agent:	Manage AI Agents AND the required permissions for your agent type

From the App Launcher, find and select Agentforce Studio, then click Agents.
From the Agents page of the Agentforce Studio app, open the agent whose version you want to delete.
From the header in Agentforce Builder, select the agent version you want to delete.
Next to the Activate or Commit Version button, select the dropdown arrow and click Delete Version. If there’s only one version, the entire agent is deleted.

Active agents or agent versions can’t be deleted. Deactivate your agent or agent version before deleting it.

Delete an Entire Agent

Note If you attempt to remove an agent that’s used as a connected subagent in a multi-agent solution, you're warned to remove any connected subagents first, before you delete the agent. See Remove a Connected Subagent from an Orchestrator Agent.

From the App Launcher, find and select Agentforce Studio, then click Agents.
In the All Agents list on the Agents page, find the row for the agent you want to delete. Open the dropdown menu and select Delete Agent. After an agent or agent version is deleted, it can’t be recovered.

Agents from the legacy may appear in the agents list with the Delete button disabled. Legacy agents must be deleted from the legacy builder.