Delete Memory

DELETE /memory/

Delete a specific memory by its unique identifier.

Path Parameters

string

required

The unique identifier of the memory to delete.

Response

boolean

Indicates whether the operation was successful.

object

Confirmation of the deletion operation.

Show Result Object

string

Confirmation message about the deletion.

Example Request

curl -X DELETE http://localhost:8000/memory/mem_abc123

Example Response

{
  "success": true,
  "result": {
    "message": "Memory deleted successfully"
  }
}

Error Responses

string

Error message describing what went wrong.

500 Internal Server Error

{
  "detail": "Memory not found or deletion failed"
}

DELETE /memory/user/

Delete all memories for a specific user. This is a destructive operation that removes all stored memories associated with the user ID.

This operation is irreversible. All memories for the user will be permanently deleted.

Path Parameters

string

required

The unique identifier of the user whose memories should be deleted.

Response

boolean

Indicates whether the operation was successful.

object

Confirmation of the deletion operation.

Show Result Object

string

Confirmation message about the deletion.

integer

Number of memories deleted.

Example Request

curl -X DELETE http://localhost:8000/memory/user/user_123

Example Response

{
  "success": true,
  "result": {
    "message": "All memories deleted successfully",
    "deleted_count": 42
  }
}

Use Cases

User Account Deletion When a user deletes their account, remove all their memories:

curl -X DELETE http://localhost:8000/memory/user/user_123

Privacy Compliance Handle GDPR “right to be forgotten” requests:

curl -X DELETE http://localhost:8000/memory/user/user_456

Testing & Development Clear test data between test runs:

curl -X DELETE http://localhost:8000/memory/user/test_user_001

Selective Deletion

Currently, the API doesn’t support selective deletion by memory type (e.g., delete only SHORT_TERM memories). To achieve this, you would need to:

Search for memories with the specific type filter
Delete each memory individually using /memory/{memory_id}

Example: Delete All Short-Term Memories

# Step 1: Get all SHORT_TERM memories
curl -X POST http://localhost:8000/memory/get_all \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "user_123",
    "memory_type": "SHORT_TERM"
  }'

# Step 2: Delete each memory ID from the response
curl -X DELETE http://localhost:8000/memory/mem_abc123
curl -X DELETE http://localhost:8000/memory/mem_def456
# ... etc

Error Responses

500 Internal Server Error

{
  "detail": "Failed to delete memories"
}

Common Error Scenarios

Invalid Memory ID: The provided memory doesn’t exist (single delete)
User Not Found: No memories found for the user ID (user delete)
Database Connection: Failure to connect to the vector store
Partial Deletion: Some memories deleted but operation failed partway through

Implementation Details

Single Delete Source: backend/main.py:332
User Delete Source: backend/main.py:344
Cascade Deletion: Removes vectors from Supabase and relationships from Neo4j (if enabled)
Atomic Operations: Single deletes are atomic; user deletes may be partial on errors

Memory API

Backend API

Electron IPC

DELETE /memory/

Path Parameters

Response

Example Request

Example Response

Error Responses

DELETE /memory/user/

Path Parameters

Response

Example Request

Example Response

Use Cases

Selective Deletion

Error Responses

Implementation Details

​DELETE /memory/

​Path Parameters

​Response

​Example Request

​Example Response

​Error Responses

​DELETE /memory/user/

​Path Parameters

​Response

​Example Request

​Example Response

​Use Cases

​Selective Deletion

​Error Responses

​Implementation Details

DELETE /memory/

Path Parameters

Response

Example Request

Example Response

Error Responses

DELETE /memory/user/

Path Parameters

Response

Example Request

Example Response

Use Cases

Selective Deletion

Error Responses

Implementation Details