# Delete an Organization (/docs/overview/delete-organization)

> For the complete documentation index, see [llms.txt](https://docs.tandemcx.ai/llms.txt). Any page on this site can be fetched as Markdown by appending `.md` to its URL.

If you're an Owner and don't see **Delete this Organization** on **Admin → Organization**,
contact support.

Deleting an organization removes it and everything in it. Everyone loses access right away, and
the data is deleted 7 days later.

<Callout type="warn">
    **You can't undo a deletion yourself.** Export the recordings, transcripts, and reports you want
    to keep before you delete.
</Callout>

## Who can delete

Only an **Owner** can delete an organization. The section doesn't appear for anyone else.

A sub-tenant's Owners are its parent's Owners, so an Owner of the parent can delete a
sub-tenant, from the sub-tenant's own **Organization** page. The **Sub-Tenants** list on the
parent doesn't have a delete button.

[Personal access tokens](/docs/api/introduction/authentication#personal-access-tokens) can't
delete an organization. The request is refused, so the deletion has to be confirmed in the
browser.

## Delete an organization

1. Go to **Admin → Organization**. For a sub-tenant, switch into it first.
2. In **Delete this Organization**, select **Delete this Organization**.
3. The dialog lists what will be removed. For an organization with sub-tenants, it names them.
4. Type the organization's name exactly as shown. The match is case-sensitive.
5. Select **Delete this Organization**.

Tandem signs you out. If you deleted a sub-tenant, it switches you to the parent organization
instead.

## What is deleted

- **Agents, workflows, and knowledge bases.**
- **Conversations, recordings, and transcripts.**
- **Contacts.**
- **Phone numbers.** Each number is released to the carrier and can't be recovered.
- **SIP trunks**, and any toll-free verification, which is withdrawn.
- **Scheduling calendars and their bookings.** Bookings are removed without notice: customers
  with a booking are **not** emailed or texted, and no `booking.cancelled` webhook fires.
- **Chat widgets.**
- **Integrations and stored payment credentials.**
- **Members.** Someone who also belongs to another organization keeps their account and that
  membership. Everyone else's account is deleted.
- **Personal access tokens** for the organization. They stop working right away.

Queued and scheduled workflow runs stop when deleting starts.

## What a sub-tenant keeps

A deleted sub-tenant's reporting stays visible to its parent, under the name
**&lt;name&gt; (deleted)**. Its recordings and transcripts are deleted, and the call's detail
page shows **Deleted with its organization** where they were.

Deleting a top-level organization deletes its sub-tenants too, with all of their data, reporting
included. The dialog lists them first.

## Billing

On a top-level organization:

- The remaining prepaid balance is forfeited. There is no refund.
- Automatic billing is turned off.
- The contract ends.
- Saved cards are removed.

A sub-tenant has no balance, contract, or cards of its own, so deleting one changes nothing in
billing. See [Billing](/docs/overview/billing).

## The audit log

Audit events are kept for their [retention period](/docs/overview/audit-log#retention), and
deleting an organization doesn't remove them. When the deletion finishes, the log records an
`organization.deleted` event. A deleted sub-tenant's events stay visible to its parent.

## The first 7 days

As soon as you confirm, every member is signed out and the organization disappears from the
organization switcher. Nothing is deleted yet. Phone numbers, agents, workflows, and chat widgets
keep running.

7 days later, deleting starts and the steps below run. If the deletion was a mistake, or someone
else requested it from your account, contact support within those 7 days to stop it. After that it
can't be stopped.

## What to expect while it runs

Deletion runs in the background, in steps, and each step retries until it succeeds.

Calls and chats already in progress are left to finish, and the deletion waits for them
(for up to four hours) before it removes anything they write. It can take a while.

For an organization with sub-tenants, each sub-tenant is deleted before the parent. The parent's
**Sub-Tenants** list shows a sub-tenant being deleted as **Deleting…** until it's gone.

After the first pass finishes, Tandem checks again about 24 hours later and removes anything a
late call wrote.

## Next steps

<Cards>
    <Card
        title="Organization"
        href="/docs/overview/account-admin"
        description="Your organization's name, contact address and ID."
    />
    <Card
        title="Sub-Tenants"
        href="/docs/overview/sub-tenants"
        description="Separate organizations under this one."
    />
    <Card
        title="Audit Log"
        href="/docs/overview/audit-log"
        description="What Tandem records about changes to your organization."
    />
</Cards>