REST
APIリファレンス
MemoryFirstは、ネイティブのREST APIを公開しています。同じ記憶には、MCP経由でもアクセスできます(MCPガイドをご覧ください)。
ベースURL
https://api.memoryfirst.ai/v1
認証
すべてのリクエストには、APIキーを次のヘッダーに指定する必要があります Authorization :
curl https://api.memoryfirst.ai/v1/experts/{expertId}/query \
-H "Authorization: Bearer mf_live_xxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"question": "What did we promise this client?", "k": 8}'エンドポイント
POST /v1/experts/{id}/sources: 新しい情報源を処理するPOST /v1/experts/{id}/query: 出典付きで記憶に問い合わせるGET /v1/experts: ワークスペース内のエキスパートを一覧表示するPOST /v1/experts: 新しいエキスパートを作成するGET /v1/usage: 現在の期間の利用統計POST /v1/brain/event: ブレインのイベント(意思決定、ブロッカー、デプロイ、顧客との接点)を記録します。イベントのidとともに202を返します。
重複しない再試行:Idempotency-Key
ネットワークの切断後にクライアントが再試行する場合や、送信トレイを再送する場合は、POST /v1/brain/event に、独自のキー(印字可能なASCII文字で1〜255文字、空白なし)を指定した Idempotency-Key ヘッダーを付けて送信してください。同じワークスペースで同じキーを使うと、24時間のあいだ、すでに作成されたイベントが 200 と idempotent_replay: true で返され、新しいイベントは作成されません。
curl https://api.memoryfirst.ai/v1/brain/event \
-H "Authorization: Bearer mf_live_xxxxxxxxxxxxxxxxxxxx" \
-H "Idempotency-Key: outbox-2026-11-13-0042" \
-H "Content-Type: application/json" \
-d '{"project": "my-project", "event_type": "decision_taken", "title": "Move blobs to R2"}'再送されたボディが異なる場合は、元のイベントが変更されないまま payload_differs: true とともに返されます。同じキーで別のプロジェクトを指定すると 422 が返ります。最初のリクエストがまだ処理中の場合は 409 が返ります(同じキーで再試行してください)。MCPツール mf_record では、idempotency_key 引数を渡します。
OpenAPI 3.1の完全な仕様は近日公開予定です。先行アクセスをご希望の方は hola [at] memoryfirst.ai までご連絡ください。