{"title":"Memory API","slug":"memory","category":"api","summary":"Pełna dokumentacja 22 endpointów pamięci: zapis, recall, wyszukiwanie, wyszukiwanie semantyczne, synchronizacja, audyt i więcej.","audience":["human","llm"],"tags":["api","memory","crud","search","fts5","semantic"],"difficulty":"intermediate","updated":"2026-06-27","word_count":514,"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":"pl","translated":true,"requested_lang":"pl","content_markdown":"\n# Memory API\n\nMemory API stanowi serce Synapse. Zapewnia 22 endpointy do zapisywania,\npobierania, wyszukiwania i zarządzania ustrukturyzowanymi wspomnieniami. Wszystkie\nendpointy wymagają Mind Key do autoryzacji.\n\n> [!CRITICAL]\n> **Należy zawsze wywoływać `GET /memory/recall` na początku każdej sesji.** To\n> jedyny sposób odbudowy kontekstu z poprzednich sesji.\n\n## Kategorie\n\nWspomnienia są zorganizowane w 8 kategoriach:\n\n| Kategoria | Przypadek użycia |\n|----------|----------|\n| `identity` | Imię użytkownika, rola, dane kontaktowe, preferencje dotyczące samego siebie |\n| `preference` | Sympatie, antypatie, styl pracy, preferencje komunikacyjne |\n| `fact` | Weryfikowalne fakty (szczegóły projektu, daty, URL-e) |\n| `project` | Status projektu, kamienie milowe, architektura |\n| `skill` | Rzeczy, w których użytkownik jest dobry |\n| `mistake` | Błędy z przeszłości — unikać ich powtarzania |\n| `context` | Kontekst istotny dla sesji |\n| `note` | Różne notatki |\n\n## Priorytety\n\n- `low` — warto wiedzieć\n- `normal` — domyślny\n- `high` — ważne\n- `critical` — nigdy nie wolno zapominać (tożsamość użytkownika, informacje prawne)\n\n## Podstawowe endpointy\n\n### GET /memory/recall\n\nZwraca WSZYSTKIE wspomnienia jako zwykły tekst zoptymalizowany dla LLM. Należy\nwywoływać na początku każdej sesji.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\nOdpowiedź (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\nZapisuje nowe wspomnienie lub aktualizuje istniejące (ta sama kategoria + klucz\n= aktualizacja).\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\nOdpowiedź: `{ \"id\": \"mem_001\", \"status\": \"stored\" }`\n\n### GET /memory\n\nLista wspomnień z opcjonalnymi filtrami.\n\n```bash\n# Wszystkie wspomnienia (JSON)\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory?limit=50&offset=0\"\n\n# Filtr wg kategorii\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory?category=project\"\n\n# Filtr wg tagu\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory?tag=docker\"\n```\n\n### PUT /memory/:id\n\nAktualizuje konkretne wspomnienie po 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\nUsuwa pojedyncze wspomnienie.\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/mem_001\n```\n\n## Endpointy wyszukiwania\n\n### GET /memory/search\n\nWyszukiwanie pełnotekstowe z użyciem FTS5.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=docker+swarm\"\n```\n\nSkładnia FTS5:\n\n- Wiele słów = AND: `docker swarm`\n- Fraza: `\"docker swarm\"`\n- Prefiks: `docker*`\n- Wartość logiczna: `docker OR kubernetes`\n- Wykluczenie: `docker -swarm`\n\n### GET /memory/semantic-search\n\nWyszukiwanie semantyczne z użyciem osadzeń (wolniejsze niż FTS5, ale rozumie znaczenie).\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/semantic-search?q=container+orchestration\"\n```\n\nZwraca wspomnienia semantycznie podobne do zapytania, nawet jeśli nie ma dopasowań\nsłów kluczowych. Przydatne do „znajdź wspomnienia o X\", gdy X jest opisane inaczej.\n\n### GET /memory/by-tag\n\nLista wspomnień wg tagu.\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\nZnajduje wspomnienia powiązane z konkretnym (przez wspólne tagi).\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/related/mem_001\n```\n\n## Synchronizacja i diff\n\n### GET /memory/diff\n\nSynchronizacja przyrostowa — zwraca wspomnienia zmienione od podanego\nznacznika czasu.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/diff?since=1700000000\"\n```\n\nOdpowiedź: `{ \"added\": [...], \"updated\": [...], \"deleted\": [...] }`\n\n### POST /memory/sync\n\nStosuje diff z innej instancji (do synchronizacji self-hosted).\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## Operacje masowe\n\n### POST /memory/bulk-delete\n\nUsuwa wiele wspomnień po 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\nGeneruje osadzenia dla wspomnień, które ich jeszcze nie mają (do wyszukiwania\nsemantycznego).\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\nSprawdza postęp generowania osadzeń.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/embed-batch-status\n```\n\n## Weryfikacja\n\nWspomnienia mają flagę `verified`. Wspomnienia zapisane przez agenta są domyślnie\nniezweryfikowane (`source=agent`); zapisane przez człowieka są zweryfikowane\n(`source=user`).\n\n### POST /memory/verify\n\nOznacza wspomnienie jako zweryfikowane (wymaga JWT, nie 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\nOznacza wspomnienie jako niezweryfikowane (wymaga 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 wspomnień oczekujących na weryfikację przez człowieka.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/unverified?limit=100\"\n```\n\n## Statystyki i audyt\n\n### GET /memory/stats\n\nStatystyki agregowane dla bieżącego umysłu.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/stats\n```\n\nZwraca: `{ \"total\": 12, \"verified\": 10, \"unverified\": 2, \"by_category\": {...}, \"by_priority\": {...} }`\n\n### GET /memory/audit\n\nDziennik audytu wszystkich operacji zmieniających stan.\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\nWykrywa potencjalne sprzeczności w zapisanych wspomnieniach.\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 wspomnień z zbliżającą się datą wygaśnięcia.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/expiring?within=7d\"\n```\n\n## Kondycja i eksport\n\n### GET /memory/health\n\nSzybkie sprawdzenie kondycji systemu pamięci.\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\nPełny eksport JSON wszystkich wspomnień (do kopii zapasowej).\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\nKompaktuje podobne wspomnienia (automatyczne streszczanie).\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## Następne kroki\n\n- [Szybki start dla LLM](/docs/getting-started/quick-start-llm)\n- [Najlepsze praktyki pamięci](/docs/guides/memory-best-practices)\n- [Wyszukiwanie FTS5](/docs/concepts/fts5-search)\n- [Wyszzukiwanie semantyczne](/docs/concepts/semantic-search)\n","content_html":"

Memory API

\n

Memory API stanowi serce Synapse. Zapewnia 22 endpointy do zapisywania,\npobierania, wyszukiwania i zarządzania ustrukturyzowanymi wspomnieniami. Wszystkie\nendpointy wymagają Mind Key do autoryzacji.

\n
**Należy zawsze wywoływać `GET /memory/recall` na początku każdej sesji.** To\njedyny sposób odbudowy kontekstu z poprzednich sesji.

Kategorie

\n

Wspomnienia są zorganizowane w 8 kategoriach:

\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
KategoriaPrzypadek użycia
identityImię użytkownika, rola, dane kontaktowe, preferencje dotyczące samego siebie
preferenceSympatie, antypatie, styl pracy, preferencje komunikacyjne
factWeryfikowalne fakty (szczegóły projektu, daty, URL-e)
projectStatus projektu, kamienie milowe, architektura
skillRzeczy, w których użytkownik jest dobry
mistakeBłędy z przeszłości — unikać ich powtarzania
contextKontekst istotny dla sesji
noteRóżne notatki
\n

Priorytety

\n\n

Podstawowe endpointy

\n

GET /memory/recall

\n

Zwraca WSZYSTKIE wspomnienia jako zwykły tekst zoptymalizowany dla LLM. Należy\nwywoływać na początku każdej sesji.

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

Odpowiedź (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

Zapisuje nowe wspomnienie lub aktualizuje istniejące (ta sama kategoria + klucz\n= aktualizacja).

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

Odpowiedź: { "id": "mem_001", "status": "stored" }

\n

GET /memory

\n

Lista wspomnień z opcjonalnymi filtrami.

\n
# Wszystkie wspomnienia (JSON)\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory?limit=50&offset=0"\n\n# Filtr wg kategorii\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory?category=project"\n\n# Filtr wg tagu\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory?tag=docker"

PUT /memory/:id

\n

Aktualizuje konkretne wspomnienie po 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

Usuwa pojedyncze wspomnienie.

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

Endpointy wyszukiwania

\n

GET /memory/search

\n

Wyszukiwanie pełnotekstowe z użyciem FTS5.

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

Składnia FTS5:

\n\n

GET /memory/semantic-search

\n

Wyszukiwanie semantyczne z użyciem osadzeń (wolniejsze niż FTS5, ale rozumie znaczenie).

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

Zwraca wspomnienia semantycznie podobne do zapytania, nawet jeśli nie ma dopasowań\nsłów kluczowych. Przydatne do „znajdź wspomnienia o X", gdy X jest opisane inaczej.

\n

GET /memory/by-tag

\n

Lista wspomnień wg tagu.

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

GET /memory/related/:id

\n

Znajduje wspomnienia powiązane z konkretnym (przez wspólne tagi).

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

Synchronizacja i diff

\n

GET /memory/diff

\n

Synchronizacja przyrostowa — zwraca wspomnienia zmienione od podanego\nznacznika czasu.

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

Odpowiedź: { "added": [...], "updated": [...], "deleted": [...] }

\n

POST /memory/sync

\n

Stosuje diff z innej instancji (do synchronizacji self-hosted).

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

Operacje masowe

\n

POST /memory/bulk-delete

\n

Usuwa wiele wspomnień po 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

Generuje osadzenia dla wspomnień, które ich jeszcze nie mają (do wyszukiwania\nsemantycznego).

\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

Sprawdza postęp generowania osadzeń.

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

Weryfikacja

\n

Wspomnienia mają flagę verified. Wspomnienia zapisane przez agenta są domyślnie\nniezweryfikowane (source=agent); zapisane przez człowieka są zweryfikowane\n(source=user).

\n

POST /memory/verify

\n

Oznacza wspomnienie jako zweryfikowane (wymaga JWT, nie Mind Key).

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

POST /memory/unverify

\n

Oznacza wspomnienie jako niezweryfikowane (wymaga JWT).

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

GET /memory/unverified

\n

Lista wspomnień oczekujących na weryfikację przez człowieka.

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

Statystyki i audyt

\n

GET /memory/stats

\n

Statystyki agregowane dla bieżącego umysłu.

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

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

\n

GET /memory/audit

\n

Dziennik audytu wszystkich operacji zmieniających stan.

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

GET /memory/contradictions

\n

Wykrywa potencjalne sprzeczności w zapisanych wspomnieniach.

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

GET /memory/expiring

\n

Lista wspomnień z zbliżającą się datą wygaśnięcia.

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

Kondycja i eksport

\n

GET /memory/health

\n

Szybkie sprawdzenie kondycji systemu pamięci.

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

GET /memory/mind-export

\n

Pełny eksport JSON wszystkich wspomnień (do kopii zapasowej).

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

POST /memory/compact

\n

Kompaktuje podobne wspomnienia (automatyczne streszczanie).

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

Następne kroki

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