# 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） |
|  | プロジェクトのステータス、マイルストーン、アーキテクチャ |
|  | ユーザーが得意なこと |
|  | 過去のエラー — 繰り返しを避ける |
|  | セッション関連のコンテキスト |
|  | その他のメモ |
優先度
-  — 知っておくとよい
-  — デフォルト
-  — 重要
-  — 絶対に忘れてはならない（ユーザー ID、法的情報）
コアエンドポイント
GET /memory/recall
すべてのメモリを LLM 向けに最適化されたプレーンテキストで返します。毎セッションの開始時に呼び出してください。
[CODE BLOCK]
レスポンス（text/plain）：
[CODE BLOCK]
POST /memory
新しいメモリを保存するか、既存のメモリを更新します（同じ category + 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 を適用します（セルフホスト同期用）。
[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
メモリを検証済みとしてマークします（Mind Key ではなく JWT が必要）。
[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]
次のステップ
- Quick Start for LLMs
- Memory Best Practices
- FTS5 Search
- Semantic Search