Skip to main content
How-to Guide

Manage memories

View, search, update, and delete memories

After writing memories, view and search them in the console, or list, update, and delete via API. Use metadata (meta_data) to categorize memories for precise retrieval.

View memory details

In the memory details page's Memory details tab, the top shows memory stats. Below is the entity list — filter by entity ID (user_id). Click View to see details. List memories via API: 
curl -X GET "https://dashscope.aliyuncs.com/api/v2/apps/memory/memory_nodes?user_id=user_001&page_size=10&page_num=1" \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header "Content-Type: application/json"

Search debugging

In the memory details page's Memory search tab, debug retrieval to optimize recall accuracy.
ParameterDescriptionRecommendation
Entity IDThe user_id used when writing—
Fragment ruleSelect a specific rule to search—
Max resultsNumber of memories returned (1~100)As needed
Intent recallSystem judges if recall is needed, avoiding irrelevant searchesOn
RewriteOptimizes the query for better semantic searchOn for casual phrasing
RerankReranks results for relevanceOn for high relevance
Similarity threshold0.0~1.0, filters low-relevance results0.5~0.7
Rerank currently supports only the gte-rerink-v2 model. Too high a threshold may miss relevant memories; too low may introduce noise.
Search via API: 
curl -X POST https://dashscope.aliyuncs.com/api/v2/apps/memory/search \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "user_id": "user_001",
    "query": "What do I need to do?",
    "max_results": 10,
    "rewrite": true,
    "rerank": true,
    "similarity_threshold": 0.6
  }'

Update and delete memories

# Update memory
curl -X PATCH "https://dashscope.aliyuncs.com/api/v2/apps/memory/memory_nodes/{memory_node_id}" \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "user_id": "user_001",
    "custom_content": "Also remind me to take medicine at 10 AM."
  }'

# Delete memory
curl -X DELETE "https://dashscope.aliyuncs.com/api/v2/apps/memory/memory_nodes/{memory_node_id}" \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header "Content-Type: application/json"
For parameter details see API reference. For billing and limits see Billing & limits.
Getting Started
How-to Guide
Reference
Changelog