---
title: "Delete an AI Agent"
url: "https://help.magicblocks.ai/en/article/delete-an-ai-agent"
language: "en"
last_updated: "2026-03-18T08:15:06.312Z"
---

# Delete an AI Agent

To delete an AI Agent in MagicBlocks, you must first **pause the Agent**, then confirm the deletion from the Agent detail panel.

## Overview

Deleting an AI Agent permanently removes it from your workspace. Once deleted, the Agent and its configuration cannot be recovered.

For safety, MagicBlocks requires the Agent to be **paused first** before deletion. This prevents accidental removal of active Agents that may still be handling conversations or collecting contacts.

## When to Use

Delete an AI Agent when:

-   You created a test Agent that you no longer need
-   You are replacing an Agent with a new version
-   You want to clean up unused Agents in your workspace
-   A campaign or project using that Agent has ended

If the Agent is still active, you must **pause it first** before the Delete option becomes available.

## How It Works / Steps

### Step 1 — Open the Agents Page

Click **Agents** in the left sidebar of your MagicBlocks workspace.

### Step 2 — View the Agent Details

Hover over the Agent you want to delete and click **View Detail** on the right panel of the Agent.

This opens the Agent’s **detail panel**.

### Step 3 — Pause the Agent

In the detail panel:

1.  Click the **Pause toggle**
2.  Confirm by clicking **Pause**

Wait until the system shows a **Pause success notification** and confirm the **Status displays "Paused."**

### Step 4 — Delete the Agent

Once the Agent is paused:

1.  Click the **Delete** button in the detail panel
2.  A confirmation dialog will appear:  
    **"This selected Agent will be deleted."**

Click **Delete** to confirm.

### Step 5 — Deletion Complete

After confirmation, the system removes the Agent from your workspace.

You will see the confirmation message:  
**"Agent deleted."**

✅ The AI Agent is now permanently removed.

## Examples / Templates

**Example scenario:**  
You created a test AI Agent while experimenting with conversation flows. After building a production-ready Agent, you decide to remove the test version.

Steps:

-   Open **Agents**
-   View details of the test Agent
-   Pause the Agent
-   Click **Delete**
-   Confirm deletion

The test Agent is now removed from your workspace.

## Best Practices

-   Always confirm the Agent is **paused** before deleting.
-   Review whether the Agent is still connected to **channels, campaigns, or contact flows**.
-   Only delete Agents you are certain you no longer need, since deletion **cannot be undone**.

## FAQs

### Why do I need to pause an Agent before deleting it?

MagicBlocks requires Agents to be paused to prevent accidental deletion of active Agents that may still be handling conversations.

### Can I recover a deleted Agent?

No. Once an Agent is deleted, it **cannot be restored**.

### What happens to sessions from a deleted Agent?

Past sessions remain stored in the platform for analysis, even after the Agent is deleted.

### I don't see the Delete button. Why?

The Delete button only appears after the Agent’s **Status is Paused**.