# Mem0 Cloud - Delete Memories

> Mem0 Cloud - Delete Memories is a paid API for AI agents from mem0-cloud.saastemly.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-31).

Deletes one specific memory by ID or up to 200 memories matching a given entity scope (user, agent, app, or run), authenticated by a secret memory key.

## Facts

- Endpoint: GET https://mem0-cloud.saastemly.com/v1/memories?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mem0-cloud-delete-memories-05e74893
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZsMO61-okwiBs65vUA3-k

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability mem0-cloud-delete-memories-05e74893
```

Example prompt: Delete all the memories stored under my agent 'assistant-v2' — my memory key is mk_abc123xyz789defgh456, and the agent_id is 'assistant-v2'. Let me know if more than 200 remain after this.

## When to prefer this

Use this endpoint when you need to remove stored memories from Mem0 Cloud — either a single known memory by its UUID or a scoped bulk deletion for a user, agent, app, or run. Choose this over alternatives when you are already using the Mem0 Cloud sibling endpoints (add/store and search) and need lifecycle management of stored memories. The secret memory_key architecture ensures only the owner can delete, making this suitable for multi-tenant agent deployments where memory isolation is critical.

## Known failure modes

- 404 Not Found: specified memory_id does not exist or belongs to a different memory key
- 400 Bad Request: neither memory_id nor at least one of user_id/agent_id/app_id/run_id provided for bulk delete
- 400 Bad Request: memory_key missing or malformed (not 16-256 characters)
- Partial deletion: up to 200 memories deleted per call; endpoint signals if more remain, requiring additional calls
- No memories found matching the provided entity scope: no-op, zero deletions

## How this service works

Read your stored memories, like mem0's get memory and get all memories. With memory_id: returns that one memory (404 if it is not yours). Without it: returns a page {count, next, previous, results} of the memories matching user_id, agent_id, app_id or run_id (at least one; "*" matches any value), newest first. Requires your memory_key (a secret string you generate): a different key sees nothing.

## Output

Returns a confirmation that the memory or memories were deleted. For bulk deletes (no memory_id), also indicates whether more than 200 matching memories remain. Returns a 404 error if a specific memory_id is not found or does not belong to the provided memory key.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "memory_key"
     ],
     "properties": {
      "page": {
       "type": "integer",
       "description": "Page number, from 1 (default 1)"
      },
      "app_id": {
       "type": "string",
       "description": "Entity: the app (1-128 characters)"
      },
      "run_id": {
       "type": "string",
       "description": "Entity: the session or run (1-128 characters)"
      },
      "user_id": {
       "type": "string",
       "description": "Entity: the user the memories are about (1-128 characters)"
      },
      "agent_id": {
       "type": "string",
       "description": "Entity: the agent the memories belong to (1-128 characters)"
      },
      "memory_id": {
       "type": "string",
       "description": "UUID of one memory to fetch; leave out to list memories instead"
      },
      "page_size": {
       "type": "integer",
       "description": "Memories per page, 1-100 (default 50)"
      },
      "memory_key": {
       "type": "string",
       "description": "Your secret: a random string of 16-256 characters that you generate once and keep (also accepted as the X-Memory-Key header). Memories are stored and searched only under its hash, so nobody who lacks it can read them, whatever user_id they send. Lose it and the memories are unreachable."
      },
      "show_expired": {
       "type": "boolean",
       "description": "Include memories whose expiration_date has passed (default false)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mem0-cloud-delete-memories-05e74893/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mem0-cloud.saastemly.com](https://www.zero.xyz/host/mem0-cloud.saastemly.com/llms.txt)