# forget

Exclua uma memória, um TODO ou um registro apoiado pelo Ledger por meio do limite de controle do usuário, após revisão; a exclusão lógica pode ser recuperada e a física é permanente.

- Canonical: https://docs.xmemo.dev/pt-br/docs/tools/forget
- Locale: pt-BR
- Content-Locale: pt-BR
- Canonical-Content-Digest: bb7f8a7e884de0a466e30a2d8258aa343fb87510c0c9530b1bf1ab2166c17e21
- Edition-Digest: f51b5b738bd61634f8a4659a9b9e66ea21470324cdf38f33f117f9472bf1830d
- Source-Revision: sha256:baae372498e8bb0029d0bb3dbb87a802d40981f421cdfa74d518c0c5e6352ed3

## Tool Reference: `forget`

### Purpose

Exclua uma memória, um TODO ou um registro apoiado pelo Ledger por meio do limite de controle do usuário. O contrato público cobre apenas exclusão lógica e física; use redact_memory para substituir o conteúdo no próprio registro.

### Parameters

- `memory_id` (string, optional): Referência exata do registro a remover. Prefira-a a target.
- `target` (string, optional): Alvo descritivo quando não houver uma referência exata disponível.
- `mode` (string, optional, default: soft): 'soft' (padrão, recuperável) ou 'hard' (permanente, exige confirmação explícita prévia do usuário). Os aliases 'soft_delete' e 'hard_delete' são aceitos, e um valor vazio significa soft. Qualquer outro valor é rejeitado.
- `reason` (string, optional): Breve motivo de auditoria registrado com a exclusão.

### Returns

O texto de sucesso informa a referência opaca afetada e o estado do ciclo de vida. A exclusão lógica continua recuperável pelo fluxo de restauração; a física não.

### Errors

- Falha de validação: foi informado um mode diferente de 'soft'/'soft_delete'/'hard'/'hard_delete' ou replacement_content foi definido (use redact_memory).
- 401/403: o token não possui a capacidade necessária de gravação/exclusão ou não pode acessar o alvo.
- Alvo ambíguo: query_hint corresponde a vários registros ou não foi possível estabelecer um alvo exato.
- Modo inválido: a exclusão física não é inferida e modos não suportados são rejeitados na superfície pública.
- Não encontrado ou conflito de ciclo de vida: a memória, o TODO ou o registro do Ledger selecionado já está ausente ou foi alterado.

### Examples

#### Remova um registro exato de forma recuperável



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

### Related Tools

- [search_memory](/docs/tools/search): Encontre um resultado estrito e autorizado antes da ação destrutiva.
- [remember](/docs/tools/remember): Crie um novo registro duradouro somente quando ele for realmente necessário.
- [todos](/docs/tools/todos): Gerencie o estado da tarefa diretamente; use forget apenas para uma exclusão revisada.
- [ledger](/docs/tools/ledger): Gerencie registros financeiros por meio do dispatcher governado do Ledger.

## Verifique uma exclusão

Execute novamente a busca que antes retornava a memória. A exclusão só é confirmada quando a entrada deixa de aparecer.

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