List Memory

Lists memory nodes for a specified sub-user with pagination. You can filter the results by memory library and project.

Method and endpoint

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

Request parameters

Parameter	Type	Required	Location	Description
`user_id`	string	Yes	Query	Sub-user ID used to isolate memories
`memory_library_id`	string	No	Query	Memory library ID
`project_id`	string	No	Query	Project ID
`page_num`	integer	No	Query	Page number. Default: `1`
`page_size`	integer	No	Query	Number of entries per page. Default: `10`

Response

Field	Type	Description
`request_id`	string	Request ID
`memory_nodes`	array	Memory nodes
`memory_nodes[].memory_node_id`	string	Memory node ID
`memory_nodes[].content`	string	Memory content
`memory_nodes[].timestamp`	integer	Message timestamp
`memory_nodes[].created_at`	integer	Creation time
`memory_nodes[].updated_at`	integer	Update time
`memory_nodes[].media_desc`	string	Multimodal content description
`memory_nodes[].meta_data`	object	Custom metadata
`memory_nodes[].project_id`	string	Project ID specified when the memory was added or updated. It may be empty
`memory_nodes[].memory_type`	string	Memory node type
`memory_nodes[].status`	string	Memory node status
`memory_nodes[].multimodal_medias`	array	Multimodal resources. Returned when present
`page_num`	integer	Current page number
`page_size`	integer	Number of entries per page
`total`	integer	Total number of memory nodes

Request example

curl --location 'https://dashscope.aliyuncs.com/api/v2/apps/memory/memory_nodes?user_id=user_001&memory_library_id=memory_library_001&project_id=project_001&page_size=10&page_num=1' \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY"

Response example

{
  "request_id": "c04d36e2-8fe8-9aad-b7ae-be40d5852c35",
  "memory_nodes": [
    {
      "memory_node_id": "4fe7ea3b791a4453b5e1d117da6b7483",
      "content": "The user is traveling to Shanghai by car the day after tomorrow and needs to bring an ID card",
      "timestamp": 1781765684,
      "created_at": 1781765715,
      "updated_at": 1781765715,
      "media_desc": "",
      "meta_data": {},
      "project_id": "project_001",
      "memory_type": "observation",
      "status": "valid",
      "multimodal_medias": []
    }
  ],
  "page_num": 1,
  "page_size": 10,
  "total": 1
}

To modify a memory, use Update Memory.

​Method and endpoint

​Request parameters

​Response

​Request example

​Response example

Method and endpoint

Request parameters

Response

Request example

Response example