# Memory API
SUMMARY: Повний довідник із 22 кінцевих точок пам'яті: збереження, відкликання, пошук, семантичний пошук, синхронізація, аудит та інше.

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 — це серце Synapse. Вона надає 22 кінцеві точки для збереження,
отримання, пошуку та керування структурованими спогадами. Усі кінцеві точки
потребують Mind Key для автентифікації.
> [!CRITICAL]
> Завжди викликайте  на початку кожної сесії. Це
> єдиний спосіб відновити контекст із попередніх сесій.
Категорії
Спогади організовано у 8 категорій:
| Категорія | Варіант використання |
|----------|----------|
|  | Ім'я користувача, роль, контактна інформація, налаштування щодо себе |
|  | Подобання, антипатії, стиль роботи, комунікаційні уподобання |
|  | Перевірювані факти (деталі проєктів, дати, URL-адреси) |
|  | Статус проєкту, етапи, архітектура |
|  | Те, у чому користувач сильний |
|  | Минулі помилки — уникайте повторення |
|  | Контекст, релевантний сесії |
|  | Різні нотатки |
Пріоритети
-  — корисно знати
-  — за замовчуванням
-  — важливо
-  — ніколи не забувати (ідентичність користувача, юридична інформація)
Основні кінцеві точки
GET /memory/recall
Повертає ВСІ спогади у вигляді звичайного тексту, оптимізованого для LLM. Викликайте на початку кожної сесії.
[CODE BLOCK]
Відповідь (text/plain):
[CODE BLOCK]
POST /memory
Зберігає новий спогад або оновлює наявний (та сама категорія + ключ = оновлення).
[CODE BLOCK]
Відповідь: 
GET /memory
Список спогадів із необов'язковими фільтрами.
[CODE BLOCK]
PUT /memory/:id
Оновлення конкретного спогаду за ID.
[CODE BLOCK]
DELETE /memory/:id
Видалення одного спогаду.
[CODE BLOCK]
Кінцеві точки пошуку
GET /memory/search
Повнотекстовий пошук з використанням FTS5.
[CODE BLOCK]
Синтаксис FTS5:
- Кілька слів = AND: 
- Фраза: 
- Префікс: 
- Булеві операції: 
- Виключення: 
GET /memory/semantic-search
Концептуальний пошук за ембеддингами (повільніший за FTS5, але розуміє зміст).
[CODE BLOCK]
Повертає спогади, семантично подібні до запиту, навіть якщо ключові слова
не збігаються. Корисно для «знайти спогади про X», де X описано інакше.
GET /memory/by-tag
Список спогадів за тегом.
[CODE BLOCK]
GET /memory/related/:id
Пошук спогадів, пов'язаних із конкретним спогадом (через спільні теги).
[CODE BLOCK]
Синхронізація та Diff
GET /memory/diff
Інкрементальна синхронізація — повертає спогади, що змінилися з певної мітки часу.
[CODE BLOCK]
Відповідь: 
POST /memory/sync
Застосувати diff з іншої інсталяції (для синхронізації self-hosted).
[CODE BLOCK]
Масові операції
POST /memory/bulk-delete
Видалення кількох спогадів за ID.
[CODE BLOCK]
POST /memory/embed-batch
Генерування ембеддингів для спогадів, які їх ще не мають (для семантичного пошуку).
[CODE BLOCK]
GET /memory/embed-batch-status
Перевірка прогресу генерації ембеддингів.
[CODE BLOCK]
Верифікація
Спогади мають прапорець . Спогади, збережені агентом, за замовчуванням
неперевірені (); спогади, збережені людиною, — перевірені ().
POST /memory/verify
Позначити спогад як перевірений (потребує JWT, а не Mind Key).
[CODE BLOCK]
POST /memory/unverify
Позначити спогад як неперевірений (потребує JWT).
[CODE BLOCK]
GET /memory/unverified
Список спогадів, що очікують на перевірку людиною.
[CODE BLOCK]
Статистика та аудит
GET /memory/stats
Зведена статистика для поточного mind-у.
[CODE BLOCK]
Повертає: 
GET /memory/audit
Журнал аудиту всіх операцій, що змінюють стан.
[CODE BLOCK]
GET /memory/contradictions
Виявлення потенційних суперечностей у збережених спогадах.
[CODE BLOCK]
GET /memory/expiring
Список спогадів, термін дії яких наближається.
[CODE BLOCK]
Стан та експорт
GET /memory/health
Швидка перевірка стану системи пам'яті.
[CODE BLOCK]
GET /memory/mind-export
Повний JSON-експорт усіх спогадів (для резервного копіювання).
[CODE BLOCK]
POST /memory/compact
Ущільнення подібних спогадів (автосумаризація).
[CODE BLOCK]
Наступні кроки
- Швидкий старт для LLM
- Найкращі практики роботи з пам'яттю
- Пошук FTS5
- Семантичний пошук