{"title":"Memory API","slug":"memory","category":"api","summary":"Komplett referens för de 22 minnes-endpoints: lagra, återkalla, söka, semantisk sökning, synkronisering, granskning och mer.","audience":["human","llm"],"tags":["api","memory","crud","search","fts5","semantic"],"difficulty":"intermediate","updated":"2026-06-27","word_count":500,"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":"sv","translated":true,"requested_lang":"sv","content_markdown":"\n# Memory API\n\nMemory API är hjärtat i Synapse. Det tillhandahåller 22 endpoints för lagring,\nhämtning, sökning och hantering av strukturerade minnen. Alla endpoints kräver\nen Mind Key för autentisering.\n\n> [!CRITICAL]\n> **Anropa alltid `GET /memory/recall` i början av varje session.** Detta är\n> det enda sättet att återuppbygga kontext från tidigare sessioner.\n\n## Kategorier\n\nMinnen är organiserade i 8 kategorier:\n\n| Kategori | Användningsområde |\n|----------|----------|\n| `identity` | Användarnamn, roll, kontaktinfo, inställningar om sig själv |\n| `preference` | Tycker om, ogillar, arbetsstil, kommunikationsinställningar |\n| `fact` | Verifierbara fakta (projektdetaljer, datum, URL:er) |\n| `project` | Projektstatus, milstolpar, arkitektur |\n| `skill` | Saker användaren är bra på |\n| `mistake` | Tidigare fel — undvik att upprepa |\n| `context` | Sessionsrelevant kontext |\n| `note` | Diverse anteckningar |\n\n## Prioriteringar\n\n- `low` — bra att veta\n- `normal` — standard\n- `high` — viktig\n- `critical` — får aldrig glömmas (användaridentitet, juridisk info)\n\n## Centrala endpoints\n\n### GET /memory/recall\n\nReturnerar ALLA minnen som LLM-optimerad oformaterad text. Anropa detta vid\nvarje sessionsstart.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\nSvar (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\nLagra ett nytt minne eller uppdatera ett befintligt (samma kategori + nyckel = uppdatering).\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\nSvar: `{ \"id\": \"mem_001\", \"status\": \"stored\" }`\n\n### GET /memory\n\nLista minnen med valfria filter.\n\n```bash\n# All memories (JSON)\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory?limit=50&offset=0\"\n\n# Filter by category\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory?category=project\"\n\n# Filter by tag\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory?tag=docker\"\n```\n\n### PUT /memory/:id\n\nUppdatera ett specifikt minne via 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\nTa bort ett enskilt minne.\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/mem_001\n```\n\n## Sök-endpoints\n\n### GET /memory/search\n\nFulltextssökning med 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- Flera ord = AND: `docker swarm`\n- Fras: `\"docker swarm\"`\n- Prefix: `docker*`\n- Boolesk: `docker OR kubernetes`\n- Uteslut: `docker -swarm`\n\n### GET /memory/semantic-search\n\nBegreppsbaserad sökning med inbäddningar (langsammare än FTS5 men förstår betydelse).\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/semantic-search?q=container+orchestration\"\n```\n\nReturnerar minnen som är semantiskt lika frågan, även om inga nyckelord\nmatchar. Användbart för \"hitta minnen om X\" där X beskrivs på annat sätt.\n\n### GET /memory/by-tag\n\nLista minnen efter tagg.\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\nHitta minnen relaterade till ett specifikt minne (via gemensamma taggar).\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/related/mem_001\n```\n\n## Synkronisering & Diff\n\n### GET /memory/diff\n\nInkrementell synk — returnerar minnen som ändrats sedan en tidsstämpel.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/diff?since=1700000000\"\n```\n\nSvar: `{ \"added\": [...], \"updated\": [...], \"deleted\": [...] }`\n\n### POST /memory/sync\n\nTillämpa en diff från en annan instans (för självvärd synk).\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## Massåtgärder\n\n### POST /memory/bulk-delete\n\nTa bort flera minnen via 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\nGenerera inbäddningar för minnen som saknar dem (för semantisk sökning).\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\nKontrollera förloppet för inbäddningsgenerering.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/embed-batch-status\n```\n\n## Verifiering\n\nMinnen har en `verified`-flagga. Agentlagrade minnen är som standard overifierade\n(`source=agent`); människolagrade minnen är verifierade (`source=user`).\n\n### POST /memory/verify\n\nMarkera ett minne som verifierat (kräver JWT, inte 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\nMarkera ett minne som overifierat (kräver 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\nLista minnen som väntar på mänsklig verifiering.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/unverified?limit=100\"\n```\n\n## Statistik & granskning\n\n### GET /memory/stats\n\nAggregerad statistik för den aktuella minden.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/stats\n```\n\nReturnerar: `{ \"total\": 12, \"verified\": 10, \"unverified\": 2, \"by_category\": {...}, \"by_priority\": {...} }`\n\n### GET /memory/audit\n\nGranskningslogg över alla tillståndsändrande åtgärder.\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\nUpptäck potentiella motsägelser i lagrade minnen.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/contradictions\n```\n\n### GET /memory/expiring\n\nLista minnen med utgångsdatum som närmar sig.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/expiring?within=7d\"\n```\n\n## Hälsa & export\n\n### GET /memory/health\n\nSnabb hälsokontroll för minnessystemet.\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\nFull JSON-export av alla minnen (för säkerhetskopiering).\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\nKomprimera liknande minnen (auto-sammanfattning).\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ästa steg\n\n- [Snabbstart för LLM:er](/docs/getting-started/quick-start-llm)\n- [Minnesbästa praxis](/docs/guides/memory-best-practices)\n- [FTS5-sökning](/docs/concepts/fts5-search)\n- [Semantisk sökning](/docs/concepts/semantic-search)\n","content_html":"

Memory API

\n

Memory API är hjärtat i Synapse. Det tillhandahåller 22 endpoints för lagring,\nhämtning, sökning och hantering av strukturerade minnen. Alla endpoints kräver\nen Mind Key för autentisering.

\n
**Anropa alltid `GET /memory/recall` i början av varje session.** Detta är\ndet enda sättet att återuppbygga kontext från tidigare sessioner.

Kategorier

\n

Minnen är organiserade i 8 kategorier:

\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
KategoriAnvändningsområde
identityAnvändarnamn, roll, kontaktinfo, inställningar om sig själv
preferenceTycker om, ogillar, arbetsstil, kommunikationsinställningar
factVerifierbara fakta (projektdetaljer, datum, URL:er)
projectProjektstatus, milstolpar, arkitektur
skillSaker användaren är bra på
mistakeTidigare fel — undvik att upprepa
contextSessionsrelevant kontext
noteDiverse anteckningar
\n

Prioriteringar

\n\n

Centrala endpoints

\n

GET /memory/recall

\n

Returnerar ALLA minnen som LLM-optimerad oformaterad text. Anropa detta vid\nvarje sessionsstart.

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

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

Lagra ett nytt minne eller uppdatera ett befintligt (samma kategori + nyckel = uppdatering).

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

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

\n

GET /memory

\n

Lista minnen med valfria filter.

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

PUT /memory/:id

\n

Uppdatera ett specifikt minne via 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

Ta bort ett enskilt minne.

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

Sök-endpoints

\n

GET /memory/search

\n

Fulltextssökning med 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

Begreppsbaserad sökning med inbäddningar (langsammare än FTS5 men förstår betydelse).

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

Returnerar minnen som är semantiskt lika frågan, även om inga nyckelord\nmatchar. Användbart för "hitta minnen om X" där X beskrivs på annat sätt.

\n

GET /memory/by-tag

\n

Lista minnen efter tagg.

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

GET /memory/related/:id

\n

Hitta minnen relaterade till ett specifikt minne (via gemensamma taggar).

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

Synkronisering & Diff

\n

GET /memory/diff

\n

Inkrementell synk — returnerar minnen som ändrats sedan en tidsstämpel.

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

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

\n

POST /memory/sync

\n

Tillämpa en diff från en annan instans (för självvärd synk).

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

Massåtgärder

\n

POST /memory/bulk-delete

\n

Ta bort flera minnen via 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

Generera inbäddningar för minnen som saknar dem (för semantisk sökning).

\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

Kontrollera förloppet för inbäddningsgenerering.

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

Verifiering

\n

Minnen har en verified-flagga. Agentlagrade minnen är som standard overifierade\n(source=agent); människolagrade minnen är verifierade (source=user).

\n

POST /memory/verify

\n

Markera ett minne som verifierat (kräver JWT, inte Mind Key).

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

POST /memory/unverify

\n

Markera ett minne som overifierat (kräver JWT).

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

GET /memory/unverified

\n

Lista minnen som väntar på mänsklig verifiering.

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

Statistik & granskning

\n

GET /memory/stats

\n

Aggregerad statistik för den aktuella minden.

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

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

\n

GET /memory/audit

\n

Granskningslogg över alla tillståndsändrande åtgärder.

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

GET /memory/contradictions

\n

Upptäck potentiella motsägelser i lagrade minnen.

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

GET /memory/expiring

\n

Lista minnen med utgångsdatum som närmar sig.

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

Hälsa & export

\n

GET /memory/health

\n

Snabb hälsokontroll för minnessystemet.

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

GET /memory/mind-export

\n

Full JSON-export av alla minnen (för säkerhetskopiering).

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

POST /memory/compact

\n

Komprimera liknande minnen (auto-sammanfattning).

\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ästa steg

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