> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ryzeapi.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Desconectar Instância

> Força logout no WhatsApp e desconecta, mas mantém o registro da instância

**Auth:** `TokenAccount` ou `TokenInstance` • **Rate-limit:** `Global` (100/min) • **Idempotente:** sim

## Descrição

Desvincula o dispositivo do WhatsApp (como clicar em "Sair" no WhatsApp Web) e fecha o websocket. O registro da instância **não** é apagado, o token continua válido para um futuro [`connect`](/pt/api/instance/connect) (com novo QR).

## Exemplo

Faz `DELETE` no path de logout para desvincular o dispositivo do WhatsApp e fechar o WebSocket. O registro da instância é preservado, então o mesmo `token` pode ser reutilizado em uma futura chamada de `connect`.

<CodeGroup>
  ```bash cURL theme={null}
  curl -X DELETE "https://ryzeapi.cloud/api/instance/logout/minha-instancia" \
    -H "token: $Token_Instance"
  ```

  ```javascript JavaScript theme={null}
  await fetch("https://ryzeapi.cloud/api/instance/logout/minha-instancia", {
    method: "DELETE",
    headers: {
      "token": process.env.Token_Instance
    }
  });
  ```

  ```python Python theme={null}
  import os, requests

  requests.delete(
      "https://ryzeapi.cloud/api/instance/logout/minha-instancia",
      headers={
          "token": os.environ["Token_Instance"]
      }
  )
  ```

  ```go Go theme={null}
  package main

  import (
      "net/http"
      "os"
  )

  func main() {
      req, _ := http.NewRequest("DELETE", "https://ryzeapi.cloud/api/instance/logout/minha-instancia", nil)
      req.Header.Set("token", os.Getenv("Token_Instance"))
      http.DefaultClient.Do(req)
  }
  ```
</CodeGroup>

## Resposta de sucesso

```json 200 OK theme={null}
{
  "success": true,
  "message": "Instance logged out",
  "instance": {
    "status": "loggedout"
  }
}
```

## Path parameters

<ParamField path="instance" type="string" required>
  Nome da instância.
</ParamField>

## Headers

<ParamField header="token" type="string" required>
  TokenAccount ou TokenInstance.
</ParamField>

## Erros

| HTTP | `error.message`                         | Quando                     |
| :--: | --------------------------------------- | -------------------------- |
|  401 | `Invalid token`                         | Token ausente ou inválido. |
|  404 | `Instance not found`                    | Nome não existe.           |
|  429 | `Rate limit exceeded. Try again later.` | Mais de 100 req/min.       |
|  500 | `Failed to logout instance`             | Falha interna.             |

```json theme={null}
{
  "success": false,
  "error": {
    "message": "Instance not found"
  }
}
```

## Notas

<Note>
  Após logout, **`reconnect` deixa de funcionar**, a sessão whatsmeow é apagada. Use [`connect`](/pt/api/instance/connect) para gerar um novo QR.
</Note>

<Warning>
  **Não apaga** o registro da instância. Para remover completamente (incluindo configurações, webhook, dados), use [`DELETE /api/instance/delete/:instance`](/pt/api/instance/delete).
</Warning>

## Próximo

<CardGroup cols={2}>
  <Card title="Conectar de novo" icon="qrcode" href="/pt/api/instance/connect">
    Gere um novo QR para vincular outro dispositivo.
  </Card>

  <Card title="Deletar instância" icon="trash" href="/pt/api/instance/delete">
    Para remover tudo definitivamente.
  </Card>
</CardGroup>