Chats

Update disappearing-message timer

Sets or clears the disappearing-message timer for a chat using a WUTS preset or a custom number of seconds.

PUT
/chats/{jid}/disappearing

Sets or clears the disappearing-message timer for a chat using a WUTS preset or a custom number of seconds.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Path Parameters

jid*string

Target chat JID (user or group).

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Payload for configuring a chat's disappearing-message timer.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/chats/120363039000000000@g.us/disappearing" \  -H "Content-Type: application/json" \  -d '{    "preset": "7d"  }'
{  "success": true,  "chat_jid": "120363039000000000@g.us",  "preset": "7d",  "seconds": 604800,  "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"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}

Unpin a chat DELETE

Removes the pin from a chat for the connected account via a WhatsApp app-state patch. No request body is required.

Sync app state scopes POST

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.