跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.qoder.com/llms.txt

Use this file to discover all available pages before exploring further.

PUT /v1/memory_stores/{memory_store_id}/memories/{memory_id} 更新指定记忆条目的内容。每次更新会自动递增版本号并生成版本记录。

请求头

头部必选说明
AuthorizationBearer <PAT>
Content-Typeapplication/json

路径参数

参数类型必选说明
memory_store_idstringMemory Store ID(memstore_ 前缀)
memory_idstring记忆条目 ID(mem_ 前缀)

请求体

字段类型必选说明
contentstring新的记忆内容

示例请求

curl -X PUT "https://openapi.qoder.sh/api/v1/cloud/memory_stores/memstore_xxx/memories/mem_xxx" \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "更新后的内容..."
  }'

示例响应

HTTP 200 OK
{
  "id": "mem_019e3bb965a671fca51bde1cf8d87de0",
  "type": "memory",
  "store_id": "memstore_019e3bb93b7074f9a5130d39ddcca90f",
  "path": "test/note.md",
  "content": "Hello world - updated content",
  "size": 29,
  "content_sha256": "663ab3dd969f51ffd6565202a6a5006db76a96a09a3506962f8d442df8f9bd76",
  "version": 2,
  "metadata": {},
  "created_at": "2026-05-18T15:34:26.494349Z",
  "updated_at": "2026-05-18T15:34:37.780345Z"
}

响应字段

字段类型说明
idstring唯一标识符
typestring固定值 "memory"
store_idstring所属 Store ID
pathstring相对路径(不变)
contentstring更新后的内容
sizeint64新内容大小(字节)
content_sha256string新内容的 SHA-256 哈希
versionint64递增后的版本号
metadataobject自定义元数据
created_atstring原始创建时间(不变)
updated_atstring更新时间(ISO 8601)

错误码

HTTPtype触发条件
401authentication_error未提供或无效的认证令牌
404not_found_error指定的 Memory Store 或记忆条目不存在

注意事项

  • 每次更新 version 自动递增(如从 1 变为 2)
  • created_at 保持不变,updated_at 更新为当前时间
  • sizecontent_sha256 根据新内容重新计算
  • 每次更新会生成一条 action: "updated" 的版本记录
  • path 在更新时不可修改
完整错误信封说明详见 错误参考