Copy

(identity, template) に対するすべての active な Memory Store マウントを一覧取得します。最初の Session 作成時に自動作成されるデフォルト Store も含まれます。システム管理のデフォルト Store が常に先頭で、access=read_write を持つ唯一のマウントです。明示的なマウントは作成時刻の昇順で続き、すべて read_only です。マウント数は、明示的な 10 個とデフォルト枠に制限されます。そのため、この API はページングパラメータを受け付けず、has_more は常に false です。

パス

GET /api/v1/forward/identities/{identity_id}/templates/{template_id}/memory_stores

ヘッダー

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

Identity レベルの Service Account Token は自身の Identity のみ照会できます。別の Identity を照会すると 403 が返されます。

パスパラメータ

パラメータ	型	必須	説明
`identity_id`	string	はい	Identity ID（`idn_...`）。
`template_id`	string	はい	Template ID（`tmpl_...`）。

リクエスト例

curl -X GET "https://api.qoder.com/api/v1/forward/identities/idn_63ee28747a35cff93771c491/templates/tmpl_eb3377fb74ad413e17b3d755/memory_stores" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

レスポンス例

HTTP 200 OK

{
  "data": [
    {
      "memory_store_id": "memstore_00mc7mtpughs0h0b7vll",
      "identity_id": "idn_63ee28747a35cff93771c491",
      "template_id": "tmpl_eb3377fb74ad413e17b3d755",
      "access": "read_write",
      "system_managed": true,
      "name": "System Default Memory",
      "status": "active",
      "entry_count": 3,
      "created_at": "2026-08-14T09:50:14Z"
    },
    {
      "memory_store_id": "memstore_00mc7mukn7lkxr454tjd",
      "identity_id": "idn_63ee28747a35cff93771c491",
      "template_id": "tmpl_eb3377fb74ad413e17b3d755",
      "access": "read_only",
      "system_managed": false,
      "name": "team-a",
      "status": "active",
      "entry_count": 12,
      "created_at": "2026-08-14T10:00:00Z"
    }
  ],
  "first_id": "memstore_00mc7mtpughs0h0b7vll",
  "last_id": "memstore_00mc7mukn7lkxr454tjd",
  "has_more": false
}

空リストのレスポンス

Session がまだ作成されておらず、明示的な Store もマウントされていない場合は空リストを返します。システム管理のデフォルト Store は、最初の Session の作成時に自動作成されます。

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

レスポンスフィールド

フィールド	型	説明
`data`	array	Memory Store マウントオブジェクトの配列。
`first_id`	string/null	現在のページの先頭マウントの `memory_store_id`。
`last_id`	string/null	現在のページの末尾マウントの `memory_store_id`。
`has_more`	boolean	マウント数に上限があるため常に `false`。

エラー

HTTP	Type	発生条件
400	`invalid_request_error`	パスパラメータが無効です。
401	`authentication_error`	認証トークンがないか無効です。
403	`permission_error`	Identity レベルの SAT が別の Identity を照会しようとしました。
404	`not_found_error`	Identity または Template が存在しないか参照できません。
500/502/503	`api_error`	Forward または依存サービスでエラーが発生しました。

​パス

​ヘッダー

​パスパラメータ

​リクエスト例

​レスポンス例

​空リストのレスポンス

​レスポンスフィールド

​エラー