{"title":"Memory API","slug":"memory","category":"api","summary":"Volledige referentie voor de 22 memory-eindpunten: opslaan, ophalen, zoeken, semantisch zoeken, synchroniseren, audit en meer.","audience":["human","llm"],"tags":["api","memory","crud","search","fts5","semantic"],"difficulty":"intermediate","updated":"2026-06-27","word_count":522,"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":"nl","translated":true,"requested_lang":"nl","content_markdown":"\n# Memory API\n\nDe Memory API is het hart van Synapse. Het biedt 22 eindpunten voor het opslaan,\nophalen, zoeken en beheren van gestructureerde herinneringen. Alle eindpunten vereisen\neen Mind Key voor authenticatie.\n\n> [!CRITICAL]\n> **Roep altijd `GET /memory/recall` aan aan het begin van elke sessie.** Dit is\n> de enige manier om context van eerdere sessies te herstellen.\n\n## Categorieën\n\nHerinneringen zijn ingedeeld in 8 categorieën:\n\n| Categorie | Gebruik |\n|-----------|---------|\n| `identity` | Naam, rol, contactgegevens, voorkeuren over zichzelf |\n| `preference` | Voorkeuren, afkeuren, werkstijl, communicatievoorkeuren |\n| `fact` | Verifieerbare feiten (projectdetails, data, URL's) |\n| `project` | Projectstatus, mijlpalen, architectuur |\n| `skill` | Dingen waar de gebruiker goed in is |\n| `mistake` | Eerdere fouten — herhaal ze niet |\n| `context` | Sessie-relevante context |\n| `note` | Diverse notities |\n\n## Prioriteiten\n\n- `low` — leuk om te weten\n- `normal` — standaard\n- `high` — belangrijk\n- `critical` — mag nooit vergeten worden (gebruikersidentiteit, juridische info)\n\n## Kern-eindpunten\n\n### GET /memory/recall\n\nRetourneert ALLE herinneringen als op LLM geoptimaliseerde platte tekst. Roep dit aan bij elke sessiestart.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\nRespons (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\nSla een nieuwe herinnering op of werk een bestaande bij (zelfde categorie + key = update).\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\nRespons: `{ \"id\": \"mem_001\", \"status\": \"stored\" }`\n\n### GET /memory\n\nToon herinneringen met optionele filters.\n\n```bash\n# Alle herinneringen (JSON)\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory?limit=50&offset=0\"\n\n# Filter op categorie\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory?category=project\"\n\n# Filter op tag\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory?tag=docker\"\n```\n\n### PUT /memory/:id\n\nWerk een specifieke herinnering bij op 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\nVerwijder één herinnering.\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/mem_001\n```\n\n## Zoek-eindpunten\n\n### GET /memory/search\n\nVolledige-tekst zoeken met FTS5.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=docker+swarm\"\n```\n\nFTS5-syntaxis:\n\n- Meerdere woorden = AND: `docker swarm`\n- Zin: `\"docker swarm\"`\n- Prefix: `docker*`\n- Booleaans: `docker OR kubernetes`\n- Uitsluiten: `docker -swarm`\n\n### GET /memory/semantic-search\n\nConceptueel zoeken met embeddings (langzamer dan FTS5 maar begrijpt betekenis).\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/semantic-search?q=container+orchestration\"\n```\n\nRetourneert herinneringen die semantisch overeenkomen met de query, zelfs als er geen\ntrefwoorden overeenkomen. Handig voor \"vind herinneringen over X\" waarbij X anders\nwordt omschreven.\n\n### GET /memory/by-tag\n\nToon herinneringen per 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\nVind herinneringen gerelateerd aan een specifieke herinnering (via gedeelde tags).\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/related/mem_001\n```\n\n## Synchronisatie & Diff\n\n### GET /memory/diff\n\nIncrementele synchronisatie — retourneert herinneringen die sinds een tijdstempel gewijzigd zijn.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/diff?since=1700000000\"\n```\n\nRespons: `{ \"added\": [...], \"updated\": [...], \"deleted\": [...] }`\n\n### POST /memory/sync\n\nPas een diff toe vanuit een andere instantie (voor self-hosted synchronisatie).\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## Bulkbewerkingen\n\n### POST /memory/bulk-delete\n\nVerwijder meerdere herinneringen op 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\nGenereer embeddings voor herinneringen die deze nog niet hebben (voor semantisch zoeken).\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\nControleer de voortgang van embedding-generatie.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/embed-batch-status\n```\n\n## Verificatie\n\nHerinneringen hebben een `verified`-vlag. Door agents opgeslagen herinneringen zijn\nstandaard niet geverifieerd (`source=agent`); door mensen opgeslagen herinneringen\nzijn geverifieerd (`source=user`).\n\n### POST /memory/verify\n\nMarkeer een herinnering als geverifieerd (vereist JWT, niet 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\nMarkeer een herinnering als niet-geverifieerd (vereist 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\nToon herinneringen die wachten op menselijke verificatie.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/unverified?limit=100\"\n```\n\n## Statistieken & Audit\n\n### GET /memory/stats\n\nGeaggregeerde statistieken voor de huidige mind.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/stats\n```\n\nRetourneert: `{ \"total\": 12, \"verified\": 10, \"unverified\": 2, \"by_category\": {...}, \"by_priority\": {...} }`\n\n### GET /memory/audit\n\nAuditlog van alle toestandswijzigende bewerkingen.\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\nDetecteer mogelijke tegenstrijdigheden in opgeslagen herinneringen.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/contradictions\n```\n\n### GET /memory/expiring\n\nToon herinneringen met naderende vervaldatums.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/expiring?within=7d\"\n```\n\n## Health & Export\n\n### GET /memory/health\n\nSnelle health check voor het memory-systeem.\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\nVolledige JSON-export van alle herinneringen (voor back-up).\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\nCompacteer vergelijkbare herinneringen (automatische samenvatting).\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## Volgende stappen\n\n- [Quick Start voor LLM's](/docs/getting-started/quick-start-llm)\n- [Memory-best-practices](/docs/guides/memory-best-practices)\n- [FTS5-zoekopdracht](/docs/concepts/fts5-search)\n- [Semantisch zoeken](/docs/concepts/semantic-search)\n","content_html":"

Memory API

\n

De Memory API is het hart van Synapse. Het biedt 22 eindpunten voor het opslaan,\nophalen, zoeken en beheren van gestructureerde herinneringen. Alle eindpunten vereisen\neen Mind Key voor authenticatie.

\n
**Roep altijd `GET /memory/recall` aan aan het begin van elke sessie.** Dit is\nde enige manier om context van eerdere sessies te herstellen.

Categorieën

\n

Herinneringen zijn ingedeeld in 8 categorieë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\n
CategorieGebruik
identityNaam, rol, contactgegevens, voorkeuren over zichzelf
preferenceVoorkeuren, afkeuren, werkstijl, communicatievoorkeuren
factVerifieerbare feiten (projectdetails, data, URL's)
projectProjectstatus, mijlpalen, architectuur
skillDingen waar de gebruiker goed in is
mistakeEerdere fouten — herhaal ze niet
contextSessie-relevante context
noteDiverse notities
\n

Prioriteiten

\n\n

Kern-eindpunten

\n

GET /memory/recall

\n

Retourneert ALLE herinneringen als op LLM geoptimaliseerde platte tekst. Roep dit aan bij elke sessiestart.

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

Respons (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

Sla een nieuwe herinnering op of werk een bestaande bij (zelfde categorie + key = update).

\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  }'

Respons: { "id": "mem_001", "status": "stored" }

\n

GET /memory

\n

Toon herinneringen met optionele filters.

\n
# Alle herinneringen (JSON)\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory?limit=50&offset=0"\n\n# Filter op categorie\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory?category=project"\n\n# Filter op tag\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory?tag=docker"

PUT /memory/:id

\n

Werk een specifieke herinnering bij op 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

Verwijder één herinnering.

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

Zoek-eindpunten

\n

GET /memory/search

\n

Volledige-tekst zoeken met FTS5.

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

FTS5-syntaxis:

\n\n

GET /memory/semantic-search

\n

Conceptueel zoeken met embeddings (langzamer dan FTS5 maar begrijpt betekenis).

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

Retourneert herinneringen die semantisch overeenkomen met de query, zelfs als er geen\ntrefwoorden overeenkomen. Handig voor "vind herinneringen over X" waarbij X anders\nwordt omschreven.

\n

GET /memory/by-tag

\n

Toon herinneringen per tag.

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

GET /memory/related/:id

\n

Vind herinneringen gerelateerd aan een specifieke herinnering (via gedeelde tags).

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

Synchronisatie & Diff

\n

GET /memory/diff

\n

Incrementele synchronisatie — retourneert herinneringen die sinds een tijdstempel gewijzigd zijn.

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

Respons: { "added": [...], "updated": [...], "deleted": [...] }

\n

POST /memory/sync

\n

Pas een diff toe vanuit een andere instantie (voor self-hosted synchronisatie).

\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": [...]}'

Bulkbewerkingen

\n

POST /memory/bulk-delete

\n

Verwijder meerdere herinneringen op 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

Genereer embeddings voor herinneringen die deze nog niet hebben (voor semantisch zoeken).

\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

Controleer de voortgang van embedding-generatie.

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

Verificatie

\n

Herinneringen hebben een verified-vlag. Door agents opgeslagen herinneringen zijn\nstandaard niet geverifieerd (source=agent); door mensen opgeslagen herinneringen\nzijn geverifieerd (source=user).

\n

POST /memory/verify

\n

Markeer een herinnering als geverifieerd (vereist JWT, niet Mind Key).

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

POST /memory/unverify

\n

Markeer een herinnering als niet-geverifieerd (vereist JWT).

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

GET /memory/unverified

\n

Toon herinneringen die wachten op menselijke verificatie.

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

Statistieken & Audit

\n

GET /memory/stats

\n

Geaggregeerde statistieken voor de huidige mind.

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

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

\n

GET /memory/audit

\n

Auditlog van alle toestandswijzigende bewerkingen.

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

GET /memory/contradictions

\n

Detecteer mogelijke tegenstrijdigheden in opgeslagen herinneringen.

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

GET /memory/expiring

\n

Toon herinneringen met naderende vervaldatums.

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

Health & Export

\n

GET /memory/health

\n

Snelle health check voor het memory-systeem.

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

GET /memory/mind-export

\n

Volledige JSON-export van alle herinneringen (voor back-up).

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

POST /memory/compact

\n

Compacteer vergelijkbare herinneringen (automatische samenvatting).

\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}'

Volgende stappen

\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"]}