列出 Identity 上的 Memory Store 挂载

列出指定 (identity, template) 上所有活跃的 Memory Store 挂载，包含系统在 Session 创建时自动配的默认库。系统默认库始终排第一，是唯一 access=read_write 的挂载；其余显式挂载按挂载时间升序排列，全部为 read_only。挂载数量受上限约束（10 + 默认槽位），因此本接口不接受分页参数，has_more 恒为 false。

路径

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

请求头

头部	必选	说明
`Authorization`	是	`Bearer <PAT、admin SAT 或该 identity 的 SAT>`

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 且没有任何显式挂载时返回空列表 —— 系统默认库是在首次创建 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 或依赖服务失败。

​路径

​请求头

​路径参数

​示例请求

​示例响应

​空列表响应

​响应字段解释

​错误码

路径

请求头

路径参数

示例请求

示例响应

空列表响应

响应字段解释

错误码