Instances

Create a device

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.

POST
/devices

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.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/devices" \  -H "Content-Type: application/json" \  -d '{    "name": "Sales WhatsApp"  }'
{  "success": true,  "device": {    "id": "d3f1a2b4-7c6e-4f01-9a2b-1c2d3e4f5a6b",    "user_id": "9b1c7e2a-44d3-4a55-8f10-2b3c4d5e6f70",    "name": "Sales WhatsApp",    "connected": false,    "created_at": "2026-06-15T13:50:00Z",    "updated_at": "2026-06-15T13:50: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"}

Reconnect using stored credentials POST

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.

Disconnect a device DELETE

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.