---
schema_version: "1"
id: 9954a52cee92ee2d20eee79633315d23d750e7b9a0f087589b96310c27c17dc6
title: Delete an Agent or Agent Version
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ai/264-0-0/agent_versions_delete.md
canonical_url: https://help.salesforce.com/s/articleView?id=ai.agent_versions_delete.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: d41ae37973889dac38325282bcc30d51350113339c55e2e0da7de30754cf717a
description: Delete an agent or agent version to remove it entirely from Agentforce Builder. You can’t recover the agent after its deleted.
products:
  - Agentforce
  - Cross Cloud
release: "264"
---
# 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

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong> Editions. <a href="https://help.salesforce.com/s/articleView?id=ai.agent_setup_explore_types.htm&amp;release=264.0.0&amp;type=5" title="Learn about agent types and default templates for specific clouds and common use cases.">Required add-on licenses vary by agent type.</a></td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
          <colgroup>
            <col style="width:50%">
            <col style="width:50%">
          </colgroup>
          <thead class="slds-text-title_caps ">
            <tr class="">
              <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d145982e93">User Permissions
                Needed</th>
            </tr>
          </thead>
          <tbody>
            <tr class="">
              <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d145982e93 ">To create an agent:</td>

              <td class="slds-cell-wrap" style="vertical-align:top;" headers="d145982e93 ">Manage AI Agents AND <a href="https://help.salesforce.com/s/articleView?id=ai.agent_setup_explore_types.htm&amp;type=5&amp;language=en_US" target="_blank">the required permissions for your agent
                  type</a></td>

            </tr>
          </tbody>
        </table>

1. From the App Launcher, find and select **Agentforce Studio**, then click **Agents**.
2. From the Agents page of the Agentforce Studio app, open the agent whose version you want to delete.
3. From the header in Agentforce Builder, select the agent version you want to delete.
4. 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](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/images/icon_note.png)

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](https://help.salesforce.com/s/articleView?id=ai.agent_multi_orch_remove.htm&release=264.0.0&type=5 "Remove a connected subagent you no longer need from your orchestrator agent. Removing the connected subagent doesn’t affect the reference agent on which this connected agent is based.").

1. From the App Launcher, find and select **Agentforce Studio**, then click **Agents**.
2. 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.