# Memory API
SUMMARY: Volledige referentie voor de 22 memory-eindpunten: opslaan, ophalen, zoeken, semantisch zoeken, synchroniseren, audit en meer.

KEY CONTEXT:
Auth: Mind Key (Authorization: Bearer mk_xxx OR ?key=mk_xxx)
ALWAYS call GET /memory/recall at session start.
POST /memory with same category+key updates the existing memory.
Categories: identity, preference, fact, project, skill, mistake, context, note, credentials
Priorities: low, normal, high, critical
Search: GET /memory/search?q=... (FTS5 syntax: AND, OR, "phrases", prefix*)
Semantic: GET /memory/semantic-search?q=... (slower, conceptual)
Sync: GET /memory/diff?since=TIMESTAMP (incremental sync)
Export: GET /memory/mind-export (full JSON dump)

Memory API
De Memory API is het hart van Synapse. Het biedt 22 eindpunten voor het opslaan,
ophalen, zoeken en beheren van gestructureerde herinneringen. Alle eindpunten vereisen
een Mind Key voor authenticatie.
> [!CRITICAL]
> Roep altijd  aan aan het begin van elke sessie. Dit is
> de enige manier om context van eerdere sessies te herstellen.
Categorieën
Herinneringen zijn ingedeeld in 8 categorieën:
| Categorie | Gebruik |
|-----------|---------|
|  | Naam, rol, contactgegevens, voorkeuren over zichzelf |
|  | Voorkeuren, afkeuren, werkstijl, communicatievoorkeuren |
|  | Verifieerbare feiten (projectdetails, data, URL's) |
|  | Projectstatus, mijlpalen, architectuur |
|  | Dingen waar de gebruiker goed in is |
|  | Eerdere fouten — herhaal ze niet |
|  | Sessie-relevante context |
|  | Diverse notities |
Prioriteiten
-  — leuk om te weten
-  — standaard
-  — belangrijk
-  — mag nooit vergeten worden (gebruikersidentiteit, juridische info)
Kern-eindpunten
GET /memory/recall
Retourneert ALLE herinneringen als op LLM geoptimaliseerde platte tekst. Roep dit aan bij elke sessiestart.
[CODE BLOCK]
Respons (text/plain):
[CODE BLOCK]
POST /memory
Sla een nieuwe herinnering op of werk een bestaande bij (zelfde categorie + key = update).
[CODE BLOCK]
Respons: 
GET /memory
Toon herinneringen met optionele filters.
[CODE BLOCK]
PUT /memory/:id
Werk een specifieke herinnering bij op ID.
[CODE BLOCK]
DELETE /memory/:id
Verwijder één herinnering.
[CODE BLOCK]
Zoek-eindpunten
GET /memory/search
Volledige-tekst zoeken met FTS5.
[CODE BLOCK]
FTS5-syntaxis:
- Meerdere woorden = AND: 
- Zin: 
- Prefix: 
- Booleaans: 
- Uitsluiten: 
GET /memory/semantic-search
Conceptueel zoeken met embeddings (langzamer dan FTS5 maar begrijpt betekenis).
[CODE BLOCK]
Retourneert herinneringen die semantisch overeenkomen met de query, zelfs als er geen
trefwoorden overeenkomen. Handig voor "vind herinneringen over X" waarbij X anders
wordt omschreven.
GET /memory/by-tag
Toon herinneringen per tag.
[CODE BLOCK]
GET /memory/related/:id
Vind herinneringen gerelateerd aan een specifieke herinnering (via gedeelde tags).
[CODE BLOCK]
Synchronisatie & Diff
GET /memory/diff
Incrementele synchronisatie — retourneert herinneringen die sinds een tijdstempel gewijzigd zijn.
[CODE BLOCK]
Respons: 
POST /memory/sync
Pas een diff toe vanuit een andere instantie (voor self-hosted synchronisatie).
[CODE BLOCK]
Bulkbewerkingen
POST /memory/bulk-delete
Verwijder meerdere herinneringen op ID.
[CODE BLOCK]
POST /memory/embed-batch
Genereer embeddings voor herinneringen die deze nog niet hebben (voor semantisch zoeken).
[CODE BLOCK]
GET /memory/embed-batch-status
Controleer de voortgang van embedding-generatie.
[CODE BLOCK]
Verificatie
Herinneringen hebben een -vlag. Door agents opgeslagen herinneringen zijn
standaard niet geverifieerd (); door mensen opgeslagen herinneringen
zijn geverifieerd ().
POST /memory/verify
Markeer een herinnering als geverifieerd (vereist JWT, niet Mind Key).
[CODE BLOCK]
POST /memory/unverify
Markeer een herinnering als niet-geverifieerd (vereist JWT).
[CODE BLOCK]
GET /memory/unverified
Toon herinneringen die wachten op menselijke verificatie.
[CODE BLOCK]
Statistieken & Audit
GET /memory/stats
Geaggregeerde statistieken voor de huidige mind.
[CODE BLOCK]
Retourneert: 
GET /memory/audit
Auditlog van alle toestandswijzigende bewerkingen.
[CODE BLOCK]
GET /memory/contradictions
Detecteer mogelijke tegenstrijdigheden in opgeslagen herinneringen.
[CODE BLOCK]
GET /memory/expiring
Toon herinneringen met naderende vervaldatums.
[CODE BLOCK]
Health & Export
GET /memory/health
Snelle health check voor het memory-systeem.
[CODE BLOCK]
GET /memory/mind-export
Volledige JSON-export van alle herinneringen (voor back-up).
[CODE BLOCK]
POST /memory/compact
Compacteer vergelijkbare herinneringen (automatische samenvatting).
[CODE BLOCK]
Volgende stappen
- Quick Start voor LLM's
- Memory-best-practices
- FTS5-zoekopdracht
- Semantisch zoeken