> ## Documentation Index
> Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Forgetting

> Delete a whole Agent Memory profile with forget, or forget one session by deleting its source; single-memory deletion is not yet available.

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.

```bash theme={null}
curl -X DELETE "https://api.telnyx.com/v2/ai/memory/namespaces/default/profiles/caller:+13128675309" \
  -H "Authorization: Bearer $TELNYX_API_KEY"
```

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.

<Warning>
  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.
</Warning>

### After Forgetting

The `200` returns a report of what was removed (a report, not a strict audit):

```json theme={null}
{ "data": { "profile_id": "caller:+13128675309", "memories_deleted": 42 } }
```

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`](/docs/agent-memory/writing#ingest-a-session) or [`remember`](/docs/agent-memory/writing#remember-a-fact) re-creates the profile with fresh memories.

## Forget One Session

A session is forgotten through its **source**, on the [Sources](/docs/agent-memory/sources#forget-one-source) 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=`](/docs/agent-memory/sources#find-one-sessions-source). 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:

```json theme={null}
{ "data": { "profile_id": "caller:+13128675309", "source_id": "cf86263c-…", "memories_deleted": 2 } }
```

Afterward the source `404`s 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.

<Note>
  You can forget a whole profile (here) or one session, by [its source](/docs/agent-memory/sources#forget-one-source). Forgetting a single **memory** is not yet available.
</Note>

## Related

* [Sources](/docs/agent-memory/sources) -- forget one session by deleting its source
* [Writing memories](/docs/agent-memory/writing) -- how memories get in
* [Recalling memories](/docs/agent-memory/recall) -- reading a profile whole