Confirm passkey pairing code
Final step of passkey pairing. After the `pair.passkey_confirmation` webhook delivers the verification code, show it to the user; once they confirm it matches the one on their phone, call this endpoint to finish the handshake. Pairing then completes and the `pair.success` webhook fires. The body is optional — pass `device_id` to target a specific device.
Final step of passkey pairing. After the pair.passkey_confirmation webhook delivers the verification code, show it to the user; once they confirm it matches the one on their phone, call this endpoint to finish the handshake. Pairing then completes and the pair.success webhook fires. The body is optional — pass device_id to target a specific device.
Authorization
bearerAuth 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
application/json
curl -X POST "https://example.com/passkey/confirmation" \ -H "Content-Type: application/json" \ -d '{ "device_id": "wuts-device-001" }'{ "success": true, "data": { "status": "passkey_confirmed", "device_id": "wuts-device-001", "next": "wait for the pair.success webhook" }}{ "success": false, "error": "device already paired"}{ "success": false, "error": "unauthorized"}{ "success": false, "error": "no active pairing session — start pairing via /qr or /paircode and wait for the pair.passkey_request webhook"}{ "success": false, "error": "failed to send passkey confirmation: websocket disconnected"}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.
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.