Skip to main content

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—
Factual memory 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-rerank-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/memory_nodes/search \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "user_id": "user_001",
    "messages": [{"role": "user", "content": "What do I need to do?"}],
    "top_k": 10,
    "min_score": 0.3,
    "plan_version": "pro"
  }'

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 '{
    "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.
Agent Development
Agent Context
Agent Governance & Evolution
Store
Application Marketplace