Groups

Set disappearing message timer

Sets the disappearing (ephemeral) message timer for a group. Duration is in seconds: 0 (off), 86400 (1 day), 604800 (7 days), or 7776000 (90 days).

PUT
/groups/{jid}/ephemeral

Sets the disappearing (ephemeral) message timer for a group. Duration is in seconds: 0 (off), 86400 (1 day), 604800 (7 days), or 7776000 (90 days).

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

Group JID (e.g. 120363039000000000@g.us).

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

application/json

curl -X PUT "https://example.com/groups/string/ephemeral" \  -H "Content-Type: application/json" \  -d '{    "duration_seconds": 604800  }'
{  "success": true,  "duration_seconds": 604800}
{  "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"}

Reset group invite link POST

Regenerates (revokes and reissues) the WhatsApp invite link for a group via WUTS, invalidating the previous link, and returns the new link with the reset timestamp.

Set group picture POST

Updates the group profile photo. Accepts a base64-encoded JPEG image in the request body and returns the new WhatsApp picture ID.