更新 Memory Store API：POST /memory_stores/{memory_store_id}-大模型服务平台百炼(Model Studio)-阿里云帮助中心

更新记忆库的名称、描述与元数据。

前提

已完成 Endpoint 与鉴权配置，详见API 总览与认证。

接口

POST /memory_stores/{memory_store_id}

路径参数

参数	必填	类型	说明
`memory_store_id`	是	string	记忆库 ID

请求体

字段	必填	类型	说明
`name`	否	string	新的名称，1-255 字符
`description`	否	string	新的用途说明
`metadata`	否	object	新的业务自定义键值对元数据

请求示例

bash

curl -X POST "$AGENTSTUDIO_URL/memory_stores/memstore_xxx" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"name": "项目知识库","description": "项目约定与决策记录"}'

响应

{
  "id": "memstore_xxx",
  "type": "memory_store",
  "name": "项目知识库",
  "description": "项目约定与决策记录",
  "metadata": {
    "team": "data"
  },
  "created_at": "2026-09-17T08:00:00Z",
  "updated_at": "2026-09-17T08:00:00Z"
}

响应字段

字段	类型	说明
`id`	string	记忆库 ID，格式 memstore_xxx
`type`	string	固定为 memory_store
`name`	string	记忆库名称，1-255 字符
`description`	string	用途说明；未填写时为空字符串
`metadata`	object	业务自定义键值对元数据
`archived_at`	string \| null	归档时间，未归档时省略或为 null
`created_at`	string	创建时间，ISO 8601 UTC
`updated_at`	string	最近更新时间，ISO 8601 UTC

错误码

状态码	错误码	说明
400	`invalid_request_error`	参数、路径、limit 或分页游标非法
401	`InvalidApiKey`	API Key 缺失、错误或失效
403	`permission_error`	身份或资源访问权限不足
404	`not_found_error`	资源不存在或不属于当前工作空间
409	`memory_path_conflict_error` 等	路径冲突、条件更新冲突或对已归档记忆库写入