# forget

Entfernen oder bereinigen Sie einen bestimmten Speichereintrag für zukünftige Abrufe und hinterlassen Sie einen überprüfbaren Löschmarker (Tombstone).

- Canonical: https://docs.xmemo.dev/de/docs/tools/forget
- Locale: de-DE
- Content-Locale: de-DE
- Canonical-Content-Digest: bb7f8a7e884de0a466e30a2d8258aa343fb87510c0c9530b1bf1ab2166c17e21
- Edition-Digest: 551440a40b3323635136580ab34e79713e3aa48e92a688cd2a9a6c10a9630127
- Source-Revision: sha256:baae372498e8bb0029d0bb3dbb87a802d40981f421cdfa74d518c0c5e6352ed3

## Tool Reference: `forget`

### Purpose

Einen bestimmten Speichereintrag gezielt aus zukünftigen Abrufen entfernen oder bereinigen und einen nachvollziehbaren Löschbeleg hinterlassen.

### Parameters

- `memory_id` (string, optional): Eindeutige ID der zu entfernenden Erinnerung (z. B. mem_42).
- `target` (string, optional): Alternatives Ziel oder Pfad zur Identifikation der Erinnerung, falls memory_id nicht direkt vorliegt.
- `mode` (string, optional, default: soft): Löschmodus: soft_delete (inaktivieren, Standard) oder redact (Inhalt überschreiben/bereinigen).
- `reason` (string, optional): Optionaler Revisionsgrund für die Protokollierung des Löschvorgangs.

### Returns

Eine strukturierte Bestätigung mit dem Status der Löschung, der betroffenen memory_id, dem gewählten Modus und dem Auditnachweis. Zukünftige Abrufe ignorieren den Datensatz.

### Errors

- 401/403: Das MCP-Token fehlt oder gewährt nicht memory:write.
- 404: Die angegebene memory_id existiert nicht oder wurde bereits dauerhaft entfernt.
- Validierungsfehler: Ungültiger Löschmodus oder fehlender Bezeichner.
- Autorisierungsfehler: Keine Berechtigung zum Modifizieren der Zielerinnerung.
- Sicherheitskonflikt: Versuch, schreibgeschützte Systemeinträge zu löschen.

### Examples

#### Einen exakten Datensatz wiederherstellbar entfernen



```typescript
forget({
  target: "memory-id-from-recall",
  mode: "soft",
  reason: "User requested removal"
})
```

### Related Tools

- [search_memory](/docs/tools/search): Die exakte memory_id vor dem Löschen ermitteln.
- [remember](/docs/tools/remember): Eine korrigierte Fassung eines bereinigten Fakts speichern.
- [todos](/docs/tools/todos): Aufgabenstatus verwalten statt Speichereinträge zu löschen.
- [ledger](/docs/tools/ledger): Finanzielle Aufzeichnungen revisionssicher korrigieren.

## Eine Löschung überprüfen

Das forget-Tool bestätigt, dass der Datensatz als inaktiv markiert wurde; ein nachfolgender recall- oder search-Aufruf darf ihn nicht mehr zurückgeben.

```ts
search_memory({ query: "<the removed content>", limit: 5 })
// -> the removed entry must be absent
```