Instances

Disconnect a device

Disconnects the WUTS device's WhatsApp client and marks it as offline. The device must belong to the authenticated user; ownership is enforced before any action.

DELETE
/devices/{deviceID}

Disconnects the WUTS device's WhatsApp client and marks it as offline. The device must belong to the authenticated user; ownership is enforced before any action.

Authorization

bearerAuth
AuthorizationBearer <token>

Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.

In: header

Path Parameters

deviceID*string

Identifier of the WUTS device to disconnect.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/devices/string"
{  "success": true,  "message": "Device disconnected"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}

Create a device POST

Registers a new WUTS device (WhatsApp instance) for the authenticated user. The device starts disconnected and must be paired separately to bind a WhatsApp number.

Disconnect device session POST

Disconnects the WUTS device from WhatsApp and fires the device-disconnected webhook. The stored credentials are preserved, so the device can later reconnect via POST /connect without re-pairing.