Generate pairing QR code
Generates a WhatsApp pairing QR code so the WUTS device can be linked by scanning. Returns a freshly cached QR by default; pass refresh flags to force regeneration. Refuses devices that are already paired or connected.
Generates a WhatsApp pairing QR code so the WUTS device can be linked by scanning. Returns a freshly cached QR by default; pass refresh flags to force regeneration. Refuses devices that are already paired or connected.
Authorization
bearerAuth Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.
In: header
Query Parameters
Target WUTS device identifier. When omitted, the device is resolved from the authenticated session.
When true, returns a still-valid cached QR code instead of regenerating. Aliases: reuse, use_cache, cached. Defaults to reusing the cache.
When true, forces a brand-new QR code and ignores the cache. Aliases: force_refresh, force_new.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/qr"{ "success": true, "data": { "qr_code": "2@aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789==,AbCdEf==", "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQAAAAEAB... ", "cached": false, "expires_at": "2026-06-15T18:30:45Z", "ttl": 60 }}{ "success": false, "error": "already connected"}{ "success": false, "error": "unauthorized"}{ "success": false, "error": "timeout waiting for QR code"}{ "success": false, "error": "failed to initialize device"}Generate phone pairing code POST
Generates an 8-character WhatsApp pairing code so the WUTS device can be linked by entering it on the phone instead of scanning a QR. Returns a cached code while it is still valid unless a refresh is requested.
Get my devices (current user) GET
Returns a summary of the devices belonging to the authenticated user, including connection state and last-seen timestamps, wrapped in the standard WUTS response envelope.