# Memory-API
SUMMARY: Vollständige Referenz der 22 Memory-Endpunkte: speichern, abrufen, suchen, semantische Suche, Sync, Audit und mehr.

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
Die Memory-API ist das Herz von Synapse. Sie bietet 22 Endpunkte zum Speichern,
Abrufen, Suchen und Verwalten strukturierter Erinnerungen. Alle Endpunkte
erfordern einen Mind Key zur Authentifizierung.
> [!CRITICAL]
> Rufe immer  zu Beginn jeder Session auf. Das ist der
> einzige Weg, den Kontext aus früheren Sessions wiederherzustellen.
Kategorien
Memories sind in 8 Kategorien gegliedert:
| Kategorie | Anwendungsfall |
|-----------|----------------|
|  | Nutzername, Rolle, Kontaktinfo, Selbstaussagen |
|  | Vorlieben, Abneigungen, Arbeitsstil, Kommunikationspräferenzen |
|  | Überprüfbare Fakten (Projekt-Details, Daten, URLs) |
|  | Projektstatus, Meilensteine, Architektur |
|  | Dinge, die der Nutzer gut kann |
|  | Frühere Fehler — nicht wiederholen |
|  | Session-relevanter Kontext |
|  | Sonstige Notizen |
Prioritäten
-  — nett zu wissen
-  — Standard
-  — wichtig
-  — darf nie vergessen werden (Nutzeridentität, rechtliche Infos)
Kern-Endpunkte
GET /memory/recall
Liefert ALLE Memories als LLM-optimierten Klartext. Rufe dies zu Beginn jeder
Session auf.
[CODE BLOCK]
Antwort (text/plain):
[CODE BLOCK]
POST /memory
Einen neuen Memory speichern oder einen bestehenden aktualisieren (gleiche
Kategorie + Key = Update).
[CODE BLOCK]
Antwort: 
GET /memory
Memories mit optionalen Filtern auflisten.
[CODE BLOCK]
PUT /memory/:id
Einen bestimmten Memory per ID aktualisieren.
[CODE BLOCK]
DELETE /memory/:id
Einen einzelnen Memory löschen.
[CODE BLOCK]
Such-Endpunkte
GET /memory/search
Volltextsuche via FTS5.
[CODE BLOCK]
FTS5-Syntax:
- Mehrere Wörter = AND: 
- Phrase: 
- Präfix: 
- Boolesch: 
- Ausschließen: 
GET /memory/semantic-search
Konzeptionelle Suche via Embeddings (langsamer als FTS5, versteht aber Bedeutung).
[CODE BLOCK]
Liefert Memories, die semantisch zur Anfrage passen, selbst wenn keine Keywords
übereinstimmen. Nützlich für „finde Memories über X", wenn X anders beschrieben
wird.
GET /memory/by-tag
Memories nach Tag auflisten.
[CODE BLOCK]
GET /memory/related/:id
Memories finden, die mit einem bestimmten Memory verwandt sind (über gemeinsame
Tags).
[CODE BLOCK]
Sync & Diff
GET /memory/diff
Inkrementeller Sync — liefert Memories, die seit einem Zeitstempel geändert
wurden.
[CODE BLOCK]
Antwort: 
POST /memory/sync
Einen Diff aus einer anderen Instanz anwenden (für selbstgehosteten Sync).
[CODE BLOCK]
Bulk-Operationen
POST /memory/bulk-delete
Mehrere Memories per ID löschen.
[CODE BLOCK]
POST /memory/embed-batch
Embeddings für Memories generieren, die noch keine haben (für semantische
Suche).
[CODE BLOCK]
GET /memory/embed-batch-status
Fortschritt der Embedding-Generierung prüfen.
[CODE BLOCK]
Verifikation
Memories haben ein -Flag. Vom Agent gespeicherte Memories sind
standardmäßig unbestätigt (); von Menschen gespeicherte Memories
sind verifiziert ().
POST /memory/verify
Einen Memory als verifiziert markieren (erfordert JWT, nicht Mind Key).
[CODE BLOCK]
POST /memory/unverify
Einen Memory als unverifiziert markieren (erfordert JWT).
[CODE BLOCK]
GET /memory/unverified
Memories auflisten, die auf menschliche Verifikation warten.
[CODE BLOCK]
Statistik & Audit
GET /memory/stats
Aggregierte Statistiken für den aktuellen Mind.
[CODE BLOCK]
Liefert: 
GET /memory/audit
Audit-Log aller zustandsverändernden Operationen.
[CODE BLOCK]
GET /memory/contradictions
Potenzielle Widersprüche in gespeicherten Memories erkennen.
[CODE BLOCK]
GET /memory/expiring
Memories auflisten, deren Ablaufdatum näher rückt.
[CODE BLOCK]
Health & Export
GET /memory/health
Schneller Health-Check für das Memory-System.
[CODE BLOCK]
GET /memory/mind-export
Vollständiger JSON-Export aller Memories (für Backups).
[CODE BLOCK]
POST /memory/compact
Ähnliche Memories komprimieren (Auto-Summary).
[CODE BLOCK]
Nächste Schritte
- Quick Start für LLMs
- Memory-Best-Practices
- FTS5-Suche
- Semantische Suche