# forget

Elimina una memoria, un TODO o un registro respaldado por Ledger tras revisarlo, mediante el límite de control del usuario; la eliminación lógica es recuperable y la física es permanente.

- Canonical: https://docs.xmemo.dev/es/docs/tools/forget
- Locale: es-ES
- Content-Locale: es-ES
- Canonical-Content-Digest: bb7f8a7e884de0a466e30a2d8258aa343fb87510c0c9530b1bf1ab2166c17e21
- Edition-Digest: 0a5ccd732ae33c845bb586c00e7dd066207bbfbaa8bfe9b1f35124811a8f7975
- Source-Revision: sha256:baae372498e8bb0029d0bb3dbb87a802d40981f421cdfa74d518c0c5e6352ed3

## Tool Reference: `forget`

### Purpose

Elimina una memoria, un TODO o un registro basado en Ledger tras revisarlo, mediante el límite de control del usuario. El contrato público cubre únicamente la eliminación lógica y física; usa redact_memory para reemplazar el contenido en su lugar.

### Parameters

- `memory_id` (string, optional): Referencia exacta del registro que se va a eliminar. Es preferible a target.
- `target` (string, optional): Objetivo descriptivo cuando no hay una referencia exacta disponible.
- `mode` (string, optional, default: soft): 'soft' (predeterminado y recuperable) o 'hard' (permanente, requiere confirmación explícita previa). Se aceptan los alias 'soft_delete' y 'hard_delete', y un valor vacío significa soft. Cualquier otro valor se rechaza.
- `reason` (string, optional): Motivo breve de auditoría que se registra con la eliminación.

### Returns

El texto de éxito informa de la referencia opaca afectada y del estado del ciclo de vida. La eliminación lógica puede recuperarse mediante la ruta de restauración; la física no.

### Errors

- Error de validación: se proporcionó un mode distinto de 'soft'/'soft_delete'/'hard'/'hard_delete', o se estableció replacement_content (usa redact_memory).
- 401/403: el token no tiene la capacidad de escritura/eliminación necesaria o no puede acceder al objetivo.
- Objetivo ambiguo: query_hint coincide con varios registros o no puede establecerse un objetivo exacto.
- Modo no válido: la eliminación física no se infiere y los modos no admitidos se rechazan en la superficie pública.
- No encontrado o conflicto de ciclo de vida: la memoria, el TODO o el registro de Ledger seleccionado ya no existe o ha cambiado.

### Examples

#### Elimina de forma recuperable un registro exacto



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

### Related Tools

- [search_memory](/docs/tools/search): Encuentra un resultado autorizado y estricto antes de una acción destructiva.
- [remember](/docs/tools/remember): Crea un nuevo registro duradero solo cuando sea realmente necesario.
- [todos](/docs/tools/todos): Gestiona directamente el estado de la tarea; usa forget solo para una eliminación revisada.
- [ledger](/docs/tools/ledger): Gestiona los registros financieros mediante el dispatcher de Ledger sujeto a control.

## Verifica una eliminación

Vuelve a ejecutar la búsqueda que antes devolvía la memoria. La eliminación solo se confirma cuando la entrada deja de aparecer.

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