更新记忆条目

更新 memory entry 的内容并生成新版本。

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

更新 active 状态 Memory Store 中的 memory entry。每次成功更新都会递增 version，并生成一条 action: "updated" 的 version 记录。

​

请求头

头部	必选	说明
Authorization	是	Bearer <PAT>
Content-Type	是	application/json

​

路径参数

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

​

请求体

字段	类型	必选	说明
content	string	是	新的文本内容。trim 后不能为空，最大 100 KB
content_sha256	string	否	乐观并发校验字段。提供时必须与当前 entry 的 content_sha256 一致
metadata	Metadata 对象	否	替换后的 metadata。省略该字段时保留现有 metadata

​

示例请求

curl -X PUT "https://api.qoder.com/api/v1/cloud/memory_stores/memstore_xxx/memories/mem_xxx" \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "更新后的内容...",
    "content_sha256": "64ec88ca00b268e5ba1a35678a1b5316d212f4f366b2477232534a8aeca37f3c",
    "metadata": {
      "source": "meeting"
    }
  }'

​

示例响应

HTTP 200 OK

{
  "id": "mem_019e3bb965a671fca51bde1cf8d87de0",
  "type": "memory",
  "store_id": "memstore_019e3bb93b7074f9a5130d39ddcca90f",
  "path": "test/note.md",
  "content": "更新后的内容...",
  "size": 24,
  "content_sha256": "663ab3dd969f51ffd6565202a6a5006db76a96a09a3506962f8d442df8f9bd76",
  "version": 2,
  "metadata": {
    "source": "meeting"
  },
  "created_at": "2026-05-18T15:34:26.494349Z",
  "updated_at": "2026-05-18T15:34:37.780345Z"
}

​

响应字段

字段	类型	说明
id	string	Memory entry ID，前缀为 mem_
type	string	固定值 "memory"
store_id	string	所属 Memory Store ID
path	string	相对 memory 路径；该接口不会修改 path
content	string	更新后的内容
size	integer	新内容大小，单位 byte
content_sha256	string	新内容的 SHA-256 摘要
version	integer	递增后的 entry 版本
metadata	Metadata 对象	更新后的当前 metadata
created_at	string	UTC 创建时间
updated_at	string	UTC 更新时间

​

注意事项

• 该接口不能修改 path。
• size 和 content_sha256 会根据 content 重新计算。
• 如需清空 metadata，传入空对象："metadata": {}。

​

错误码

HTTP	type	触发条件
400	invalid_request_error	content 为空或超过 100 KB，或 metadata 非法
401	authentication_error	缺少或无效的认证令牌
404	not_found_error	指定的 Memory Store 或 active memory entry 不存在
409	conflict_error	Store 已归档，或 content_sha256 与当前 entry 哈希不一致

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

​

相关

Memory Stores

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