# forget

Supprimez un enregistrement vérifié de mémoire, de TODO ou de Ledger via la limite de contrôle détenue par l'utilisateur, avec une suppression réversible récupérable et une suppression définitive permanente.

- Canonical: https://docs.xmemo.dev/fr/docs/tools/forget
- Locale: fr-FR
- Content-Locale: fr-FR
- Canonical-Content-Digest: bb7f8a7e884de0a466e30a2d8258aa343fb87510c0c9530b1bf1ab2166c17e21
- Edition-Digest: a68e6056fd5cb258b73772fd7dc3e8f69511525dff2715cc46778cb43fb4e623
- Source-Revision: sha256:baae372498e8bb0029d0bb3dbb87a802d40981f421cdfa74d518c0c5e6352ed3

## Tool Reference: `forget`

### Purpose

Supprimer une mémoire, un TODO ou un enregistrement adossé à Ledger sélectionné via la limite de contrôle détenue par l'utilisateur. Le contrat public couvre uniquement les suppressions réversible et définitive ; utilisez redact_memory pour remplacer le contenu sur place.

### Parameters

- `memory_id` (string, optional): Référence exacte de l'enregistrement à supprimer. Préférée à target.
- `target` (string, optional): Cible descriptive lorsqu'aucune référence exacte n'est disponible.
- `mode` (string, optional, default: soft): 'soft' (par défaut, récupérable) ou 'hard' (permanent, requiert d'abord une confirmation explicite de l'utilisateur). Les alias 'soft_delete' et 'hard_delete' sont acceptés, et une valeur vide signifie soft. Toute autre valeur est rejetée.
- `reason` (string, optional): Motif court d'audit consigné avec la suppression.

### Returns

Le texte de succès indique la référence opaque concernée et l'état du cycle de vie. La suppression réversible reste récupérable via le chemin de restauration ; ce n'est pas le cas de la suppression définitive.

### Errors

- Échec de validation : un mode autre que 'soft'/'soft_delete'/'hard'/'hard_delete' est fourni, ou replacement_content est défini (utilisez redact_memory).
- 401/403 : le jeton ne dispose pas de la capacité d'écriture/suppression requise ou ne peut pas accéder à la cible.
- Cible ambiguë : query_hint correspond à plusieurs enregistrements ou aucune cible exacte ne peut être établie.
- Mode invalide : la suppression définitive n'est pas déduite implicitement, et les modes non pris en charge sont rejetés sur la surface publique.
- Non trouvé ou conflit de cycle de vie : la mémoire, le TODO ou l'enregistrement Ledger sélectionné est déjà absent ou modifié.

### Examples

#### Supprimer de manière réversible un enregistrement exact



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

### Related Tools

- [search_memory](/docs/tools/search): Trouver un résultat strict et autorisé avant une action destructive.
- [remember](/docs/tools/remember): Créer un nouvel enregistrement durable uniquement lorsqu'il est réellement nécessaire.
- [todos](/docs/tools/todos): Gérer directement l'état des tâches ; n'utilisez forget que pour une suppression examinée.
- [ledger](/docs/tools/ledger): Gérer les enregistrements financiers via le répartiteur régi de Ledger.

## Vérifier une suppression

Réexécutez la recherche qui renvoyait précédemment la mémoire. La suppression n'est confirmée que lorsque l'entrée n'apparaît plus.

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