Update Memory Store
Updated at:
Updates the name, description, and metadata of a memory store.
Prerequisites
Endpoint and authentication configured. For details, see Overview and authentication.
Endpoint
POST /memory_stores/{memory_store_id}
Path parameters
| Field | Required | Type | Description |
|---|---|---|---|
memory_store_id | Yes | string | Memory store ID |
Request body
| Field | Required | Type | Description |
|---|---|---|---|
name | No | string | New name, 1-255 characters |
description | No | string | New purpose description |
metadata | No | object | New custom key-value pairs for business metadata |
Request example
curl -X POST "$AGENTSTUDIO_URL/memory_stores/memstore_xxx" \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"name": "Project Knowledge","description": "项目约定与决策记录"}'
Response example
{
"id": "memstore_xxx",
"type": "memory_store",
"name": "Project Knowledge",
"description": "项目约定与决策记录",
"metadata": {
"team": "data"
},
"created_at": "2026-09-17T08:00:00Z",
"updated_at": "2026-09-17T08:00:00Z"
}
Response fields
| Field | Type | Description |
|---|---|---|
id | string | |
type | string | |
name | string | |
description | string | |
metadata | object | |
archived_at | string | null | |
created_at | string | |
updated_at | string |
Error codes
| HTTP status | Error code | Description |
|---|---|---|
| 400 | invalid_request_error | Invalid parameters, path, limit, or pagination cursor |
| 401 | InvalidApiKey | API key missing, invalid, or expired |
| 403 | permission_error | Insufficient identity or resource access permissions |
| 404 | not_found_error | Resource does not exist or does not belong to the current workspace |
| 409 | memory_path_conflict_error etc. | Path conflict, conditional update conflict, or writing to an archived store |
Is this page helpful?