Sync app state scopes
Forces the WUTS device to fetch fresh WhatsApp app-state patches for the requested scopes (contacts, chats, settings, pins, critical). When no scopes are provided, contacts, chats, and settings are synced. The body is optional.
Forces the WUTS device to fetch fresh WhatsApp app-state patches for the requested scopes (contacts, chats, settings, pins, critical). When no scopes are provided, contacts, chats, and settings are synced. The body is optional.
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.
Controls which app-state scopes WUTS fetches. The whole body is optional.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/appstate/sync" \ -H "Content-Type: application/json" \ -d '{ "scopes": [ "contacts", "chats" ], "full": false }'{ "success": true, "scopes": [ "contacts", "chats" ], "full_sync": false}{ "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"}{ "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"}Update disappearing-message timer PUT
Sets or clears the disappearing-message timer for a chat using a WUTS preset or a custom number of seconds.
Block a contact POST
Adds a contact to the WhatsApp block list of the authenticated WUTS device. Provide the target as a JID or a phone number in the body or query string; WUTS resolves the LID/PN identity automatically.