{"title":"API Memory","slug":"memory","category":"api","summary":"Référence complète des 22 endpoints mémoire : stockage, rappel, recherche, recherche sémantique, synchronisation, audit et plus.","audience":["human","llm"],"tags":["api","memory","crud","search","fts5","semantic"],"difficulty":"intermediate","updated":"2026-06-27","word_count":609,"read_minutes":3,"llm_context":"Auth: Mind Key (Authorization: Bearer mk_xxx OR ?key=mk_xxx)\nALWAYS call GET /memory/recall at session start.\nPOST /memory with same category+key updates the existing memory.\nCategories: identity, preference, fact, project, skill, mistake, context, note, credentials\nPriorities: low, normal, high, critical\nSearch: GET /memory/search?q=... (FTS5 syntax: AND, OR, \"phrases\", prefix*)\nSemantic: GET /memory/semantic-search?q=... (slower, conceptual)\nSync: GET /memory/diff?since=TIMESTAMP (incremental sync)\nExport: GET /memory/mind-export (full JSON dump)\n","lang":"fr","translated":true,"requested_lang":"fr","content_markdown":"\n# API Memory\n\nL'API Memory est le cœur de Synapse. Elle fournit 22 endpoints pour stocker,\nrécupérer, rechercher et gérer des mémoires structurées. Tous les endpoints\nnécessitent une Mind Key pour l'authentification.\n\n> [!CRITICAL]\n> **Appelez toujours `GET /memory/recall` au début de chaque session.** C'est le\n> seul moyen de reconstruire le contexte des sessions précédentes.\n\n## Catégories\n\nLes mémoires sont organisées en 8 catégories :\n\n| Catégorie | Cas d'usage |\n|----------|----------|\n| `identity` | Nom de l'utilisateur, rôle, infos de contact, préférences sur soi |\n| `preference` | Goûts, aversions, style de travail, préférences de communication |\n| `fact` | Faits vérifiables (détails de projet, dates, URLs) |\n| `project` | Statut de projet, jalons, architecture |\n| `skill` | Choses dont l'utilisateur est bon |\n| `mistake` | Erreurs passées — à éviter de répéter |\n| `context` | Contexte pertinent à la session |\n| `note` | Notes diverses |\n\n## Priorités\n\n- `low` — utile de savoir\n- `normal` — par défaut\n- `high` — important\n- `critical` — à ne jamais oublier (identité de l'utilisateur, infos légales)\n\n## Endpoints principaux\n\n### GET /memory/recall\n\nRenvoie TOUTES les mémoires sous forme de texte brut optimisé pour les LLM. Appelez-le\nà chaque début de session.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\nRéponse (text/plain) :\n\n```\nMind: Michael's Mind\nMemories: 12 total (10 verified)\n\n[001] identity (CRITICAL)\n user_name\n Michael Schäfer\n Tags: person, identity\n\n...\n```\n\n### POST /memory\n\nStocke une nouvelle mémoire ou met à jour une mémoire existante (même catégorie +\nclé = mise à jour).\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"category\": \"fact\",\n \"key\": \"user_name\",\n \"content\": \"The user's name is Michael Schäfer\",\n \"tags\": [\"person\", \"identity\"],\n \"priority\": \"critical\"\n }'\n```\n\nRéponse : `{ \"id\": \"mem_001\", \"status\": \"stored\" }`\n\n### GET /memory\n\nListe les mémoires avec filtres optionnels.\n\n```bash\n# Toutes les mémoires (JSON)\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory?limit=50&offset=0\"\n\n# Filtrer par catégorie\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory?category=project\"\n\n# Filtrer par tag\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory?tag=docker\"\n```\n\n### PUT /memory/:id\n\nMet à jour une mémoire spécifique par ID.\n\n```bash\ncurl -X PUT https://synapse.schaefer.zone/memory/mem_001 \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"content\": \"Updated content\", \"priority\": \"high\"}'\n```\n\n### DELETE /memory/:id\n\nSupprime une seule mémoire.\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/mem_001\n```\n\n## Endpoints de recherche\n\n### GET /memory/search\n\nRecherche en texte intégral utilisant FTS5.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=docker+swarm\"\n```\n\nSyntaxe FTS5 :\n\n- Plusieurs mots = AND : `docker swarm`\n- Phrase : `\"docker swarm\"`\n- Préfixe : `docker*`\n- Booléen : `docker OR kubernetes`\n- Exclusion : `docker -swarm`\n\n### GET /memory/semantic-search\n\nRecherche conceptuelle utilisant des embeddings (plus lente que FTS5 mais comprend\nle sens).\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/semantic-search?q=container+orchestration\"\n```\n\nRenvoie les mémoires sémantiquement similaires à la requête, même si aucun mot-clé ne\ncorrespond. Utile pour « trouver des mémoires à propos de X » où X est décrit\ndifféremment.\n\n### GET /memory/by-tag\n\nListe les mémoires par tag.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/by-tag?tag=docker\n```\n\n### GET /memory/related/:id\n\nTrouve les mémoires liées à une mémoire spécifique (via des tags partagés).\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/related/mem_001\n```\n\n## Sync & Diff\n\n### GET /memory/diff\n\nSynchronisation incrémentale — renvoie les mémoires modifiées depuis un horodatage.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/diff?since=1700000000\"\n```\n\nRéponse : `{ \"added\": [...], \"updated\": [...], \"deleted\": [...] }`\n\n### POST /memory/sync\n\nApplique un diff depuis une autre instance (pour la synchronisation auto-hébergée).\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory/sync \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"added\": [...], \"updated\": [...], \"deleted\": [...]}'\n```\n\n## Opérations en masse\n\n### POST /memory/bulk-delete\n\nSupprime plusieurs mémoires par ID.\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory/bulk-delete \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"ids\": [\"mem_001\", \"mem_002\", \"mem_003\"]}'\n```\n\n### POST /memory/embed-batch\n\nGénère des embeddings pour les mémoires qui n'en ont pas encore (pour la recherche\nsémantique).\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory/embed-batch \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"limit\": 100}'\n```\n\n### GET /memory/embed-batch-status\n\nVérifie la progression de la génération d'embeddings.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/embed-batch-status\n```\n\n## Vérification\n\nLes mémoires ont un indicateur `verified`. Les mémoires stockées par l'agent sont non\nvérifiées par défaut (`source=agent`) ; les mémoires stockées par l'humain sont\nvérifiées (`source=user`).\n\n### POST /memory/verify\n\nMarque une mémoire comme vérifiée (nécessite un JWT, pas une Mind Key).\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory/mem_001/verify \\\n -H \"Authorization: Bearer YOUR_JWT\"\n```\n\n### POST /memory/unverify\n\nMarque une mémoire comme non vérifiée (nécessite un JWT).\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory/mem_001/unverify \\\n -H \"Authorization: Bearer YOUR_JWT\"\n```\n\n### GET /memory/unverified\n\nListe les mémoires en attente de vérification humaine.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/unverified?limit=100\"\n```\n\n## Statistiques & Audit\n\n### GET /memory/stats\n\nStatistiques agrégées pour le mind courant.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/stats\n```\n\nRenvoie : `{ \"total\": 12, \"verified\": 10, \"unverified\": 2, \"by_category\": {...}, \"by_priority\": {...} }`\n\n### GET /memory/audit\n\nJournal d'audit de toutes les opérations modifiant l'état.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/audit?limit=100&action=store\"\n```\n\n### GET /memory/contradictions\n\nDétecte les contradictions potentielles dans les mémoires stockées.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/contradictions\n```\n\n### GET /memory/expiring\n\nListe les mémoires dont la date d'expiration approche.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/expiring?within=7d\"\n```\n\n## Santé & Export\n\n### GET /memory/health\n\nVérification rapide de la santé du système de mémoire.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/health\n```\n\n### GET /memory/mind-export\n\nExport JSON complet de toutes les mémoires (pour sauvegarde).\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/mind-export > backup.json\n```\n\n### POST /memory/compact\n\nCompacte les mémoires similaires (résumé automatique).\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory/compact \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"dry_run\": true}'\n```\n\n## Prochaines étapes\n\n- [Démarrage rapide pour les LLM](/docs/getting-started/quick-start-llm)\n- [Bonnes pratiques mémoire](/docs/guides/memory-best-practices)\n- [Recherche FTS5](/docs/concepts/fts5-search)\n- [Recherche sémantique](/docs/concepts/semantic-search)\n","content_html":"

API Memory

\n

L'API Memory est le cœur de Synapse. Elle fournit 22 endpoints pour stocker,\nrécupérer, rechercher et gérer des mémoires structurées. Tous les endpoints\nnécessitent une Mind Key pour l'authentification.

\n
**Appelez toujours `GET /memory/recall` au début de chaque session.** C'est le\nseul moyen de reconstruire le contexte des sessions précédentes.

Catégories

\n

Les mémoires sont organisées en 8 catégories :

\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\n\n\n\n
CatégorieCas d'usage
identityNom de l'utilisateur, rôle, infos de contact, préférences sur soi
preferenceGoûts, aversions, style de travail, préférences de communication
factFaits vérifiables (détails de projet, dates, URLs)
projectStatut de projet, jalons, architecture
skillChoses dont l'utilisateur est bon
mistakeErreurs passées — à éviter de répéter
contextContexte pertinent à la session
noteNotes diverses
\n

Priorités

\n\n

Endpoints principaux

\n

GET /memory/recall

\n

Renvoie TOUTES les mémoires sous forme de texte brut optimisé pour les LLM. Appelez-le\nà chaque début de session.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/recall

Réponse (text/plain) :

\n
Mind: Michael's Mind\nMemories: 12 total (10 verified)\n\n[001] identity (CRITICAL)\n  user_name\n  Michael Schäfer\n  Tags: person, identity\n\n...

POST /memory

\n

Stocke une nouvelle mémoire ou met à jour une mémoire existante (même catégorie +\nclé = mise à jour).

\n
curl -X POST https://synapse.schaefer.zone/memory \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "category": "fact",\n    "key": "user_name",\n    "content": "The user's name is Michael Schäfer",\n    "tags": ["person", "identity"],\n    "priority": "critical"\n  }'

Réponse : { "id": "mem_001", "status": "stored" }

\n

GET /memory

\n

Liste les mémoires avec filtres optionnels.

\n
# Toutes les mémoires (JSON)\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory?limit=50&offset=0"\n\n# Filtrer par catégorie\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory?category=project"\n\n# Filtrer par tag\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory?tag=docker"

PUT /memory/:id

\n

Met à jour une mémoire spécifique par ID.

\n
curl -X PUT https://synapse.schaefer.zone/memory/mem_001 \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{"content": "Updated content", "priority": "high"}'

DELETE /memory/:id

\n

Supprime une seule mémoire.

\n
curl -X DELETE -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/mem_001

Endpoints de recherche

\n

GET /memory/search

\n

Recherche en texte intégral utilisant FTS5.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/search?q=docker+swarm"

Syntaxe FTS5 :

\n\n

GET /memory/semantic-search

\n

Recherche conceptuelle utilisant des embeddings (plus lente que FTS5 mais comprend\nle sens).

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/semantic-search?q=container+orchestration"

Renvoie les mémoires sémantiquement similaires à la requête, même si aucun mot-clé ne\ncorrespond. Utile pour « trouver des mémoires à propos de X » où X est décrit\ndifféremment.

\n

GET /memory/by-tag

\n

Liste les mémoires par tag.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/by-tag?tag=docker

GET /memory/related/:id

\n

Trouve les mémoires liées à une mémoire spécifique (via des tags partagés).

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/related/mem_001

Sync & Diff

\n

GET /memory/diff

\n

Synchronisation incrémentale — renvoie les mémoires modifiées depuis un horodatage.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/diff?since=1700000000"

Réponse : { "added": [...], "updated": [...], "deleted": [...] }

\n

POST /memory/sync

\n

Applique un diff depuis une autre instance (pour la synchronisation auto-hébergée).

\n
curl -X POST https://synapse.schaefer.zone/memory/sync \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{"added": [...], "updated": [...], "deleted": [...]}'

Opérations en masse

\n

POST /memory/bulk-delete

\n

Supprime plusieurs mémoires par ID.

\n
curl -X POST https://synapse.schaefer.zone/memory/bulk-delete \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{"ids": ["mem_001", "mem_002", "mem_003"]}'

POST /memory/embed-batch

\n

Génère des embeddings pour les mémoires qui n'en ont pas encore (pour la recherche\nsémantique).

\n
curl -X POST https://synapse.schaefer.zone/memory/embed-batch \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{"limit": 100}'

GET /memory/embed-batch-status

\n

Vérifie la progression de la génération d'embeddings.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/embed-batch-status

Vérification

\n

Les mémoires ont un indicateur verified. Les mémoires stockées par l'agent sont non\nvérifiées par défaut (source=agent) ; les mémoires stockées par l'humain sont\nvérifiées (source=user).

\n

POST /memory/verify

\n

Marque une mémoire comme vérifiée (nécessite un JWT, pas une Mind Key).

\n
curl -X POST https://synapse.schaefer.zone/memory/mem_001/verify \\\n  -H "Authorization: Bearer YOUR_JWT"

POST /memory/unverify

\n

Marque une mémoire comme non vérifiée (nécessite un JWT).

\n
curl -X POST https://synapse.schaefer.zone/memory/mem_001/unverify \\\n  -H "Authorization: Bearer YOUR_JWT"

GET /memory/unverified

\n

Liste les mémoires en attente de vérification humaine.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/unverified?limit=100"

Statistiques & Audit

\n

GET /memory/stats

\n

Statistiques agrégées pour le mind courant.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/stats

Renvoie : { "total": 12, "verified": 10, "unverified": 2, "by_category": {...}, "by_priority": {...} }

\n

GET /memory/audit

\n

Journal d'audit de toutes les opérations modifiant l'état.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/audit?limit=100&action=store"

GET /memory/contradictions

\n

Détecte les contradictions potentielles dans les mémoires stockées.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/contradictions

GET /memory/expiring

\n

Liste les mémoires dont la date d'expiration approche.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/expiring?within=7d"

Santé & Export

\n

GET /memory/health

\n

Vérification rapide de la santé du système de mémoire.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/health

GET /memory/mind-export

\n

Export JSON complet de toutes les mémoires (pour sauvegarde).

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

POST /memory/compact

\n

Compacte les mémoires similaires (résumé automatique).

\n
curl -X POST https://synapse.schaefer.zone/memory/compact \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{"dry_run": true}'

Prochaines étapes

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