> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wittify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Agent

> Permanently delete an agent. The flow requires typing a confirmation keyword, never a single click. Everything the agent owns goes with it: conversations, leads, tickets, recordings, transcripts, knowledge base files, integrations, telephony provisioning.

<Warning>
  Deletion is **permanent**. The agent's conversations, leads, tickets, recordings, transcripts, and analytics are all deleted with it. There is no undo. There is no "recently deleted" recycling bin at the agent level. If you need any of this data, export it first.
</Warning>

## Where the button lives

Every Agent Settings page has a **Danger Zone** card at the bottom with a red **Delete Agent** button. The Danger Zone appears on every settings tab — **Text Settings**, **Voice Settings**, **Appearance**, **Knowledge Base**, **Tickets & Leads**, **Integrations**, **Deployment** — and deleting from any of them runs the same flow.

## The confirmation dialog

Clicking the button opens a confirmation with a typed-keyword check:

* **Title:** *Delete this agent?*
* **Description:** *This cannot be undone. The agent and all its data — conversations, leads, tickets, recordings, knowledge base — will be permanently removed.*
* **Hint:** *Type **DELETE** to confirm*
* An input where you type the keyword
* **Cancel** to close
* A red **Delete Agent** button that activates only when you type `DELETE` in capital letters

You cannot proceed by clicking only. You must type the keyword. Pressing Escape, clicking outside, or clicking Cancel closes the dialog without deleting.

## What happens on confirm

<Steps>
  <Step title="Delete request">
    We re-verify your account and ownership before any data is touched.
  </Step>

  <Step title="Cleanup">
    We remove:

    * All conversations (text + voice)
    * All leads and tickets
    * All recordings and transcripts
    * All knowledge base files, FAQs, and indexed URLs
    * All connected integrations (access is revoked)
    * Telephony provisioning (phone numbers are released)
    * Webhook subscriptions
  </Step>

  <Step title="Redirect">
    A success message reads *Agent deleted* and the page redirects to your dashboard.
  </Step>
</Steps>

If the delete fails (network error, permission issue), an error message reads *Failed to delete. Please try again.* and the dialog stays open. The typed keyword stays so you can retry without re-typing.

## Why typed confirmation

Single-click delete is too easy to misclick, especially at the bottom of a long settings page. The typed-keyword pattern (used by GitHub, Stripe, AWS, and most platform tools) forces you to slow down and copy a specific string. The destructive red Confirm button is a second visual cue.

The keyword is **DELETE** in English regardless of dashboard language, so the muscle memory is consistent across teams.

## What's preserved after deletion

A few things outlive the agent because they belong to your account, not the agent:

* **Billing history**, invoices, subscription state, top-up purchases.
* **User Activities log**, the deletion event itself is logged with timestamp, IP, and browser.
* **Aggregate analytics**, anonymized counts roll up to your account-level dashboards (so deleting an agent doesn't rewrite history).

## Recovery

There is no recovery once delete confirms. The data is gone, and the database doesn't keep a snapshot.

If you need a copy of conversations, leads, or other data before deleting:

* **[Chat Conversations](/en/Systems/AI-Agents/Manage-Agent/Chat-Conversations)**, bulk-export selected rows to CSV.
* **[Voice Conversations](/en/Systems/AI-Agents/Manage-Agent/Voice-Conversations)**, click **Download Transcript** per call. (Audio export is on the roadmap.)
* **[Leads & Tickets](/en/Systems/AI-Agents/Manage-Agent/Leads-and-Tickets)**, **All CSV** button on the toolbar exports every record matching the current filter.

Run these exports **before** clicking Delete Agent.

## Common questions

<AccordionGroup>
  <Accordion title="I clicked Delete by accident, the dialog is open. How do I cancel?">
    Press Escape, click outside the dialog, or click **Cancel**. None of those run any deletion. Only typing `DELETE` and clicking the red Confirm button starts the deletion.
  </Accordion>

  <Accordion title="I typed DELETE in lowercase and the button is still grey.">
    The confirmation is case-sensitive. Type it in capitals: `DELETE`.
  </Accordion>

  <Accordion title="My typed text disappeared when I closed the dialog.">
    That's intentional — the input clears on close so you always start fresh next time.
  </Accordion>

  <Accordion title="Can I delete one of multiple agents without affecting the others?">
    Yes. Deletion is scoped to one agent at a time. Other agents on your account are untouched.
  </Accordion>

  <Accordion title="The toast said 'Agent deleted' but I still see the agent in the sidebar.">
    Refresh the page. The sidebar reads from a cached agent list that updates within a few seconds. If it persists after a hard refresh, contact support.
  </Accordion>

  <Accordion title="I want to keep the conversation history but reset the agent.">
    Don't delete. Use [Agent Settings](/en/Systems/AI-Agents/Manage-Agent/Agent-Settings) to clear the prompt, knowledge base, and integrations, then save. The conversation history stays since the agent itself isn't deleted.
  </Accordion>

  <Accordion title="Can I delete an agent that's currently Active?">
    Yes. The agent gets deactivated as part of the deletion. Any in-flight conversations are interrupted. Ideally, deactivate first (in [Deployment](/en/Systems/AI-Agents/Wizard/Deployment) or the Deployment editor's Agent Status card), wait for any active calls to finish, then delete.
  </Accordion>
</AccordionGroup>

## Next

<CardGroup cols={2}>
  <Card title="Agent Settings" icon="gear" href="/en/Systems/AI-Agents/Manage-Agent/Agent-Settings">
    Edit settings instead of deleting.
  </Card>

  <Card title="Plans & Subscriptions" icon="receipt" href="/en/Account/Plans-and-Subscriptions">
    Billing history outlives deleted agents.
  </Card>
</CardGroup>