{"title":"Memory API","slug":"memory","category":"api","summary":"Повний довідник із 22 кінцевих точок пам'яті: збереження, відкликання, пошук, семантичний пошук, синхронізація, аудит та інше.","audience":["human","llm"],"tags":["api","memory","crud","search","fts5","semantic"],"difficulty":"intermediate","updated":"2026-06-27","word_count":511,"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":"uk","translated":true,"requested_lang":"uk","content_markdown":"\n# Memory API\n\nMemory API — це серце Synapse. Вона надає 22 кінцеві точки для збереження,\nотримання, пошуку та керування структурованими спогадами. Усі кінцеві точки\nпотребують Mind Key для автентифікації.\n\n> [!CRITICAL]\n> **Завжди викликайте `GET /memory/recall` на початку кожної сесії.** Це\n> єдиний спосіб відновити контекст із попередніх сесій.\n\n## Категорії\n\nСпогади організовано у 8 категорій:\n\n| Категорія | Варіант використання |\n|----------|----------|\n| `identity` | Ім'я користувача, роль, контактна інформація, налаштування щодо себе |\n| `preference` | Подобання, антипатії, стиль роботи, комунікаційні уподобання |\n| `fact` | Перевірювані факти (деталі проєктів, дати, URL-адреси) |\n| `project` | Статус проєкту, етапи, архітектура |\n| `skill` | Те, у чому користувач сильний |\n| `mistake` | Минулі помилки — уникайте повторення |\n| `context` | Контекст, релевантний сесії |\n| `note` | Різні нотатки |\n\n## Пріоритети\n\n- `low` — корисно знати\n- `normal` — за замовчуванням\n- `high` — важливо\n- `critical` — ніколи не забувати (ідентичність користувача, юридична інформація)\n\n## Основні кінцеві точки\n\n### GET /memory/recall\n\nПовертає ВСІ спогади у вигляді звичайного тексту, оптимізованого для LLM. Викликайте на початку кожної сесії.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\nВідповідь (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\nЗберігає новий спогад або оновлює наявний (та сама категорія + ключ = оновлення).\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\nВідповідь: `{ \"id\": \"mem_001\", \"status\": \"stored\" }`\n\n### GET /memory\n\nСписок спогадів із необов'язковими фільтрами.\n\n```bash\n# Усі спогади (JSON)\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory?limit=50&offset=0\"\n\n# Фільтр за категорією\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory?category=project\"\n\n# Фільтр за тегом\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory?tag=docker\"\n```\n\n### PUT /memory/:id\n\nОновлення конкретного спогаду за 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\nВидалення одного спогаду.\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/mem_001\n```\n\n## Кінцеві точки пошуку\n\n### GET /memory/search\n\nПовнотекстовий пошук з використанням FTS5.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=docker+swarm\"\n```\n\nСинтаксис FTS5:\n\n- Кілька слів = AND: `docker swarm`\n- Фраза: `\"docker swarm\"`\n- Префікс: `docker*`\n- Булеві операції: `docker OR kubernetes`\n- Виключення: `docker -swarm`\n\n### GET /memory/semantic-search\n\nКонцептуальний пошук за ембеддингами (повільніший за FTS5, але розуміє зміст).\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/semantic-search?q=container+orchestration\"\n```\n\nПовертає спогади, семантично подібні до запиту, навіть якщо ключові слова\nне збігаються. Корисно для «знайти спогади про X», де X описано інакше.\n\n### GET /memory/by-tag\n\nСписок спогадів за тегом.\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\nПошук спогадів, пов'язаних із конкретним спогадом (через спільні теги).\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/related/mem_001\n```\n\n## Синхронізація та Diff\n\n### GET /memory/diff\n\nІнкрементальна синхронізація — повертає спогади, що змінилися з певної мітки часу.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/diff?since=1700000000\"\n```\n\nВідповідь: `{ \"added\": [...], \"updated\": [...], \"deleted\": [...] }`\n\n### POST /memory/sync\n\nЗастосувати diff з іншої інсталяції (для синхронізації 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## Масові операції\n\n### POST /memory/bulk-delete\n\nВидалення кількох спогадів за 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\nГенерування ембеддингів для спогадів, які їх ще не мають (для семантичного пошуку).\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\nПеревірка прогресу генерації ембеддингів.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/embed-batch-status\n```\n\n## Верифікація\n\nСпогади мають прапорець `verified`. Спогади, збережені агентом, за замовчуванням\nнеперевірені (`source=agent`); спогади, збережені людиною, — перевірені (`source=user`).\n\n### POST /memory/verify\n\nПозначити спогад як перевірений (потребує JWT, а не 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\nПозначити спогад як неперевірений (потребує 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\nСписок спогадів, що очікують на перевірку людиною.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/unverified?limit=100\"\n```\n\n## Статистика та аудит\n\n### GET /memory/stats\n\nЗведена статистика для поточного mind-у.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/stats\n```\n\nПовертає: `{ \"total\": 12, \"verified\": 10, \"unverified\": 2, \"by_category\": {...}, \"by_priority\": {...} }`\n\n### GET /memory/audit\n\nЖурнал аудиту всіх операцій, що змінюють стан.\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\nВиявлення потенційних суперечностей у збережених спогадах.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/contradictions\n```\n\n### GET /memory/expiring\n\nСписок спогадів, термін дії яких наближається.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/expiring?within=7d\"\n```\n\n## Стан та експорт\n\n### GET /memory/health\n\nШвидка перевірка стану системи пам'яті.\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\nПовний JSON-експорт усіх спогадів (для резервного копіювання).\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Ущільнення подібних спогадів (автосумаризація).\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\n- [Швидкий старт для LLM](/docs/getting-started/quick-start-llm)\n- [Найкращі практики роботи з пам'яттю](/docs/guides/memory-best-practices)\n- [Пошук FTS5](/docs/concepts/fts5-search)\n- [Семантичний пошук](/docs/concepts/semantic-search)\n","content_html":"

Memory API

\n

Memory API — це серце Synapse. Вона надає 22 кінцеві точки для збереження,\nотримання, пошуку та керування структурованими спогадами. Усі кінцеві точки\nпотребують Mind Key для автентифікації.

\n
**Завжди викликайте `GET /memory/recall` на початку кожної сесії.** Це\nєдиний спосіб відновити контекст із попередніх сесій.

Категорії

\n

Спогади організовано у 8 категорій:

\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
КатегоріяВаріант використання
identityІм'я користувача, роль, контактна інформація, налаштування щодо себе
preferenceПодобання, антипатії, стиль роботи, комунікаційні уподобання
factПеревірювані факти (деталі проєктів, дати, URL-адреси)
projectСтатус проєкту, етапи, архітектура
skillТе, у чому користувач сильний
mistakeМинулі помилки — уникайте повторення
contextКонтекст, релевантний сесії
noteРізні нотатки
\n

Пріоритети

\n\n

Основні кінцеві точки

\n

GET /memory/recall

\n

Повертає ВСІ спогади у вигляді звичайного тексту, оптимізованого для LLM. Викликайте на початку кожної сесії.

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

Відповідь (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

Зберігає новий спогад або оновлює наявний (та сама категорія + ключ = оновлення).

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

Відповідь: { "id": "mem_001", "status": "stored" }

\n

GET /memory

\n

Список спогадів із необов'язковими фільтрами.

\n
# Усі спогади (JSON)\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory?limit=50&offset=0"\n\n# Фільтр за категорією\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory?category=project"\n\n# Фільтр за тегом\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory?tag=docker"

PUT /memory/:id

\n

Оновлення конкретного спогаду за 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

Видалення одного спогаду.

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

Кінцеві точки пошуку

\n

GET /memory/search

\n

Повнотекстовий пошук з використанням FTS5.

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

Синтаксис FTS5:

\n\n

GET /memory/semantic-search

\n

Концептуальний пошук за ембеддингами (повільніший за FTS5, але розуміє зміст).

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

Повертає спогади, семантично подібні до запиту, навіть якщо ключові слова\nне збігаються. Корисно для «знайти спогади про X», де X описано інакше.

\n

GET /memory/by-tag

\n

Список спогадів за тегом.

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

GET /memory/related/:id

\n

Пошук спогадів, пов'язаних із конкретним спогадом (через спільні теги).

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

Синхронізація та Diff

\n

GET /memory/diff

\n

Інкрементальна синхронізація — повертає спогади, що змінилися з певної мітки часу.

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

Відповідь: { "added": [...], "updated": [...], "deleted": [...] }

\n

POST /memory/sync

\n

Застосувати diff з іншої інсталяції (для синхронізації 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": [...]}'

Масові операції

\n

POST /memory/bulk-delete

\n

Видалення кількох спогадів за 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

Генерування ембеддингів для спогадів, які їх ще не мають (для семантичного пошуку).

\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

Перевірка прогресу генерації ембеддингів.

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

Верифікація

\n

Спогади мають прапорець verified. Спогади, збережені агентом, за замовчуванням\nнеперевірені (source=agent); спогади, збережені людиною, — перевірені (source=user).

\n

POST /memory/verify

\n

Позначити спогад як перевірений (потребує JWT, а не Mind Key).

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

POST /memory/unverify

\n

Позначити спогад як неперевірений (потребує JWT).

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

GET /memory/unverified

\n

Список спогадів, що очікують на перевірку людиною.

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

Статистика та аудит

\n

GET /memory/stats

\n

Зведена статистика для поточного mind-у.

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

Повертає: { "total": 12, "verified": 10, "unverified": 2, "by_category": {...}, "by_priority": {...} }

\n

GET /memory/audit

\n

Журнал аудиту всіх операцій, що змінюють стан.

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

GET /memory/contradictions

\n

Виявлення потенційних суперечностей у збережених спогадах.

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

GET /memory/expiring

\n

Список спогадів, термін дії яких наближається.

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

Стан та експорт

\n

GET /memory/health

\n

Швидка перевірка стану системи пам'яті.

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

GET /memory/mind-export

\n

Повний JSON-експорт усіх спогадів (для резервного копіювання).

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

POST /memory/compact

\n

Ущільнення подібних спогадів (автосумаризація).

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