REST APIリファレンス

すべてのエンドポイントにBearerトークンが必要です。ダッシュボードからトークンを取得してください。

# ベースURL

https://api.agent-memo.ai

# 認証ヘッダー

Authorization: Bearer YOUR_API_KEY

メモリ

GET/api/memories

オプションのフィルター付きメモリ一覧

Query: ?topic=&type=&importance=&limit=&offset=

POST/api/memories

新規メモリの作成

{ "content": "...", "type": "project", "topic": "auth", "importance": 2, "tags": ["decision"] }

GET/api/memories/:id

IDで単一メモリを取得

PUT/api/memories/:id

既存メモリの更新

{ "content": "updated content", "importance": 3 }

DELETE/api/memories/:id

メモリの削除

POST/api/memories/search

メモリ全体のセマンティック検索

{ "query": "database choice", "type": ["project"], "limit": 5 }

GET/api/memories/topics

メモリ数付きの全トピック一覧

POST/api/memories/check-duplicate

保存前のセマンティック重複チェック

{ "content": "...", "threshold": 0.92 }

POST/api/kg/add

エンティティ関係（ファクト）の追加

{ "subject": "auth-service", "predicate": "uses", "object": "JWT", "confidence": 0.95 }

POST/api/kg/query

エンティティ関係の照会

{ "entity": "auth-service", "direction": "outgoing" }

POST/api/kg/invalidate

ファクトの無効化（もう正しくないとマーク）

{ "factId": "..." }

POST/api/kg/timeline

エンティティのファクトタイムライン表示

{ "entity": "auth-service" }

GET/api/kg/stats

ナレッジグラフの統計

すべてのレスポンスはJSONです。成功時はデータを直接返します。エラー時はerrorフィールドを含むJSONオブジェクトを返します。

成功 (200)

{
  "id": "abc-123",
  "content": "Use PostgreSQL",
  "type": "project",
  "topic": "database",
  "importance": 3,
  "created_at": "2026-04-08T..."
}

エラー (4xx/5xx)

{
  "error": "Memory not found"
}

ベータ期間中はレート制限は適用されません。適切な利用をお願いします — 一般的な利用は毎分100リクエスト以下です。有料ティアの導入に伴いレート制限が導入される予定です。