forget
Retire a memory by ID to remove it from recall, with modes for routine cleanup or factual corrections that preserve audit history and correction links.
Instructions
Retire one specific memory by id. Mutating: tombstones the memory (a soft delete that preserves audit history), so it stops surfacing in recall; it is not a hard delete. Set mode='correct' when retiring a memory because it is WRONG (e.g. a surfaced/recalled fact the user contradicted), as opposed to routine cleanup: this records a distinct correct event with the memory's provenance, and if you pass corrected_by (the id of the memory holding the right answer) it also records a contradicts link. Use mode='correct' for factual corrections so the signal is captured explicitly rather than inferred later.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | tombstone (default) for routine cleanup; correct when the memory was factually wrong (records a correction signal). | |
| reason | No | Why the memory is being retired (recorded in the audit trail). | |
| dry_run | No | If true, validate without retiring. Default false. | |
| memory_id | Yes | Id of the memory to retire. Required. | |
| corrected_by | No | With mode='correct', the id of the memory holding the right answer (records a contradicts link). |