Instances

Reconnect using stored credentials

Reloads the stored WUTS session and reconnects the WhatsApp device WITHOUT a QR scan. This is the primitive the self-heal loop calls to recover instances after a gateway or host restart; if credentials are gone it signals that re-pairing is required.

POST
/connect

Reloads the stored WUTS session and reconnects the WhatsApp device WITHOUT a QR scan. This is the primitive the self-heal loop calls to recover instances after a gateway or host restart; if credentials are gone it signals that re-pairing is required.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Query Parameters

device_id?string

Target WUTS device identifier. When omitted, the device is resolved from the authenticated session.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/connect"
{  "success": true,  "data": {    "status": "connected",    "device_id": "wuts-device-001",    "needs_qr": false  }}
{  "success": false,  "error": "unauthorized"}
{  "success": false,  "error": "device not found"}
{  "success": false,  "error": "reconnect failed"}

Check connection status GET

Returns the live connection and login state of the WUTS device, including its WhatsApp JID and phone number once paired. Always responds 200; the connection details live in the data object.

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.