{"title":"Memory-API","slug":"memory","category":"api","summary":"Vollständige Referenz der 22 Memory-Endpunkte: speichern, abrufen, suchen, semantische Suche, Sync, Audit und mehr.","audience":["human","llm"],"tags":["api","memory","crud","search","fts5","semantic"],"difficulty":"intermediate","updated":"2026-06-27","word_count":498,"read_minutes":2,"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":"de","translated":true,"requested_lang":"de","content_markdown":"\n# Memory-API\n\nDie Memory-API ist das Herz von Synapse. Sie bietet 22 Endpunkte zum Speichern,\nAbrufen, Suchen und Verwalten strukturierter Erinnerungen. Alle Endpunkte\nerfordern einen Mind Key zur Authentifizierung.\n\n> [!CRITICAL]\n> **Rufe immer `GET /memory/recall` zu Beginn jeder Session auf.** Das ist der\n> einzige Weg, den Kontext aus früheren Sessions wiederherzustellen.\n\n## Kategorien\n\nMemories sind in 8 Kategorien gegliedert:\n\n| Kategorie | Anwendungsfall |\n|-----------|----------------|\n| `identity` | Nutzername, Rolle, Kontaktinfo, Selbstaussagen |\n| `preference` | Vorlieben, Abneigungen, Arbeitsstil, Kommunikationspräferenzen |\n| `fact` | Überprüfbare Fakten (Projekt-Details, Daten, URLs) |\n| `project` | Projektstatus, Meilensteine, Architektur |\n| `skill` | Dinge, die der Nutzer gut kann |\n| `mistake` | Frühere Fehler — nicht wiederholen |\n| `context` | Session-relevanter Kontext |\n| `note` | Sonstige Notizen |\n\n## Prioritäten\n\n- `low` — nett zu wissen\n- `normal` — Standard\n- `high` — wichtig\n- `critical` — darf nie vergessen werden (Nutzeridentität, rechtliche Infos)\n\n## Kern-Endpunkte\n\n### GET /memory/recall\n\nLiefert ALLE Memories als LLM-optimierten Klartext. Rufe dies zu Beginn jeder\nSession auf.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\nAntwort (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\nEinen neuen Memory speichern oder einen bestehenden aktualisieren (gleiche\nKategorie + 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\nAntwort: `{ \"id\": \"mem_001\", \"status\": \"stored\" }`\n\n### GET /memory\n\nMemories mit optionalen Filtern auflisten.\n\n```bash\n# Alle Memories (JSON)\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory?limit=50&offset=0\"\n\n# Nach Kategorie filtern\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory?category=project\"\n\n# Nach Tag filtern\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory?tag=docker\"\n```\n\n### PUT /memory/:id\n\nEinen bestimmten Memory per ID aktualisieren.\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\nEinen einzelnen Memory löschen.\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/mem_001\n```\n\n## Such-Endpunkte\n\n### GET /memory/search\n\nVolltextsuche via FTS5.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=docker+swarm\"\n```\n\nFTS5-Syntax:\n\n- Mehrere Wörter = AND: `docker swarm`\n- Phrase: `\"docker swarm\"`\n- Präfix: `docker*`\n- Boolesch: `docker OR kubernetes`\n- Ausschließen: `docker -swarm`\n\n### GET /memory/semantic-search\n\nKonzeptionelle Suche via Embeddings (langsamer als FTS5, versteht aber Bedeutung).\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/semantic-search?q=container+orchestration\"\n```\n\nLiefert Memories, die semantisch zur Anfrage passen, selbst wenn keine Keywords\nübereinstimmen. Nützlich für „finde Memories über X\", wenn X anders beschrieben\nwird.\n\n### GET /memory/by-tag\n\nMemories nach Tag auflisten.\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\nMemories finden, die mit einem bestimmten Memory verwandt sind (über gemeinsame\nTags).\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\nInkrementeller Sync — liefert Memories, die seit einem Zeitstempel geändert\nwurden.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/diff?since=1700000000\"\n```\n\nAntwort: `{ \"added\": [...], \"updated\": [...], \"deleted\": [...] }`\n\n### POST /memory/sync\n\nEinen Diff aus einer anderen Instanz anwenden (für selbstgehosteten Sync).\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## Bulk-Operationen\n\n### POST /memory/bulk-delete\n\nMehrere Memories per ID löschen.\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\nEmbeddings für Memories generieren, die noch keine haben (für semantische\nSuche).\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\nFortschritt der Embedding-Generierung prüfen.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/embed-batch-status\n```\n\n## Verifikation\n\nMemories haben ein `verified`-Flag. Vom Agent gespeicherte Memories sind\nstandardmäßig unbestätigt (`source=agent`); von Menschen gespeicherte Memories\nsind verifiziert (`source=user`).\n\n### POST /memory/verify\n\nEinen Memory als verifiziert markieren (erfordert JWT, nicht 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\nEinen Memory als unverifiziert markieren (erfordert 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\nMemories auflisten, die auf menschliche Verifikation warten.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/unverified?limit=100\"\n```\n\n## Statistik & Audit\n\n### GET /memory/stats\n\nAggregierte Statistiken für den aktuellen Mind.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/stats\n```\n\nLiefert: `{ \"total\": 12, \"verified\": 10, \"unverified\": 2, \"by_category\": {...}, \"by_priority\": {...} }`\n\n### GET /memory/audit\n\nAudit-Log aller zustandsverändernden Operationen.\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\nPotenzielle Widersprüche in gespeicherten Memories erkennen.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/contradictions\n```\n\n### GET /memory/expiring\n\nMemories auflisten, deren Ablaufdatum näher rückt.\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\nSchneller Health-Check für das Memory-System.\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\nVollständiger JSON-Export aller Memories (für Backups).\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\nÄhnliche Memories komprimieren (Auto-Summary).\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## Nächste Schritte\n\n- [Quick Start für LLMs](/docs/getting-started/quick-start-llm)\n- [Memory-Best-Practices](/docs/guides/memory-best-practices)\n- [FTS5-Suche](/docs/concepts/fts5-search)\n- [Semantische Suche](/docs/concepts/semantic-search)\n","content_html":"

Memory-API

\n

Die Memory-API ist das Herz von Synapse. Sie bietet 22 Endpunkte zum Speichern,\nAbrufen, Suchen und Verwalten strukturierter Erinnerungen. Alle Endpunkte\nerfordern einen Mind Key zur Authentifizierung.

\n
**Rufe immer `GET /memory/recall` zu Beginn jeder Session auf.** Das ist der\neinzige Weg, den Kontext aus früheren Sessions wiederherzustellen.

Kategorien

\n

Memories sind in 8 Kategorien gegliedert:

\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
KategorieAnwendungsfall
identityNutzername, Rolle, Kontaktinfo, Selbstaussagen
preferenceVorlieben, Abneigungen, Arbeitsstil, Kommunikationspräferenzen
factÜberprüfbare Fakten (Projekt-Details, Daten, URLs)
projectProjektstatus, Meilensteine, Architektur
skillDinge, die der Nutzer gut kann
mistakeFrühere Fehler — nicht wiederholen
contextSession-relevanter Kontext
noteSonstige Notizen
\n

Prioritäten

\n\n

Kern-Endpunkte

\n

GET /memory/recall

\n

Liefert ALLE Memories als LLM-optimierten Klartext. Rufe dies zu Beginn jeder\nSession auf.

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

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

Einen neuen Memory speichern oder einen bestehenden aktualisieren (gleiche\nKategorie + 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  }'

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

\n

GET /memory

\n

Memories mit optionalen Filtern auflisten.

\n
# Alle Memories (JSON)\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory?limit=50&offset=0"\n\n# Nach Kategorie filtern\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory?category=project"\n\n# Nach Tag filtern\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory?tag=docker"

PUT /memory/:id

\n

Einen bestimmten Memory per ID aktualisieren.

\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

Einen einzelnen Memory löschen.

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

Such-Endpunkte

\n

GET /memory/search

\n

Volltextsuche via FTS5.

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

FTS5-Syntax:

\n\n

GET /memory/semantic-search

\n

Konzeptionelle Suche via Embeddings (langsamer als FTS5, versteht aber Bedeutung).

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

Liefert Memories, die semantisch zur Anfrage passen, selbst wenn keine Keywords\nübereinstimmen. Nützlich für „finde Memories über X", wenn X anders beschrieben\nwird.

\n

GET /memory/by-tag

\n

Memories nach Tag auflisten.

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

GET /memory/related/:id

\n

Memories finden, die mit einem bestimmten Memory verwandt sind (über gemeinsame\nTags).

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

Sync & Diff

\n

GET /memory/diff

\n

Inkrementeller Sync — liefert Memories, die seit einem Zeitstempel geändert\nwurden.

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

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

\n

POST /memory/sync

\n

Einen Diff aus einer anderen Instanz anwenden (für selbstgehosteten Sync).

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

Bulk-Operationen

\n

POST /memory/bulk-delete

\n

Mehrere Memories per ID löschen.

\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

Embeddings für Memories generieren, die noch keine haben (für semantische\nSuche).

\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

Fortschritt der Embedding-Generierung prüfen.

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

Verifikation

\n

Memories haben ein verified-Flag. Vom Agent gespeicherte Memories sind\nstandardmäßig unbestätigt (source=agent); von Menschen gespeicherte Memories\nsind verifiziert (source=user).

\n

POST /memory/verify

\n

Einen Memory als verifiziert markieren (erfordert JWT, nicht Mind Key).

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

POST /memory/unverify

\n

Einen Memory als unverifiziert markieren (erfordert JWT).

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

GET /memory/unverified

\n

Memories auflisten, die auf menschliche Verifikation warten.

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

Statistik & Audit

\n

GET /memory/stats

\n

Aggregierte Statistiken für den aktuellen Mind.

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

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

\n

GET /memory/audit

\n

Audit-Log aller zustandsverändernden Operationen.

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

GET /memory/contradictions

\n

Potenzielle Widersprüche in gespeicherten Memories erkennen.

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

GET /memory/expiring

\n

Memories auflisten, deren Ablaufdatum näher rückt.

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

Health & Export

\n

GET /memory/health

\n

Schneller Health-Check für das Memory-System.

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

GET /memory/mind-export

\n

Vollständiger JSON-Export aller Memories (für Backups).

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

POST /memory/compact

\n

Ähnliche Memories komprimieren (Auto-Summary).

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

Nächste Schritte

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