Delete Memory
curl --request DELETE \
--url https://api.recallrai.com/api/v1/users/{custom_user_id}/memory/{memory_id} \
--header 'X-Recallr-Api-Key: <x-recallr-api-key>' \
--header 'X-Recallr-Project-Id: <x-recallr-project-id>'{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Memories
Delete Memory
Delete any version in the memory version history.
Path Parameters:
custom_user_id(str): Unique identifier for the usermemory_id(str): Memory UUID (can be any version in the chain)
Query Parameters:
delete_all_versions(bool): Delete this version + all previous (true) or just this version (false). Default: false
Returns:
- HTTP 204 No Content on success
Deletion Modes:
Mode 1: Single Version Deletion (delete_all_versions=false, default)
- Deletes only the specified version (can be any version in the chain)
- If deleting latest version: previous version becomes new latest (resurrected)
- If deleting middle version: next version links to previous version (relinks chain)
- If deleting first version with no next: complete deletion
- Connections on latest version are preserved/transferred appropriately
Mode 2: Delete Version + All Previous (delete_all_versions=true)
- Deletes the specified version AND all its previous versions
- If deleting latest: deletes entire history
- If deleting middle version N: deletes N and all versions before it (N-1, N-2, etc.)
- Version N+1 becomes orphaned (prev_version_id = None)
Examples:
Chain: v1 ← v2 ← v3 ← v4 (latest)
Delete v4 (latest) with delete_all_versions=false:
Result: v1 ← v2 ← v3 (latest, resurrected)
Delete v2 (middle) with delete_all_versions=false:
Result: v1 ← v3 ← v4 (latest) [v2 removed from chain]
Delete v2 (middle) with delete_all_versions=true:
Result: v3 ← v4 (latest) [v1 and v2 deleted, v3 orphaned]
DELETE
/
api
/
v1
/
users
/
{custom_user_id}
/
memory
/
{memory_id}
Delete Memory
curl --request DELETE \
--url https://api.recallrai.com/api/v1/users/{custom_user_id}/memory/{memory_id} \
--header 'X-Recallr-Api-Key: <x-recallr-api-key>' \
--header 'X-Recallr-Project-Id: <x-recallr-project-id>'{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Documentation Index
Fetch the complete documentation index at: https://docs.recallrai.com/llms.txt
Use this file to discover all available pages before exploring further.
Query Parameters
Delete entire version history (true) or just current version (false)
Response
Memory deleted successfully
Was this page helpful?
⌘I