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>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Memories

Delete Memory

Delete any version in the memory version history.

Path Parameters:

custom_user_id (str): Unique identifier for the user
memory_id (str): Memory UUID (can be any version in the chain)

Query Parameters:

delete_previous_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_previous_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_previous_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_previous_versions=false:
    Result: v1 ← v2 ← v3 (latest, resurrected)

Delete v2 (middle) with delete_previous_versions=false:
    Result: v1 ← v3 ← v4 (latest) [v2 removed from chain]

Delete v2 (middle) with delete_previous_versions=true:
    Result: v3 ← v4 (latest) [v1 and v2 deleted, v3 orphaned]

DELETE

api

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>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Headers

X-Recallr-Project-Id

string<uuid>

required

X-Recallr-Api-Key

string

required

Path Parameters

custom_user_id

string

required

memory_id

string

required

Query Parameters

delete_previous_versions

boolean

default:false

Delete this version and all previous versions (true) or just this version (false)

Response

Memory deleted successfully

Get Memory Get System Prompt