--- title: Delete Memory description: Remove memories from Mem0 either individually, in bulk, or via filters. icon: "trash" iconType: "solid" --- # Remove Memories Safely Deleting memories is how you honor compliance requests, undo bad data, or clean up expired sessions. Mem0 lets you delete a specific memory, a list of IDs, or everything that matches a filter. **Why it matters** - Satisfies user erasure (GDPR/CCPA) without touching the rest of your data. - Keeps knowledge bases accurate by removing stale or incorrect facts. - Works for both the managed Platform API and the OSS SDK. ## Key terms - **memory_id** – Unique ID returned by `add`/`search` identifying the record to delete. - **batch_delete** – API call that removes up to 1000 memories in one request. - **delete_all** – Filter-based deletion by user, agent, run, or metadata. - **immutable** – Flagged memories that cannot be updated; delete + re-add instead. ## How the delete flow works Decide whether you’re removing a single memory, a list, or everything that matches a filter. Call `delete`, `batch_delete`, or `delete_all` with the required IDs or filters. Confirm the response message, then re-run `search` or check the dashboard/logs to ensure the memory is gone. ## Delete a single memory (Platform) ```python Python from mem0 import MemoryClient client = MemoryClient(api_key="your-api-key") memory_id = "your_memory_id" client.delete(memory_id=memory_id) ``` ```javascript JavaScript import MemoryClient from 'mem0ai'; const client = new MemoryClient({ apiKey: "your-api-key" }); client.delete("your_memory_id") .then(result => console.log(result)) .catch(error => console.error(error)); ``` You’ll receive a confirmation payload. The dashboard reflects the removal within seconds. ## Batch delete multiple memories (Platform) ```python Python from mem0 import MemoryClient client = MemoryClient(api_key="your-api-key") delete_memories = [ {"memory_id": "id1"}, {"memory_id": "id2"} ] response = client.batch_delete(delete_memories) print(response) ``` ```javascript JavaScript import MemoryClient from 'mem0ai'; const client = new MemoryClient({ apiKey: "your-api-key" }); const deleteMemories = [ { memory_id: "id1" }, { memory_id: "id2" } ]; client.batchDelete(deleteMemories) .then(response => console.log('Batch delete response:', response)) .catch(error => console.error(error)); ``` ## Delete memories by filter (Platform) ```python Python from mem0 import MemoryClient client = MemoryClient(api_key="your-api-key") # Delete all memories for a specific user client.delete_all(user_id="alice") ``` ```javascript JavaScript import MemoryClient from 'mem0ai'; const client = new MemoryClient({ apiKey: "your-api-key" }); client.deleteAll({ user_id: "alice" }) .then(result => console.log(result)) .catch(error => console.error(error)); ``` You can also filter by other parameters such as: - `agent_id` - `run_id` - `metadata` (as JSON string) `delete_all` requires at least one filter (user, agent, run, or metadata). Calling it with no filters raises an error to prevent accidental data loss. ## Delete with Mem0 OSS ```python Python from mem0 import Memory memory = Memory() memory.delete(memory_id="mem_123") memory.delete_all(user_id="alice") ``` The OSS JavaScript SDK does not yet expose deletion helpers—use the REST API or Python SDK when self-hosting. ## Use cases recap - Forget a user’s preferences at their request. - Remove outdated or incorrect facts before they spread. - Clean up memories after session expiration or retention deadlines. - Comply with privacy legislation (GDPR, CCPA) and internal policies. **MCP Alternative**: With Mem0 MCP, AI agents can delete their own memories when data becomes irrelevant or at user request. ## Method comparison | Method | Use when | IDs required | Filters | | --- | --- | --- | --- | | `delete(memory_id)` | You know the exact record | ✔️ | ✖️ | | `batch_delete([...])` | You have a list of IDs to purge | ✔️ | ✖️ | | `delete_all(...)` | You need to forget a user/agent/run | ✖️ | ✔️ | ## Put it into practice - Review the Delete Memory API reference, plus Batch Delete and Filtered Delete. - Pair deletes with Expiration Policies to automate retention. ## See it live - Support Inbox with Mem0 demonstrates compliance-driven deletes. - Data Management tooling shows how deletes fit into broader lifecycle flows. {/* DEBUG: verify CTA targets */}