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.

Delete request
{
  "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.