{"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":273,"read_minutes":1,"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":"ja","translated":true,"requested_lang":"ja","content_markdown":"\n# Memory API\n\nMemory API は Synapse の中核です。構造化されたメモリの保存、取得、検索、管理のための 22 のエンドポイントを提供します。すべてのエンドポイントで認証に Mind Key が必要です。\n\n> [!CRITICAL]\n> **毎セッションの開始時に必ず `GET /memory/recall` を呼び出してください。** これが、前回のセッションからコンテキストを再構築する唯一の方法です。\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` — 絶対に忘れてはならない（ユーザー ID、法的情報）\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新しいメモリを保存するか、既存のメモリを更新します（同じ category + 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\nID で特定のメモリを更新します。\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\nFTS5 を使用したフルテキスト検索です。\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=docker+swarm\"\n```\n\nFTS5 構文：\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キーワードが一致しなくても、クエリと意味的に類似したメモリを返します。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 を適用します（セルフホスト同期用）。\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\nID で複数のメモリを削除します。\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` フラグがあります。エージェントが保存したメモリはデフォルトで未検証（`source=agent`）、人間が保存したメモリは検証済み（`source=user`）です。\n\n### POST /memory/verify\n\nメモリを検証済みとしてマークします（Mind Key ではなく JWT が必要）。\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- [Quick Start for LLMs](/docs/getting-started/quick-start-llm)\n- [Memory Best Practices](/docs/guides/memory-best-practices)\n- [FTS5 Search](/docs/concepts/fts5-search)\n- [Semantic Search](/docs/concepts/semantic-search)\n","content_html":"

Memory API

\n

Memory API は Synapse の中核です。構造化されたメモリの保存、取得、検索、管理のための 22 のエンドポイントを提供します。すべてのエンドポイントで認証に Mind Key が必要です。

\n
**毎セッションの開始時に必ず `GET /memory/recall` を呼び出してください。** これが、前回のセッションからコンテキストを再構築する唯一の方法です。

カテゴリ

\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

新しいメモリを保存するか、既存のメモリを更新します（同じ category + 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"

キーワードが一致しなくても、クエリと意味的に類似したメモリを返します。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 を適用します（セルフホスト同期用）。

\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 フラグがあります。エージェントが保存したメモリはデフォルトで未検証（source=agent）、人間が保存したメモリは検証済み（source=user）です。

\n

POST /memory/verify

\n

メモリを検証済みとしてマークします（Mind Key ではなく JWT が必要）。

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