获取 Memory Store

根据 ID 获取单个 Memory Store。

GET /v1/memory_stores/{memory_store_id}

获取单个 Memory Store 对象。

​

请求头

头部	必选	说明
Authorization	是	Bearer <PAT>

​

路径参数

参数	类型	必选	说明
memory_store_id	string	是	Memory Store ID，前缀为 memstore_

​

示例请求

curl -X GET "https://api.qoder.com/api/v1/cloud/memory_stores/memstore_019e3bb8d50674d9b082b73709c29c87" \
  -H "Authorization: Bearer $QODER_PAT"

​

示例响应

HTTP 200 OK

{
  "id": "memstore_019e3bb8d50674d9b082b73709c29c87",
  "type": "memory_store",
  "name": "doc-test-store",
  "description": "测试用",
  "status": "active",
  "entry_count": 0,
  "total_size": 0,
  "metadata": {},
  "created_at": "2026-05-18T15:33:49.449264Z",
  "updated_at": "2026-05-18T15:33:49.449264Z"
}

​

响应字段

字段	类型	说明
id	string	Memory Store ID，前缀为 memstore_
type	string	固定值 "memory_store"
name	string	Store 名称
description	string	Store 描述
status	string	Store 状态，见 Memory Store status
entry_count	integer	active memory entry 数量
total_size	integer	active memory entry 总大小，单位 byte
metadata	Metadata 对象	自定义元数据
archived_at	string	仅 Store 已归档时返回
created_at	string	UTC 创建时间
updated_at	string	UTC 最后更新时间

​

错误码

HTTP	type	触发条件
401	authentication_error	缺少或无效的认证令牌
404	not_found_error	指定 ID 的 Memory Store 不存在

完整错误信封说明详见 错误参考。

​

相关

Memory Stores

让 Agent 拥有跨 Session 的持久记忆。