Update 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

​Prerequisites

​Endpoint

​Path parameters

​Request body

​Request example

​Response example

​Response fields

​Error codes

Prerequisites

Endpoint

Path parameters

Request body

Request example

Response example

Response fields

Error codes