Delete Memories

Soft-delete one or many memories by ID.

DELETE /v1/memories/{id}

Delete Memories

cURL

curl --request DELETE \
  --url https://api.memoclaw.com/v1/memories/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": [
    "<string>"
  ]
}
'

200

{
  "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

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

Example

curl

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

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

Status	Description
422	ids is missing, empty, or exceeds 100 items.