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.

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.

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

1. Delete request

   We re-verify your account and ownership before any data is touched.

2. 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
3. Redirect

   A success message reads Agent deleted and the page redirects to your dashboard.

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, bulk-export selected rows to CSV.
• Voice Conversations, click Download Transcript per call. (Audio export is on the roadmap.)
• Leads & Tickets, All CSV button on the toolbar exports every record matching the current filter.

Run these exports before clicking Delete Agent.

Common questions

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.

I typed DELETE in lowercase and the button is still grey.

The confirmation is case-sensitive. Type it in capitals: DELETE.

My typed text disappeared when I closed the dialog.

That’s intentional — the input clears on close so you always start fresh next time.

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.

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.

I want to keep the conversation history but reset the agent.

Don’t delete. Use Agent Settings to clear the prompt, knowledge base, and integrations, then save. The conversation history stays since the agent itself isn’t deleted.

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 or the Deployment editor’s Agent Status card), wait for any active calls to finish, then delete.

Next

Agent Settings

Edit settings instead of deleting.

Plans & Subscriptions

Billing history outlives deleted agents.