Memory Store

更新 Memory

修改记忆正文、重命名或条件更新

POST

/api/v1/agentstudio/memory_stores/{memory_store_id}/memories/{memory_id}

cURL

curl --request POST \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/memory_stores/{memory_store_id}/memories/{memory_id}' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": "# 项目约定\n默认开发环境为预发环境。\n变更需要补充回归测试。\n",
  "precondition": {
    "type": "content_sha256",
    "content_sha256": "e3b0c44b98fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
  }
}
'

{
  "id": "mem_xxx",
  "type": "memory",
  "memory_store_id": "memstore_xxx",
  "path": "/notes/project.md",
  "content_sha256": "e3b0c44b98fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "content_size_bytes": 47,
  "memory_version_id": "memver_yyy",
  "created_at": "2026-09-17T08:00:00Z",
  "updated_at": "2026-09-17T08:30:00Z"
}

Authorizations

string

header

required

DashScope API Key

Path Parameters

string

required

记忆库 ID

string

required

记忆 ID

Body

application/json

string

新路径（重命名），规则与创建一致；记忆 ID 保持不变

string

新正文，最大 102400 UTF-8 bytes

object

可选的乐观锁：携带读取时的 content_sha256，内容已被修改时返回冲突

Show child attributes

enum<string>

Available options:content_sha256

string

期望的当前正文 SHA256

Response

200-application/json

string

记忆 ID，格式 mem_xxx

string

固定为 memory

string

所属记忆库 ID

string

记忆库内路径，以 / 开头

string

正文的 SHA256 哈希，可用作条件更新的乐观锁

integer

正文的 UTF-8 字节数

string

当前版本 ID，格式 memver_xxx

string

创建时间，ISO 8601 UTC

string

最近更新时间，ISO 8601 UTC

cURL

curl --request POST \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/memory_stores/{memory_store_id}/memories/{memory_id}' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": "# 项目约定\n默认开发环境为预发环境。\n变更需要补充回归测试。\n",
  "precondition": {
    "type": "content_sha256",
    "content_sha256": "e3b0c44b98fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
  }
}
'

{
  "id": "mem_xxx",
  "type": "memory",
  "memory_store_id": "memstore_xxx",
  "path": "/notes/project.md",
  "content_sha256": "e3b0c44b98fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "content_size_bytes": 47,
  "memory_version_id": "memver_yyy",
  "created_at": "2026-09-17T08:00:00Z",
  "updated_at": "2026-09-17T08:30:00Z"
}