API
POST /memory/delete
Delete removes a memory from retrieval surfaces and records an audit trail for reconstruction.
Delete contract
Deletion is sent as a POST request identifying the memory by `memory_id` and scope context. The engine removes vector/lexical references and writes a deletion-log record for audits.
For fact memories, delete may trigger slot repair to recover latest valid predecessor.
{
"memory_id": "user-123::chat-82::42",
"reason": "user_requested_erasure"
}Safety guidance
- Require authorization stronger than read-only keys.
- Keep immutable delete audit logs.
- Return idempotent success for already-deleted IDs.
- Run periodic consistency checks across all indexes.
Verification
After delete, query the same prompt and confirm memory is absent from results. For fact deletes, verify current fact slot points to expected fallback record.