# Sair do WhatsApp

Fonte: https://apiwpp.com/docs/api/conexoes/sair-do-whatsapp
Seção: Conexões
Atualizado em: 2026-09-28

`POST /connections/{id}/logout`

Sai do WhatsApp e apaga a sessão: o número deixa de estar ligado à conexão (o `phoneNumber` dela volta a `null`), e um QR code novo, ou um código de pareamento, é necessário para conectar de novo. Use para conectar outro número à mesma conexão. Escopo necessário: `connections:write`.

## Cabeçalhos

| Nome | Obrigatório | Descrição |
| --- | --- | --- |
| `Authorization` | sim | `Bearer <chave de API>`; ou envie a chave em `X-Api-Key`. |

## Parâmetros de caminho

| Nome | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `id` | `string · uuid` | sim | Identificador da conexão (o número). |

## Exemplo de requisição

### cURL

```bash
curl -X POST \
  https://api.apiwpp.com/connections/$CONNECTION_ID/logout \
  -H "Authorization: Bearer $API_KEY"
```

### Node.js

```javascript
const res = await fetch(`https://api.apiwpp.com/connections/${connectionId}/logout`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
  },
})
const data = await res.json()
```

### PHP

```php
$response = Http::withToken($apiKey)
    ->post("https://api.apiwpp.com/connections/{$connectionId}/logout");
```

### Python

```python
import requests

response = requests.post(
    f"https://api.apiwpp.com/connections/{connection_id}/logout",
    headers={"Authorization": f"Bearer {API_KEY}"},
)
```

## Respostas

| Código | Erro | Descrição |
| --- | --- | --- |
| 200 |  | A sessão foi encerrada no WhatsApp e apagada: `{"ok": true}`. |
| 400 | `FST_ERR_VALIDATION` | A requisição não segue o schema da operação (por exemplo, um `id` que não é um UUID); `message` diz o que está errado. |
| 401 |  | Sem chave de API, ou com uma chave desconhecida, revogada ou expirada. O corpo é `{"error": "Unauthorized"}`. |
| 403 |  | A chave não tem o escopo `connections:write`; a mensagem de erro cita o escopo que falta. |
| 404 |  | A conexão não existe ou não é de quem chama: a de outra pessoa responde exatamente como uma que não existe (`Connection not found`). Também quando o logout falhou e nada foi registrado (`Connection not found or logout failed`): tente de novo. |
| 429 |  | Requisições demais deste IP de origem, ou autenticações com falha demais: espere os segundos de `Retry-After`. Cabeçalhos: `Retry-After`. |
| 500 |  | Um erro inesperado durante o logout (`Internal error during logout`): tente de novo. |
| 503 |  | A instância do gateway que roda a conexão está mudando (um reinício, um failover) ou não responde: espere os segundos de `Retry-After` e tente de novo. Cabeçalhos: `Retry-After`. |

### 200 OK

```json
{
  "ok": true
}
```

## Detalhes

A conexão continua existindo e ocupando um dos números contratados; para apagá-la, use [Excluir conexão](https://apiwpp.com/docs/api/projetos/excluir-conexao).

Para parear de novo, conecte a conexão com [POST /tenants/{id}/connections/{connId}/connect](https://apiwpp.com/docs/api/projetos/reconectar-conexao) e mostre o QR code. Um pareamento novo, mesmo do mesmo número, recomeça o aquecimento dos primeiros 14 dias e torna todos os contatos destinatários novos (veja [Limites de envio](https://apiwpp.com/docs/guias/limites-de-envio)).

Funciona mesmo quando a organização não está em dia com o pagamento: sair só reduz o uso, então não responde `402`.

Guia: [Parear um número](https://apiwpp.com/docs/guias/parear-um-numero).
