# Mobile - Wipe da conta (2FA)

`POST /instance/mobile/two-factor/wipe`

Pasta: **Instancia**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Wipe da conta (2FA de registro)

Inicia o wipe (geralmente offline) para remover o 2FA quando o PIN foi esquecido, usando o `wipe_token` retornado pelo WhatsApp.

Use só quando o fluxo de security_code indicar wipe.

## Endpoint

```http
POST {{baseUrl}}/instance/mobile/two-factor/wipe
```

## Autenticação

Header da instância:

```http
token: {{token}}
```

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `code` | string | Sim | Código original da verificação. |
| `wipe_token` | string | Sim | Token retornado na resposta de security_code do WhatsApp. |
| `wipe_type` | string | Não | Padrão: `offline`. |
| `phone` | string | Não | Número com DDI; padrão = `owner`. |

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/instance/mobile/two-factor/wipe" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "code": "123456",
  "wipe_token": "1782243493",
  "wipe_type": "offline",
  "phone": "5511999999999"
}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "message": "Wipe solicitado. Se a conta nao foi registrada imediatamente, aguarde o periodo de wipe_wait e registre novamente.",
  "instance": {
    "status": "needs_verification",
    "verification_state": "wipe_pending",
    "connection_mode": "mobile"
  },
  "runtime": {
    "present": true,
    "connected": false,
    "logged_in": false
  },
  "raw": {}
}
```

## Erros comuns

- `400` — `code`/`wipe_token` ausente ou modo não-mobile
- `409` — token inválido / wipe ainda em espera
- `503` — mobile bridge indisponível

## Observações

Resposta HTTP `202 Accepted`. Pode ser necessário aguardar `wipe_wait` e repetir o registro.

## Corpo (exemplo)

```json
{
  "code": "123456",
  "wipe_token": "1782243493",
  "wipe_type": "offline",
  "phone": "5511999999999"
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/instance/mobile/two-factor/wipe" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "code": "123456",
  "wipe_token": "1782243493",
  "wipe_type": "offline",
  "phone": "5511999999999"
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=instancia/mobile-wipe-da-conta-2fa)