{"title":"Sauvegarde & restauration","slug":"backup-restore","category":"guides","summary":"Exportez vos mémoires pour sauvegarde, migrez entre minds, restaurez après une perte de données.","audience":["human","llm"],"tags":["guide","backup","restore","migration"],"difficulty":"beginner","updated":"2026-06-27","word_count":292,"read_minutes":1,"lang":"fr","translated":true,"requested_lang":"fr","content_markdown":"\n# Sauvegarde & restauration\n\nSynapse fournit un export/import complet pour la sauvegarde de mémoire, la migration\net la reprise après sinistre. Ce guide couvre les opérations essentielles.\n\n## Export\n\n### Export complet du mind\n\nExportez toutes les mémoires d'un mind en JSON :\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/mind-export > backup.json\n```\n\nFormat de réponse :\n\n```json\n{\n \"mind_id\": \"m_xyz789\",\n \"mind_name\": \"Work Mind\",\n \"exported_at\": \"2026-06-27T...\",\n \"memory_count\": 142,\n \"memories\": [\n {\n \"id\": \"mem_001\",\n \"category\": \"identity\",\n \"key\": \"user_name\",\n \"content\": \"Michael Schäfer\",\n \"tags\": [\"person\", \"identity\"],\n \"priority\": \"critical\",\n \"source\": \"user\",\n \"verified\": true,\n \"created_at\": \"2026-06-15T...\",\n \"updated_at\": \"2026-06-27T...\"\n }\n ]\n}\n```\n\n### Export incrémental (diff)\n\nExportez uniquement les mémoires modifiées depuis un horodatage :\n\n```bash\nSINCE=$(date -d \"2026-06-01\" +%s)\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/diff?since=$SINCE\" > incremental.json\n```\n\nRéponse :\n\n```json\n{\n \"added\": [...],\n \"updated\": [...],\n \"deleted\": [...]\n}\n```\n\n### Sauvegardes automatisées\n\nPlanifiez des sauvegardes quotidiennes via cron :\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/cron \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"schedule\": \"0 2 * * *\",\n \"endpoint\": \"https://synapse.schaefer.zone/memory/mind-export\",\n \"method\": \"GET\",\n \"headers\": {\"Authorization\": \"Bearer YOUR_MIND_KEY\"}\n }'\n```\n\n> [!NOTE]\n> L'endpoint cron reçoit la réponse mais ne la stocke pas. Pour de vraies sauvegardes,\n> pointez le cron vers votre propre serveur de sauvegarde qui enregistre la réponse.\n\n### Mieux : script de sauvegarde externe\n\n```bash\n#!/bin/bash\n# backup-synapse.sh\nMIND_KEY=\"${SYNAPSE_MIND_KEY}\"\nDATE=$(date +%Y%m%d)\nBACKUP_DIR=\"/backups/synapse\"\n\nmkdir -p \"$BACKUP_DIR\"\n\ncurl -s -H \"Authorization: Bearer $MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/mind-export \\\n > \"$BACKUP_DIR/synapse-$DATE.json\"\n\n# Conserver les 30 derniers jours\nfind \"$BACKUP_DIR\" -name \"synapse-*.json\" -mtime +30 -delete\n\necho \"Backup saved: $BACKUP_DIR/synapse-$DATE.json\"\n```\n\nAjoutez à crontab :\n\n```cron\n0 2 * * * /usr/local/bin/backup-synapse.sh\n```\n\n## Restauration\n\n### Restaurer vers le même mind\n\n```bash\n# Analyser la sauvegarde et re-POSTer chaque mémoire\njq -c '.memories[]' backup.json | while read mem; do\n curl -X POST https://synapse.schaefer.zone/memory \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"$(echo \"$mem\" | jq '{category, key, content, tags, priority}')\"\ndone\n```\n\n### Restaurer vers un nouveau mind\n\n```bash\n# 1. Créer un nouveau mind\nNEW_KEY=$(curl -s -X POST https://synapse.schaefer.zone/minds \\\n -H \"Authorization: Bearer YOUR_JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"name\":\"Restored Mind\",\"description\":\"Restore from backup\"}' \\\n | jq -r .mind_key)\n\n# 2. Importer les mémoires vers le nouveau mind\njq -c '.memories[]' backup.json | while read mem; do\n curl -X POST https://synapse.schaefer.zone/memory \\\n -H \"Authorization: Bearer $NEW_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"$(echo \"$mem\" | jq '{category, key, content, tags, priority}')\"\ndone\n```\n\n### Script de restauration Python\n\n```python\nimport json\nimport requests\n\nURL = \"https://synapse.schaefer.zone\"\nMIND_KEY = \"mk_...\"\n\ndef restore(backup_file):\n with open(backup_file) as f:\n data = json.load(f)\n \n for mem in data[\"memories\"]:\n requests.post(\n f\"{URL}/memory\",\n headers={\n \"Authorization\": f\"Bearer {MIND_KEY}\",\n \"Content-Type\": \"application/json\"\n },\n json={\n \"category\": mem[\"category\"],\n \"key\": mem[\"key\"],\n \"content\": mem[\"content\"],\n \"tags\": mem.get(\"tags\", []),\n \"priority\": mem.get(\"priority\", \"normal\")\n }\n )\n \n print(f\"Restored {len(data['memories'])} memories\")\n\nrestore(\"backup.json\")\n```\n\n## Migration entre minds\n\n```python\ndef migrate_memories(source_key, target_key):\n \"\"\"Migrate all memories from source mind to target mind.\"\"\"\n # Export depuis la source\n r = requests.get(\n f\"{URL}/memory/mind-export\",\n headers={\"Authorization\": f\"Bearer {source_key}\"}\n )\n data = r.json()\n \n # Import vers la cible\n for mem in data[\"memories\"]:\n requests.post(\n f\"{URL}/memory\",\n headers={\n \"Authorization\": f\"Bearer {target_key}\",\n \"Content-Type\": \"application/json\"\n },\n json={\n \"category\": mem[\"category\"],\n \"key\": mem[\"key\"],\n \"content\": mem[\"content\"],\n \"tags\": mem.get(\"tags\", []),\n \"priority\": mem.get(\"priority\", \"normal\")\n }\n )\n \n print(f\"Migrated {len(data['memories'])} memories\")\n```\n\n## Sauvegarder d'autres données\n\nN'oubliez pas de sauvegarder :\n\n| Type de données | Endpoint |\n|-----------|----------|\n| Mémoires | `GET /memory/mind-export` |\n| Tâches | `GET /mind/tasks` |\n| Scripts | `GET /scripts` |\n| Webhooks | `GET /webhooks` |\n| Tâches cron | `GET /cron` |\n| Variables | `GET /var` |\n| Historique chat | `GET /chat/history?limit=10000` |\n\n## Vérification\n\nAprès restauration, vérifiez :\n\n```bash\n# Compter les mémoires\ncurl -s -H \"Authorization: Bearer $KEY\" \\\n https://synapse.schaefer.zone/memory/stats | jq .total\n\n# Comparer avec la sauvegarde\njq .memory_count backup.json\n```\n\n## Bonnes pratiques\n\n> [!TIP]\n> - **Sauvegardez quotidiennement** — automatisez avec cron\n> - **Testez les restaurations** — une sauvegarde que vous ne pouvez pas restaurer est inutile\n> - **Conservez plusieurs versions** — au moins 30 jours\n> - **Stockez hors site** — S3, Backblaze B2, etc.\n> - **Chiffrez les sauvegardes sensibles** — les mémoires peuvent contenir des PII\n> - **Documentez le processus de restauration** — vous l'aurez oublié quand vous en aurez besoin\n\n## Prochaines étapes\n\n- [API Memory](/docs/api/memory)\n- [Cron & Scheduler](/docs/api/cron) — pour les sauvegardes automatisées\n","content_html":"

Sauvegarde & restauration

\n

Synapse fournit un export/import complet pour la sauvegarde de mémoire, la migration\net la reprise après sinistre. Ce guide couvre les opérations essentielles.

\n

Export

\n

Export complet du mind

\n

Exportez toutes les mémoires d'un mind en JSON :

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/mind-export > backup.json

Format de réponse :

\n
{\n  "mind_id": "m_xyz789",\n  "mind_name": "Work Mind",\n  "exported_at": "2026-06-27T...",\n  "memory_count": 142,\n  "memories": [\n    {\n      "id": "mem_001",\n      "category": "identity",\n      "key": "user_name",\n      "content": "Michael Schäfer",\n      "tags": ["person", "identity"],\n      "priority": "critical",\n      "source": "user",\n      "verified": true,\n      "created_at": "2026-06-15T...",\n      "updated_at": "2026-06-27T..."\n    }\n  ]\n}

Export incrémental (diff)

\n

Exportez uniquement les mémoires modifiées depuis un horodatage :

\n
SINCE=$(date -d "2026-06-01" +%s)\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/diff?since=$SINCE" > incremental.json

Réponse :

\n
{\n  "added": [...],\n  "updated": [...],\n  "deleted": [...]\n}

Sauvegardes automatisées

\n

Planifiez des sauvegardes quotidiennes via cron :

\n
curl -X POST https://synapse.schaefer.zone/cron \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "schedule": "0 2 * * *",\n    "endpoint": "https://synapse.schaefer.zone/memory/mind-export",\n    "method": "GET",\n    "headers": {"Authorization": "Bearer YOUR_MIND_KEY"}\n  }'
L'endpoint cron reçoit la réponse mais ne la stocke pas. Pour de vraies sauvegardes,\npointez le cron vers votre propre serveur de sauvegarde qui enregistre la réponse.

Mieux : script de sauvegarde externe

\n
#!/bin/bash\n# backup-synapse.sh\nMIND_KEY="${SYNAPSE_MIND_KEY}"\nDATE=$(date +%Y%m%d)\nBACKUP_DIR="/backups/synapse"\n\nmkdir -p "$BACKUP_DIR"\n\ncurl -s -H "Authorization: Bearer $MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/mind-export \\\n     > "$BACKUP_DIR/synapse-$DATE.json"\n\n# Conserver les 30 derniers jours\nfind "$BACKUP_DIR" -name "synapse-*.json" -mtime +30 -delete\n\necho "Backup saved: $BACKUP_DIR/synapse-$DATE.json"

Ajoutez à crontab :

\n
0 2 * * * /usr/local/bin/backup-synapse.sh

Restauration

\n

Restaurer vers le même mind

\n
# Analyser la sauvegarde et re-POSTer chaque mémoire\njq -c '.memories[]' backup.json | while read mem; do\n  curl -X POST https://synapse.schaefer.zone/memory \\\n    -H "Authorization: Bearer YOUR_MIND_KEY" \\\n    -H "Content-Type: application/json" \\\n    -d "$(echo "$mem" | jq '{category, key, content, tags, priority}')"\ndone

Restaurer vers un nouveau mind

\n
# 1. Créer un nouveau mind\nNEW_KEY=$(curl -s -X POST https://synapse.schaefer.zone/minds \\\n  -H "Authorization: Bearer YOUR_JWT" \\\n  -H "Content-Type: application/json" \\\n  -d '{"name":"Restored Mind","description":"Restore from backup"}' \\\n  | jq -r .mind_key)\n\n# 2. Importer les mémoires vers le nouveau mind\njq -c '.memories[]' backup.json | while read mem; do\n  curl -X POST https://synapse.schaefer.zone/memory \\\n    -H "Authorization: Bearer $NEW_KEY" \\\n    -H "Content-Type: application/json" \\\n    -d "$(echo "$mem" | jq '{category, key, content, tags, priority}')"\ndone

Script de restauration Python

\n
import json\nimport requests\n\nURL = "https://synapse.schaefer.zone"\nMIND_KEY = "mk_..."\n\ndef restore(backup_file):\n    with open(backup_file) as f:\n        data = json.load(f)\n    \n    for mem in data["memories"]:\n        requests.post(\n            f"{URL}/memory",\n            headers={\n                "Authorization": f"Bearer {MIND_KEY}",\n                "Content-Type": "application/json"\n            },\n            json={\n                "category": mem["category"],\n                "key": mem["key"],\n                "content": mem["content"],\n                "tags": mem.get("tags", []),\n                "priority": mem.get("priority", "normal")\n            }\n        )\n    \n    print(f"Restored {len(data['memories'])} memories")\n\nrestore("backup.json")

Migration entre minds

\n
def migrate_memories(source_key, target_key):\n    """Migrate all memories from source mind to target mind."""\n    # Export depuis la source\n    r = requests.get(\n        f"{URL}/memory/mind-export",\n        headers={"Authorization": f"Bearer {source_key}"}\n    )\n    data = r.json()\n    \n    # Import vers la cible\n    for mem in data["memories"]:\n        requests.post(\n            f"{URL}/memory",\n            headers={\n                "Authorization": f"Bearer {target_key}",\n                "Content-Type": "application/json"\n            },\n            json={\n                "category": mem["category"],\n                "key": mem["key"],\n                "content": mem["content"],\n                "tags": mem.get("tags", []),\n                "priority": mem.get("priority", "normal")\n            }\n        )\n    \n    print(f"Migrated {len(data['memories'])} memories")

Sauvegarder d'autres données

\n

N'oubliez pas de sauvegarder :

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Type de donnéesEndpoint
MémoiresGET /memory/mind-export
TâchesGET /mind/tasks
ScriptsGET /scripts
WebhooksGET /webhooks
Tâches cronGET /cron
VariablesGET /var
Historique chatGET /chat/history?limit=10000
\n

Vérification

\n

Après restauration, vérifiez :

\n
# Compter les mémoires\ncurl -s -H "Authorization: Bearer $KEY" \\\n     https://synapse.schaefer.zone/memory/stats | jq .total\n\n# Comparer avec la sauvegarde\njq .memory_count backup.json

Bonnes pratiques

\n

Prochaines étapes

\n\n","urls":{"html":"/docs/guides/backup-restore","text":"/docs/guides/backup-restore?format=text","json":"/docs/guides/backup-restore?format=json","llm":"/docs/guides/backup-restore?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}