List chats
Returns the chats known to the WUTS session, combining named contacts and joined groups with their local pin/archive/mute settings.
Returns the chats known to the WUTS session, combining named contacts and joined groups with their local pin/archive/mute settings.
Authorization
bearerAuth Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.
In: header
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/chats"{ "success": true, "chats": [ { "jid": "120363039000000000@g.us", "type": "group", "name": "Equipe de Vendas", "pinned": true, "archived": false, "muted_until": "2026-06-20T09:00:00Z", "participant_count": 12 }, { "jid": "5511999999999@s.whatsapp.net", "type": "contact", "name": "Maria Silva", "pinned": false, "archived": false, "participant_count": 1 } ], "count": 2}{ "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"}Archive or unarchive a chat POST
Archives or unarchives a chat for the connected account via a WhatsApp app-state patch. Because WUTS does not persist messages, no last-message key is sent, so WhatsApp may auto-unarchive the chat when a new inbound message arrives; an optional last_message_timestamp can be supplied as a hint.
Mute or unmute a chat POST
Mutes or unmutes a chat for the connected account via a WhatsApp app-state patch. When muting, an optional duration_seconds limits the mute window; omitting it mutes indefinitely.