Overview
This guide explains how to back up and export your memory archives, migrate data between platforms, and set up notification webhooks. These features help you maintain data portability, integrate with external systems, and ensure your stored memories can be easily backed up or transferred.
Exporting Memory Archives
Export Overview
You can generate and retrieve archives of your stored memories using export tools and API methods. Exports allow you to back up your data or format memories into structured schemas.
Creating a Memory Export
- Define the filters (such as specific users, runs, or categories) and the JSON schema or format requirements for your data.
- Initiate the export request via the API or dashboard to generate a new export archive.
- Once processing is complete, retrieve the export package using the returned export identifier.
Note
Exports may process asynchronously depending on the volume of data. Use the status checking tools or event trackers to confirm when your export file is ready for download.
Migrating Data Between Platforms
Migration Overview
If you are transitioning memory data from a self-hosted vector store or community setup to a managed platform account, you can use migration and import utilities.
Migration Steps
- Export existing data: Run the export script or utility targeting your current storage collection (such as a local database or Qdrant collection) to output a structured JSON archive.
- Review the export file: Inspect the generated JSON file to verify that record counts and metadata attributes match your expectations.
- Import to the target platform: Run the import utility referencing your export file and destination platform credentials.
Warning
Ensure your API keys and environment variables are correctly configured before running import or migration commands to prevent partial data transfers or authentication failures.
Setting up Notification Webhooks
Webhook Overview
Webhooks enable your projects to receive automated real-time HTTP notifications whenever specific events occur within your project.
Managing Webhooks
You can list, create, update, and delete webhooks programmatically or via your project settings. When creating a webhook, you must provide a valid target URL, a descriptive name, and a list of event types that will trigger notifications.
| Action | Description |
|---|---|
| List Webhooks | Retrieve all configured webhooks associated with your project ID. |
| Create Webhook | Register a new endpoint URL and subscribe to specific event types. |
| Update Webhook | Modify an existing webhook's name, target URL, or event subscriptions. |
| Delete Webhook | Remove a webhook configuration permanently to stop notifications. |
Tip
Always verify that your target webhook endpoint can successfully receive and respond to incoming HTTP POST requests with a 2xx status code to avoid missed event deliveries.