​

Desconectar instância WhatsApp

curl -X POST "https://pilotstatus.com.br/v1/numbers/wa_abc/logout" \
  -H "x-api-key: ps_your_token_here"

{
  "ok": true,
  "instances": [
    {
      "instanceId": "inst_123",
      "ok": true
    }
  ]
}

​

Quando usar

• Quando você quer desconectar uma instância WhatsApp temporariamente sem deletá-la.
• Quando você precisa reconectar um número a um dispositivo diferente.
• Ao solucionar problemas de conexão e precisar redefinir o estado da conexão.

​

Diferenças do DELETE

​

Parâmetros da requisição

​

Resposta

​

Sucesso (200)

{
  "ok": true,
  "instances": [
    {
      "instanceId": "inst_123",
      "ok": true
    }
  ]
}

​

Erros

​

Notas

• O logout é best-effort: se o provedor upstream retornar um erro benigno (ex: instância não encontrada, 401), ele é ignorado silenciosamente e o estado da instância ainda é atualizado.
• Após o logout, o estado da instância será LOGOUT no banco de dados.
• Você pode reconectar a instância depois usando GET /v1/numbers/{id}/connect.