Skip to main content
DELETE
/
v1
/
memories
/
{id}
Delete Memories
curl --request DELETE \
  --url https://api.memoclaw.com/v1/memories/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": [
    "<string>"
  ]
}
'
{
  "deleted": 123,
  "id": "<string>",
  "errors": [
    {}
  ]
}
This endpoint requires wallet authentication for identity. It is free — no payment required.
Price: FREE

​
Path Parameters

​
id
string
required
UUID of the memory to delete.

​
Response (200)

​
deleted
boolean
Always true.
​
id
string
The deleted memory’s UUID.
Deletion is soft — it sets deleted_at on the record. Deleted memories are excluded from all queries (recall, list). This allows future recovery if needed.

​
Errors

StatusDescription
404Memory not found (or already deleted, or belongs to another wallet).
409Memory is immutable and cannot be deleted.
422Invalid UUID format.

​
Example

curl -X DELETE https://api.memoclaw.com/v1/memories/550e8400-e29b-41d4-a716-446655440000
Response
{
  "deleted": true,
  "id": "550e8400-e29b-41d4-a716-446655440000"
}

​
Bulk Delete — DELETE /v1/memories

Delete multiple memories in a single request. Also free. Price: FREE

​
Request Body

​
ids
string[]
required
Array of memory UUIDs to delete (max 100).

​
Response (200)

​
deleted
number
Number of memories successfully deleted.
​
errors
array
Array of IDs that could not be deleted (not found, immutable, or wrong wallet), if any.

​
Example

curl -X DELETE https://api.memoclaw.com/v1/memories \
  -H "Content-Type: application/json" \
  -H "x-wallet-auth: 0xYourWallet:1699900000:0xSignature..." \
  -d '{"ids": ["id-1", "id-2", "id-3"]}'
Response
{
  "deleted": 3,
  "errors": []
}

​
Errors

StatusDescription
422ids is missing, empty, or exceeds 100 items.