DELETE /memories — Wipe All Memories for a User Agent

The Wipe endpoint deletes every memory stored for a user_id + agent_id combination in a single request. You don’t need to enumerate individual memory IDs — Remem removes all of them atomically and returns the total count of deleted records. This is the right tool when you need a clean slate rather than a targeted removal.

This is irreversible. All memories for the specified user and agent are permanently deleted and cannot be recovered.

Endpoint: DELETE https://api.remem.online/memories

Request Headers

Name	Required	Description
`X-API-Key`	Yes	Your Remem API key

Query Parameters

string

required

Wipe all memories belonging to this user.

string

required

Wipe all memories belonging to this agent. Only memories that match both user_id and agent_id are removed.

Examples

curl -X DELETE \
  "https://api.remem.online/memories?\
user_id=user_123&agent_id=support_bot" \
  -H "X-API-Key: rm_live_xxx"

from remem import RememClient

client = RememClient(api_key="rm_live_xxx")

result = client.forget_all(
    user_id="user_123",
    agent_id="support_bot",
)

print(result.deleted)  # total number of memories removed
print(result.message)  # e.g. "Deleted 47 memories."

Response

200 — Success

{
  "deleted": 47,
  "message": "Deleted 47 memories."
}

integer

Total number of memories permanently removed for this user+agent pair.

string

Human-readable confirmation of the operation.

Error Responses

Code	Meaning	Fix
`401`	Invalid or missing API key	Verify your key is passed in the `X-API-Key` header
`422`	Missing required parameter	Both `user_id` and `agent_id` are required

Common Use Cases

GDPR right-to-erasure — when a user requests full deletion of their data, call this endpoint for each agent associated with their account.
Account resets — clear all stored context when a user resets their profile or preferences.
Testing and development — start fresh between test runs without manually deleting individual memories.

​Request Headers

​Query Parameters

​Examples

​Response

​200 — Success

​Error Responses

​Common Use Cases

Request Headers

Query Parameters

Examples

Response

200 — Success

Error Responses

Common Use Cases