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.

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.

reuse_cache?boolean

When true, returns a still-valid cached QR code instead of regenerating. Aliases: reuse, use_cache, cached. Defaults to reusing the cache.

refresh?boolean

When true, forces a brand-new QR code and ignores the cache. Aliases: force_refresh, force_new.

Response Body

`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 pairing QR code

Authorization

Query Parameters

Response Body

200application/json

400application/json

401application/json

408application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`