POST

Disconnect Device

Gracefully terminates the WhatsApp Web session and transitions the device to DISCONNECTED status without deleting historic analytics.

HTTP Endpoint

POSThttps://api-wa.hidessh.com/api/v1/wa/devices/{deviceId}/disconnect

Authentication

This endpoint requires Bearer authentication via your secret API Key.
Header KeyValueRequired
AuthorizationBearer <your_api_key>Required
Content-Typeapplication/jsonRequired

Request Parameters

The request body must be formatted as JSON with the following parameters:

ParameterTypeRequiredDescription
deviceId
stringRequired

Unique ULID identifier of the device.

example: 01M1WW3FKR1JS7CW4KGY78Q5ND

Code Examples

request.sh
curl -X POST "https://api-wa.hidessh.com/api/v1/wa/devices/01M1WW3FKR1JS7CW4KGY78Q5ND/disconnect" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Formats

Device disconnected successfully.

application/json • 200 OK
{
  "success": true,
  "message": "device disconnected successfully"
}