Overview

Through the Memory API, you can programmatically write memories, search memories, and manage profile templates. All endpoints are served via the DashScope gateway.

Service address

https://dashscope.aliyuncs.com/api/v2/apps/memory/

All endpoints use the same base URL. Append the path shown on each API page to the base URL. For example, /add corresponds to https://dashscope.aliyuncs.com/api/v2/apps/memory/add.

Protocol

All endpoints use HTTPS only
Request and response bodies are JSON in UTF-8
Write and search use POST; list uses GET; update uses PATCH; delete uses DELETE

Common headers

Header	Required	Description
`Authorization`	Yes	`Bearer $DASHSCOPE_API_KEY`, see Authentication
`Content-Type`	Only for endpoints with a request body	`application/json`

Response format

The only common field in successful responses is request_id. Other business fields vary by API. See the corresponding API page for details. Success:

{
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Error:

{
  "code": "InvalidParameter",
  "message": "user_id is required",
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Provide request_id when contacting support for faster resolution. See Error codes.

Pagination

List endpoints support pagination:

Parameter	Description
`page_size`	Page size
`page_num`	Page number, starting from 1

Memory begins commercial billing on August 20, 2026. Add and Search calls distinguish Pro and Lite plan versions. See Billing.

View AddMemory to start.

​Service address

​Protocol

​Common headers

​Response format

​Pagination

Service address

Protocol

Common headers

Response format

Pagination