Compare commits

...

1 Commits

Author SHA1 Message Date
Paurush Mittal 2e09cc383b docs: clarify structured exports are not raw backups 2026-08-14 00:39:40 +05:30
2 changed files with 14 additions and 4 deletions
@@ -4,10 +4,14 @@ description: "Retrieve, review, and migrate user memories with structured export
---
Mem0 is a dynamic memory store that gives you full control over your data. Along with storing memories, it gives you the ability to retrieve, export, and migrate your data whenever you need.
Mem0 is a dynamic memory store that lets you retrieve memories as raw records or transform them into a structured export for downstream use.
This cookbook shows you how to retrieve and export your data for inspection, migration, or compliance.
<Warning>
The structured export job is not a raw backup. It uses the schema and instructions you provide to transform matching memories. Use paginated `get_all()` calls when you need the original memory records. For an account-level data access or compliance request that the API cannot complete, contact support.
</Warning>
---
## Setup
@@ -254,7 +258,7 @@ You can also export memories directly from the Mem0 platform UI:
3. Select your filters and schema
4. Download the completed export as JSON
This is useful for one-off exports or manual data reviews.
This is useful for one-off structured exports or manual data reviews. It does not create a raw backup of every memory record; use paginated `get_all()` calls for raw retrieval.
<Warning>
Exported data expires after 7 days. Download and store exports locally if you need long-term archives. After expiration, you'll need to recreate the export job.
@@ -272,13 +276,13 @@ A complete memory export system with multiple retrieval methods:
- **Export instructions** - Guide conflict resolution and data formatting
- **Platform UI exports** - One-off manual downloads via dashboard
This covers data portability, GDPR compliance, system migrations, and manual reviews.
These approaches support data inspection, portability workflows, system migrations, and manual reviews. Use raw retrieval or contact support when a compliance request requires the original records rather than a schema-transformed export.
---
## Summary
Use **`get_all()`** for bulk retrieval, **`search()`** for specific questions, and **`create_memory_export()`** for structured data exports with custom schemas. Remember exports expire after 7 days: download them locally for long-term archives.
Use **`get_all()`** for paginated raw retrieval, **`search()`** for specific questions, and **`create_memory_export()`** for schema-transformed data. Structured exports expire after 7 days, so download completed results promptly. Do not treat them as raw backups.
<CardGroup cols={2}>
<Card title="Build a Mem0 Companion" icon="users" href="/cookbooks/essentials/building-ai-companion">
+6
View File
@@ -7,6 +7,10 @@ description: 'Export memories in a structured format using customizable Pydantic
The Memory Export feature allows you to create structured exports of memories using customizable Pydantic schemas. This process enables you to transform your stored memories into specific data formats that match your needs. You can apply various filters to narrow down which memories to export and define exactly how the data should be structured.
<Warning>
Memory Export transforms matching memories into the schema you provide. It is not a raw backup or a byte-for-byte download of every stored memory record. If you need the original memory records, retrieve them with the paginated `get_all()` API instead. For an account-level data access or compliance request that cannot be completed through the API, contact support.
</Warning>
## Creating a Memory Export
To create a memory export, you'll need to:
@@ -278,6 +282,8 @@ You can apply various filters to customize which memories are included in the ex
The export process may take some time to complete, especially when dealing with a large number of memories or complex schemas.
</Note>
If an export remains in progress unexpectedly, do not submit duplicate jobs. Retrieve the job by its export ID to check its status, then contact support with that ID if it does not complete.
If you have any questions, please feel free to reach out to us using one of the following methods:
<Snippet file="get-help.mdx" />