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

# Desconectar Sessão

> Desconecta a sessão mantendo credenciais

Desconecta a sessão do WhatsApp mas mantém as credenciais salvas. Isso permite reconectar posteriormente sem precisar escanear o QR Code novamente.

## Path Parameters

<ParamField path="id" type="string" required>
  ID da sessão (UUID).
</ParamField>

## Resposta

<ResponseField name="success" type="boolean">
  Se a operação foi bem-sucedida.
</ResponseField>

<ResponseField name="message" type="string">
  Mensagem de confirmação.
</ResponseField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl -X POST "https://api.oxenty.api.br/api/sessions/550e8400-e29b-41d4-a716-446655440000/disconnect" \
    -H "X-API-Key: YOUR_API_KEY"
  ```

  ```typescript TypeScript theme={"system"}
  await client.sessions.disconnect('550e8400-e29b-41d4-a716-446655440000');
  ```

  ```python Python theme={"system"}
  client.sessions.disconnect('550e8400-e29b-41d4-a716-446655440000')
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"system"}
  {
    "success": true,
    "message": "Sessão desconectada com sucesso"
  }
  ```

  ```json 400 Bad Request theme={"system"}
  {
    "statusCode": 400,
    "error": "SESSION_NOT_CONNECTED",
    "message": "Sessão não está conectada"
  }
  ```

  ```json 404 Not Found theme={"system"}
  {
    "statusCode": 404,
    "error": "SESSION_NOT_FOUND",
    "message": "Sessão não encontrada"
  }
  ```
</ResponseExample>

## Diferença entre Disconnect e Logout

| Ação           | Credenciais | Reconexão          |
| -------------- | ----------- | ------------------ |
| **Disconnect** | Mantidas    | Automática, sem QR |
| **Logout**     | Apagadas    | Requer novo QR     |

<Note>
  Use `disconnect` para manutenções temporárias. Use `logout` quando quiser desvincular completamente a conta do WhatsApp.
</Note>