# Memory API
SUMMARY: Komplett referens för de 22 minnes-endpoints: lagra, återkalla, söka, semantisk sökning, synkronisering, granskning och mer.

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
Memory API är hjärtat i Synapse. Det tillhandahåller 22 endpoints för lagring,
hämtning, sökning och hantering av strukturerade minnen. Alla endpoints kräver
en Mind Key för autentisering.
> [!CRITICAL]
> Anropa alltid  i början av varje session. Detta är
> det enda sättet att återuppbygga kontext från tidigare sessioner.
Kategorier
Minnen är organiserade i 8 kategorier:
| Kategori | Användningsområde |
|----------|----------|
|  | Användarnamn, roll, kontaktinfo, inställningar om sig själv |
|  | Tycker om, ogillar, arbetsstil, kommunikationsinställningar |
|  | Verifierbara fakta (projektdetaljer, datum, URL:er) |
|  | Projektstatus, milstolpar, arkitektur |
|  | Saker användaren är bra på |
|  | Tidigare fel — undvik att upprepa |
|  | Sessionsrelevant kontext |
|  | Diverse anteckningar |
Prioriteringar
-  — bra att veta
-  — standard
-  — viktig
-  — får aldrig glömmas (användaridentitet, juridisk info)
Centrala endpoints
GET /memory/recall
Returnerar ALLA minnen som LLM-optimerad oformaterad text. Anropa detta vid
varje sessionsstart.
[CODE BLOCK]
Svar (text/plain):
[CODE BLOCK]
POST /memory
Lagra ett nytt minne eller uppdatera ett befintligt (samma kategori + nyckel = uppdatering).
[CODE BLOCK]
Svar: 
GET /memory
Lista minnen med valfria filter.
[CODE BLOCK]
PUT /memory/:id
Uppdatera ett specifikt minne via ID.
[CODE BLOCK]
DELETE /memory/:id
Ta bort ett enskilt minne.
[CODE BLOCK]
Sök-endpoints
GET /memory/search
Fulltextssökning med FTS5.
[CODE BLOCK]
FTS5-syntax:
- Flera ord = AND: 
- Fras: 
- Prefix: 
- Boolesk: 
- Uteslut: 
GET /memory/semantic-search
Begreppsbaserad sökning med inbäddningar (langsammare än FTS5 men förstår betydelse).
[CODE BLOCK]
Returnerar minnen som är semantiskt lika frågan, även om inga nyckelord
matchar. Användbart för "hitta minnen om X" där X beskrivs på annat sätt.
GET /memory/by-tag
Lista minnen efter tagg.
[CODE BLOCK]
GET /memory/related/:id
Hitta minnen relaterade till ett specifikt minne (via gemensamma taggar).
[CODE BLOCK]
Synkronisering & Diff
GET /memory/diff
Inkrementell synk — returnerar minnen som ändrats sedan en tidsstämpel.
[CODE BLOCK]
Svar: 
POST /memory/sync
Tillämpa en diff från en annan instans (för självvärd synk).
[CODE BLOCK]
Massåtgärder
POST /memory/bulk-delete
Ta bort flera minnen via ID.
[CODE BLOCK]
POST /memory/embed-batch
Generera inbäddningar för minnen som saknar dem (för semantisk sökning).
[CODE BLOCK]
GET /memory/embed-batch-status
Kontrollera förloppet för inbäddningsgenerering.
[CODE BLOCK]
Verifiering
Minnen har en -flagga. Agentlagrade minnen är som standard overifierade
(); människolagrade minnen är verifierade ().
POST /memory/verify
Markera ett minne som verifierat (kräver JWT, inte Mind Key).
[CODE BLOCK]
POST /memory/unverify
Markera ett minne som overifierat (kräver JWT).
[CODE BLOCK]
GET /memory/unverified
Lista minnen som väntar på mänsklig verifiering.
[CODE BLOCK]
Statistik & granskning
GET /memory/stats
Aggregerad statistik för den aktuella minden.
[CODE BLOCK]
Returnerar: 
GET /memory/audit
Granskningslogg över alla tillståndsändrande åtgärder.
[CODE BLOCK]
GET /memory/contradictions
Upptäck potentiella motsägelser i lagrade minnen.
[CODE BLOCK]
GET /memory/expiring
Lista minnen med utgångsdatum som närmar sig.
[CODE BLOCK]
Hälsa & export
GET /memory/health
Snabb hälsokontroll för minnessystemet.
[CODE BLOCK]
GET /memory/mind-export
Full JSON-export av alla minnen (för säkerhetskopiering).
[CODE BLOCK]
POST /memory/compact
Komprimera liknande minnen (auto-sammanfattning).
[CODE BLOCK]
Nästa steg
- Snabbstart för LLM:er
- Minnesbästa praxis
- FTS5-sökning
- Semantisk sökning