更新 Memory Store

修改 Memory Store 的 name、description 或 metadata。部分更新语义：未传入的字段保持不变，传入 null 会被拒绝。

路径

POST /api/v1/forward/memory_stores/{memory_store_id}

请求头

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

路径参数

参数	类型	必选	说明
`memory_store_id`	string	是	Memory Store ID（`memstore_...`）。

请求体

字段	类型	必选	说明
`name`	string	否	新名称。传入时非空且不含非打印控制字符。
`description`	string	否	新描述。传入时不含非打印控制字符。
`metadata`	object	否	新元数据，整体替换当前 metadata（非合并）。约束详见 Store metadata 约束。

请求体必须至少包含上述一个字段。

示例请求

curl -X POST "https://api.qoder.com/api/v1/forward/memory_stores/memstore_00mc7mukn7lkxr454tjd" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Alpha 项目 v2 知识库"
  }'

示例响应

HTTP 200 OK

{
  "id": "memstore_00mc7mukn7lkxr454tjd",
  "type": "memory_store",
  "name": "project-alpha-memory",
  "description": "Alpha 项目 v2 知识库",
  "status": "active",
  "entry_count": 12,
  "total_size": 4096,
  "metadata": {"created_by": "forward", "team": "backend"},
  "system_managed": false,
  "identity_id": null,
  "created_at": "2026-08-14T10:00:00Z",
  "updated_at": "2026-08-14T10:15:00Z",
  "archived_at": null,
  "binding_info": {"identity_template_count": 1}
}

响应字段解释

返回 Memory Store 对象。

错误码

HTTP	type	触发条件
400	`invalid_request_error`	请求体非法（未提供任何字段、`name` 空串、含控制字符，或 metadata 违规）。
401	`authentication_error`	缺少或无效的认证令牌。
403	`permission_error`	当前调用方无权访问该资源。
404	`not_found_error`	Store 不存在或跨用户不可见。
409	`conflict_error`	Store 已归档，禁止修改。
500/502/503	`api_error`	Forward 或依赖服务失败。

​路径

​请求头

​路径参数

​请求体

​示例请求

​示例响应

​响应字段解释

​错误码

路径

请求头

路径参数

请求体

示例请求

示例响应

响应字段解释

错误码