Skip to main content
Anything that stores what a person said needs a way to unsay it — a customer who asks to be forgotten, a profile created against the wrong id. Agent Memory answers that with forget.

​
Forget a Profile

DELETE /namespaces/{ns}/profiles/{profile_id} forgets everything held about one profile — every memory, and the profile’s summary with it.
This is the route that answers a right-to-erasure request. A 2xx means none of that profile’s memories remain, and there is no undo.
This endpoint takes no parameters and always deletes the whole profile. It does not accept a session_id — a stray one is ignored, not refused, so a request meant to forget one session would erase the entire profile. To forget one session, use its source (below), never this route.

​
After Forgetting

The 200 returns a report of what was removed (a report, not a strict audit):
Once forgotten, a profile is indistinguishable from one that was never written:
  • It drops out of GET …/profiles, which only lists profiles that currently hold memories.
  • GET …/profiles/{id}/memories and GET …/profiles/{id}/sources return an empty 200, not a 404 — the same as any never-written profile.
  • There is no tombstone and no soft-delete, and no undo.
  • The id stays reusable: the next ingest or remember re-creates the profile with fresh memories.

​
Forget One Session

A session is forgotten through its source, on the Sources page — DELETE …/profiles/{id}/sources/{source_id}. Use the source_id from the ingest 202, or look it up first with GET …/sources?session_id=. This forgets that one session and the memories derived from it, leaving the rest of the profile intact. The 200 returns the same kind of report, scoped to the source:
Afterward the source 404s on a direct GET. But source ids are deterministic — derived from the profile and the session (or, for a remembered fact, its text) — so re-ingesting the same session re-creates the source under the same id, and that 404 becomes a 200 again. The profile’s other sources and their memories are untouched.
You can forget a whole profile (here) or one session, by its source. Forgetting a single memory is not yet available.