获取记忆条目

根据 ID 获取单个 memory entry。

GET /v1/memory_stores/{memory_store_id}/memories/{memory_id}

获取单个 Memory entry 对象。内容可用时，响应包含 content。

​

请求头

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

​

路径参数

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

​

示例请求

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

​

示例响应

HTTP 200 OK

{
  "id": "mem_019e3bb965a671fca51bde1cf8d87de0",
  "type": "memory",
  "store_id": "memstore_019e3bb93b7074f9a5130d39ddcca90f",
  "path": "test/note.md",
  "content": "Hello world",
  "size": 11,
  "content_sha256": "64ec88ca00b268e5ba1a35678a1b5316d212f4f366b2477232534a8aeca37f3c",
  "version": 1,
  "metadata": {},
  "created_at": "2026-05-18T15:34:26.494349Z",
  "updated_at": "2026-05-18T15:34:26.494349Z"
}

​

响应字段

字段	类型	说明
id	string	Memory entry ID，前缀为 mem_
type	string	固定值 "memory"
store_id	string	所属 Memory Store ID
path	string	相对 memory 路径
content	string	当前 entry 内容；内容可用时返回
size	integer	内容大小，单位 byte
content_sha256	string	当前内容的 SHA-256 摘要
version	integer	当前 entry 版本
metadata	Metadata 对象	自定义元数据
created_at	string	UTC 创建时间
updated_at	string	UTC 最后更新时间

​

错误码

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

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

​

相关

Memory Stores

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