Labels

Remove a label from a message

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.

DELETE
/messages/{id}/labels/{labelId}

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.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Path Parameters

id*string

Message ID (WhatsApp message key id).

labelId*string

Identifier of the label to remove.

Query Parameters

chat_jid*string

JID of the chat the message belongs to.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/messages/3EB0XXXX1234ABCD/labels/1?chat_jid=5511999999999%40s.whatsapp.net"
{  "success": true,  "chat_jid": "5511999999999@s.whatsapp.net",  "message_id": "3EB0XXXX1234ABCD",  "label_id": "1",  "labeled": 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"}

Remove a label from a chat DELETE

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

Delete (revoke) a message 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.