Start a full export of all memories
amber_export_memoriesExport all memories to one downloadable JSON file for backups or migration. This async tool returns a task_id to poll until the download_url is ready.
Instructions
Start exporting your memories to a downloadable JSON file. Returns a task_id IMMEDIATELY -- the file is built in the background. Poll amber_get_export_status with that id until status is complete, then give the user the download_url it returns.
By DEFAULT exports ACTIVE memories only; pass include_deleted=true to also include trashed (soft-deleted) memories. IF THE USER ASKED FOR A BACKUP, PASS include_deleted=true. Amber's deletes are reversible, so an active-only archive is missing everything they could still restore -- on a real account that was 121 records against 6,334. The unattended route at /backups always includes the trash for that reason; active-only is the right choice for "let me look at my data", not for a backup. Each record carries content, subjects, topics, metadata (internal prefixes stripped), event dates, and timestamps (deleted records also carry deleted_at).
Use this when the user wants a backup, wants to migrate data, or asks "can I download my data?". Unlike amber_list_memories (which paginates one page at a time), this exports ALL memories into one file; unlike amber_search_memories (which finds specific content), this is a complete dump.
WHY IT IS ASYNC: an export of a large account cannot be produced inside one request, so it is built in slices in the background. There is no size limit and no truncation. A small account is usually ready on the first poll; a large one takes several. For an UNATTENDED schedule (a weekly cron with no assistant running), point the user at https://ambermem.com/backups instead -- same mechanism over plain HTTP.
Does not modify any data -- read-only. Requires an active subscription. Not rate-limited.
Errors: queue_failed (the export could not be queued; nothing was started, so retrying is safe and creates no orphan task).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "amber_export_memories"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| include_deleted | No | Also include trashed (soft-deleted) memories. Default false -- active memories only. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | Always `pending`: the export was queued. There is no download link yet, so do not tell the user it is ready. Poll `amber_get_export_status`. | |
| message | Yes | A human-readable summary of what was started and what to poll. | |
| task_id | Yes | Pass this to `amber_get_export_status`. Do NOT tell the user the export is ready yet -- nothing has been written at this point. | |
| exported_at | Yes | The timestamp stamped into the file itself, fixed when the task started. |