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

# Retention settings

> Record retention intent and understand the limits of automatic deletion and historical cleanup.

A retention period states how long a data category should remain available. Treat that policy separately from the mechanism that performs and verifies deletion.

<Warning>
  Automatic retention enforcement and scheduled cleanup are not implemented. Saving the fields below does not start a deletion job or establish a retention deadline.
</Warning>

| Configuration field | Current meaning |
| - | - |
| `platform_settings.privacy.retention_days` | Saved period; default `-1` represents no configured limit |
| `platform_settings.privacy.apply_to_existing_conversations` | Saved historical-application intent; default false |
| Workspace `rag_retention` | Separate saved knowledge-related preference |
| Workspace `conversation_embedding_retention_days` | Separate saved embedding-retention preference |

The [workspace settings contract](/api-reference/agents-platform/update-agents-platform-settings) accepts those workspace preferences. They are not proof of a working cleanup process.

<Steps>
  <Step title="Define the scope" id="retention-define-scope">
    Specify the data category, intended period, policy owner, and whether existing records are included. Avoid using one transcript setting as a policy for every copy.
  </Step>

  <Step title="Save intent for review" id="retention-save-intent">
    Review the agent's full privacy configuration in an [agent draft](/api-reference/agents-platform/create-agent-draft). Read it back and record enforcement as pending.
  </Step>

  <Step title="Handle explicit removals separately" id="retention-explicit-removal">
    Use [Delete conversation](/api-reference/agents-platform/delete-conversation) only for an identified, authorized record. Keep external exports and connected-service copies in your removal checklist.
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="Will apply_to_existing_conversations clean up history?" id="retention-faq-history">No. It records intent without an implemented historical cleanup job.</Accordion>
  <Accordion title="Does retention_days guarantee deletion on that day?" id="retention-faq-deadline">No. A released scheduler, deletion scope, and verification process are required before making that guarantee.</Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.