# Retention & Purge

Automatically manage the lifecycle of conversations in your workspace — keeping inboxes clean and supporting your data retention requirements.

**Note:** This feature is available to **workspace admins only**. To access Retention & Purge, go to **Workspace Settings → Purge**.

<figure><img src="/files/Tr0iaklC0EYdcPkt7RKC" alt=""><figcaption></figcaption></figure>

***

## How it works

Every conversation follows a predictable lifecycle:

**Active → Rule matches (or moved to Deleted folder) → Purge queue → Grace period (30 days) → Permanently deleted**

*Exception: Bot chats are deleted immediately after the retention period ends, with no grace period.*

At any point during the grace period, an admin can cancel or exempt a conversation from deletion via **Upcoming Purges**.

## Key concepts

| Term             | Definition                                                                                                                                                               |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Retention period | How long a conversation can remain unmodified before being queued for deletion. The clock starts from the last modified date, not the date the conversation was created. |
| Grace period     | Time between being queued and permanently deleted (workspace default: 30 days)                                                                                           |
| Purge queue      | List of conversations scheduled for deletion                                                                                                                             |
| Exemption        | Permanent protection from deletion — overrides all rules                                                                                                                 |

## What admins can control

* Define retention rules for Shared Inboxes and Bot Chats
* Review and cancel upcoming deletions before the grace period ends
* Exempt individual conversations from ever being deleted
* Enable auto-purge for conversations moved to the Deleted folder

## Getting started

1. Enable purging in **Workspace Settings → Purge**
2. Create a rule — set the scope and retention period
3. Review upcoming deletions regularly in **Upcoming Purges**

Start conservative — longer retention periods give you more time to catch mistakes.

{% hint style="danger" %}
Permanent deletion cannot be undone. Once a conversation is purged, it cannot be recovered. Always review **Upcoming Purges** before grace periods expire.
{% endhint %}

* [Overview](/retention-and-purge/overview.md)
* [Rules](/retention-and-purge/rules.md)
* [Upcoming Purges & Exemptions](/retention-and-purge/upcoming-purges-and-exemptions.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.intheloop.io/retention-and-purge.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.