# 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
Сохранить новое воспоминание или обновить существующее (та же категория + key = обновление).
[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-поиск
- Семантический поиск