Copy

Memory Store 内の Memory エントリを一覧取得します。path プレフィックスでの絞り込みとカーソルページングに対応しています。一覧レスポンスには content は含まれません。内容を取得するには Memory の取得を使用します。

パス

GET /api/v1/forward/memory_stores/{memory_store_id}/memories

ヘッダー

ヘッダー	必須	説明
`Authorization`	はい	`Bearer <PAT or admin SAT>`

パスパラメータ

パラメータ	型	必須	説明
`memory_store_id`	string	はい	Memory Store ID（`memstore_...`）。

クエリパラメータ

パラメータ	型	必須	説明
`limit`	integer	いいえ	1 ページあたりの最大件数。1～100、デフォルトは 20。
`before_id`	string	いいえ	前方向ページングのカーソル。`after_id` と同時に指定できません。
`after_id`	string	いいえ	後方向ページングのカーソル。`before_id` と同時に指定できません。
`path_prefix`	string	いいえ	`path` のプレフィックスで絞り込みます。ディレクトリの意味ではなく単純な文字列プレフィックス一致で、`path_prefix=a/b` は `a/bc.md` にも一致します。

リクエスト例

# Basic list
curl -X GET "https://api.qoder.com/api/v1/forward/memory_stores/memstore_00mc7mukn7lkxr454tjd/memories" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

# Filter by path prefix
curl -X GET "https://api.qoder.com/api/v1/forward/memory_stores/memstore_00mc7mukn7lkxr454tjd/memories?path_prefix=decisions/" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

レスポンス例

HTTP 200 OK

{
  "data": [
    {
      "id": "mem_00mc7mvag5u68kkfvxhy",
      "type": "memory",
      "memory_store_id": "memstore_00mc7mukn7lkxr454tjd",
      "path": "decisions/arch-choice.md",
      "content_size_bytes": 99,
      "content_sha256": "1712de0d497a5aeef2beeccf4fbb7d5a16944975438d0c25447b9c1fba13099a",
      "metadata": {"owner": "backend-team"},
      "created_at": "2026-08-14T10:00:00Z",
      "updated_at": "2026-08-14T10:00:00Z"
    }
  ],
  "first_id": "mem_00mc7mvag5u68kkfvxhy",
  "last_id": "mem_00mc7mvag5u68kkfvxhy",
  "has_more": false
}

空リストのレスポンス

{
  "data": [],
  "first_id": null,
  "last_id": null,
  "has_more": false
}

レスポンスフィールド

フィールド	型	説明
`data`	array	`content` を含まない Memory オブジェクトの配列。
`first_id`	string/null	現在のページの先頭レコード ID。
`last_id`	string/null	現在のページの末尾レコード ID。
`has_more`	boolean	さらにレコードがあるかどうか。

エラー

HTTP	Type	発生条件
400	`invalid_request_error`	`limit` が範囲外、または `after_id` と `before_id` が同時に指定されています。
401	`authentication_error`	認証トークンがないか無効です。
403	`permission_error`	呼び出し元にこのリソースへのアクセス権限がありません。
404	`not_found_error`	Memory Store が存在しないか、別ユーザーのため参照できません。
500/502/503	`api_error`	Forward または依存サービスでエラーが発生しました。

​パス

​ヘッダー

​パスパラメータ

​クエリパラメータ

​リクエスト例

​レスポンス例

​空リストのレスポンス

​レスポンスフィールド

​エラー

パス