Delete Memory

1. Choose a Deletion Method

MemOS Cloud supports two deletion methods. Pass memory_ids[] to delete specific memories, or pass user_id to delete all memories for a user. Choose one based on your scenario.

2. Delete Specific Memories

Use specific-memory deletion when you need to remove a memory that was written incorrectly, is outdated, was assigned to the wrong user, or must be deleted at the user's request.

2.1 Find the Memory to Delete

When you call Search Memory or get memories and find a memory that should be deleted, copy the id of that memory. This value is the memory_id used for deletion.

{
  "memory_detail_list": [
    {
      "id": "e2a7c194-7062-4fa5-a6c0-bbe554d05d60",
      "memory_key": "User ice cream preference",
      "memory_value": "[user opinion] The user likes ice cream.",
      "memory_type": "WorkingMemory",
      "memory_time": null,
      "conversation_id": "0610",
      "status": "activated",
      "confidence": 0,
      "tags": [
        "food",
        "preference",
        "ice cream"
      ],
      "update_time": 1761315278665,
      "relativity": 0.7524414
    }
  ]
}

2.2 Call the Delete API

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://memos.memtensor.cn/api/openmem/v1"

data = {
  "memory_ids": ["6b23b583-f4c4-4a8f-b345-58d0c48fea04"]
}

res = requests.post(
  f"{BASE_URL}/delete/memory",
  headers={"Authorization": f"Token {API_KEY}"},
  json=data
)

print(res.json())

from memos.api.client import MemOSClient

client = MemOSClient(api_key="YOUR_API_KEY")

res = client.delete_memory(
  memory_ids=["6b23b583-f4c4-4a8f-b345-58d0c48fea04"]
)

print(res)

curl --request POST \
  --url https://memos.memtensor.cn/api/openmem/v1/delete/memory \
  --header 'Authorization: Token YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "memory_ids": ["6b23b583-f4c4-4a8f-b345-58d0c48fea04"]
  }'

2.3 Verify the Result

The API returns data.success: true when the delete request succeeds. After deletion, call Search Memory again to check whether the memory still appears.

{
  "code": 0,
  "data": {
    "success": true
  },
  "message": "ok"
}

3. Delete All Memories for a User

When you need to clear all memories for a user in the current project, pass user_id.

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://memos.memtensor.cn/api/openmem/v1"

data = {
  "user_id": "memos_user_123"
}

res = requests.post(
  f"{BASE_URL}/delete/memory",
  headers={"Authorization": f"Token {API_KEY}"},
  json=data
)

print(res.json())

from memos.api.client import MemOSClient

client = MemOSClient(api_key="YOUR_API_KEY")

res = client.delete_memory(user_id="memos_user_123")

print(res)

curl --request POST \
  --url https://memos.memtensor.cn/api/openmem/v1/delete/memory \
  --header 'Authorization: Token YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "user_id": "memos_user_123"
  }'

After deleting all memories for a user, search again with the same user_id for that user's previous facts or preferences to confirm that old memories are no longer returned.

4. Delete Memories in the Console

If you only need to delete one or a few memories temporarily, you can delete them directly in the console:

1. Log in to the MemOS Console and make sure the current project is the one you want to operate on.
2. Go to "Memory List" and use the search box, subject ID, subject type, or time range to find the target memory.
3. Click "View Details" and check the memory ID and memory content. Make sure it is not a similar memory under the same user.
4. Click "Delete" and confirm in the second confirmation dialog. To delete multiple memories, select multiple records first, then click "Batch Delete".
5. Refresh the list after deletion, or search again with the same conditions to confirm that the memory no longer appears.

5. Common Errors and Troubleshooting

For more error code details, see Error Codes.

Need the complete field list, request format, and response format? See the Delete Memory API documentation.