{"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":513,"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":"ru","translated":true,"requested_lang":"ru","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\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Сохранить новое воспоминание или обновить существующее (та же категория + key = обновление).\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# 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\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»,\nгде 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Вызывайте в начале каждой сессии.

\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

Сохранить новое воспоминание или обновить существующее (та же категория + key = обновление).

\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
# 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

Обновить конкретное воспоминание по 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»,\nгде 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"]}