epistemic_forget

Remove memories from the knowledge base permanently.

DELETE
epistemic_forget

Parameters

NameTypeRequiredDescription
idstringNo*Memory ID to delete.
querystringNo*Natural language query — deletes the best matching memory.
confirmbooleanNoMust be true for query-based deletion. Safety guard.

*One of id or query is required.

Example

By ID
{
  "tool": "epistemic_forget",
  "input": { "id": "mem_f8a2b1c3" }
}
By Query
{
  "tool": "epistemic_forget",
  "input": {
    "query": "user likes pho",
    "confirm": true
  }
}

Notes

  • Deletion is permanent and logged in the audit trail as a REVOKE event
  • Query-based deletion requires confirm: true to prevent accidental data loss
  • Only the owner can delete memories (enforced by policy)