Memory Store の一覧取得

現在のアカウントから参照できる Memory Store を ID の降順で返します。カーソルページングに対応しています。レスポンスには、Session 作成時に自動構成される Identity のデフォルト Store（system_managed=true）も含まれます。ユーザーが明示的に作成した Store のみを返す汎用 GET /api/v1/forward/resources?type=memory_store とは異なります。

パス

GET /api/v1/forward/memory_stores

ヘッダー

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

クエリパラメータ

パラメータ	型	必須	説明
`limit`	integer	いいえ	1 ページあたりの最大件数。1～100、デフォルトは 20。
`before_id`	string	いいえ	前方向ページングのカーソル。`after_id` と同時に指定できません。
`after_id`	string	いいえ	後方向ページングのカーソル。`before_id` と同時に指定できません。
`system_managed`	boolean	いいえ	3 値フィルター。`true` はシステム管理のデフォルト Store のみ、`false` はユーザー作成の Store のみを返し、省略すると両方を返します。

リクエスト例

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

# Paginated list
curl -X GET "https://api.qoder.com/api/v1/forward/memory_stores?limit=10&after_id=memstore_xxx" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

# User-created stores only
curl -X GET "https://api.qoder.com/api/v1/forward/memory_stores?system_managed=false" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

レスポンス例

HTTP 200 OK

{
  "data": [
    {
      "id": "memstore_00mc7mukn7lkxr454tjd",
      "type": "memory_store",
      "name": "project-alpha-memory",
      "description": "Agent knowledge base for project Alpha",
      "status": "active",
      "entry_count": 12,
      "total_size": 4096,
      "metadata": {"created_by": "forward", "team": "backend"},
      "system_managed": false,
      "identity_id": null,
      "created_at": "2026-08-14T10:00:00Z",
      "updated_at": "2026-08-14T10:00:00Z",
      "archived_at": null,
      "binding_info": {"identity_template_count": 1}
    }
  ],
  "first_id": "memstore_00mc7mukn7lkxr454tjd",
  "last_id": "memstore_00mc7mukn7lkxr454tjd",
  "has_more": false
}

空リストのレスポンス

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

レスポンスフィールド

フィールド	型	説明
`data`	array	Memory Store オブジェクトの配列。
`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`	呼び出し元にこのリソースへのアクセス権限がありません。
500/502/503	`api_error`	Forward または依存サービスでエラーが発生しました。

​パス

​ヘッダー

​クエリパラメータ

​リクエスト例

​レスポンス例

​空リストのレスポンス

​レスポンスフィールド

​エラー