Messages

Delete (revoke) a message

Deletes a message from a WUTS-connected chat. With deleteType 'for_everyone' the message is revoked on WhatsApp for all participants (subject to WhatsApp's time limit); with 'for_me' the call succeeds locally without revoking on the server.

DELETE
/messages/delete

Deletes a message from a WUTS-connected chat. With deleteType 'for_everyone' the message is revoked on WhatsApp for all participants (subject to WhatsApp's time limit); with 'for_me' the call succeeds locally without revoking on the server.

Authorization

bearerAuth
AuthorizationBearer <token>

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

application/json

curl -X DELETE "https://example.com/messages/delete" \  -H "Content-Type: application/json" \  -d '{    "messageId": "3EB0XXXX1234ABCD",    "chatJid": "5511999999999@s.whatsapp.net",    "deleteType": "for_everyone",    "reason": "Sent to wrong contact",    "validateOwnership": true  }'
{  "success": true,  "message_id": "3EB0XXXX1234ABCD",  "deleted_at": "2026-06-15T14:34:00Z",  "delete_type": "for_everyone",  "chat_jid": "5511999999999@s.whatsapp.net",  "metadata": {    "time_elapsed_minutes": 0,    "within_time_limit": true,    "reason": "Sent to wrong contact",    "processing_time_ms": 142  }}
{  "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"}

Remove a label from a message DELETE

Detaches a label from a message via a WhatsApp app-state patch. The chat the message belongs to is supplied with the chat_jid query parameter.

Edit a previously sent message PUT

Replaces the text content of a message already sent from the WUTS-connected device. WhatsApp only allows editing within a limited time window after the original message was sent.