Retract a memory
POST/v1/projects/:project_id/memories/:memory_id/retract
Retires a fact that stopped holding with nothing replacing it. The memory leaves the default listing, knowledge search and write deduplication, so restating the fact later lands as a new memory.
It is an invalidation with no successor, which is what tells it apart from a supersede: invalidated_at is set and superseded_by_memory_id stays null. The retraction is appended to the assertion ledger with outcome retracted, so who withdrew the fact is part of the record.
The memory stays readable by id, with its text and its assertions. DELETE remains the way to remove it outright.
Request
Responses
- 200
- 401
- 403
- 404
- 409
- 500
The retracted memory
Unauthorized
Forbidden
Memory store or memory not found
The memory is already invalidated (MEMORY_ALREADY_INVALIDATED), or it has moved past the version this write read (VERSION_CONFLICT, with meta.current_version).
Internal server error