Delete Message

DELETE 
/api/v2/instance/:instanceId/chat/delete/message/:id

The route is responsible for deleting messages in a WhatsApp chat.

Request

Path Parameters

instanceId stringrequired

ID of the instance.

id stringrequired

Unique id [messageId] of the message within the chat.

Query Parameters

everyone string

Possible values: [true, false]

When set to true, the message will be deleted for all users in the chat. If omitted or set to false, the message will only be deleted for the user who made the request.

Responses

200

Success Deletion

application/json

Schema

Schema

statusOfDeletion stringrequired

Possible values: [everyone, fromMe]

deletion booleanrequired
message object
messageId stringrequired
keyId stringrequired
keyFromMe booleanrequired
keyRemoteJid stringrequired
keyParticipant stringrequired
pushName stringrequired
contentType stringrequired
isGroup booleanrequired
content objectrequired
source stringrequired
messageTimestamp stringrequired
createdAt date-timerequired
deletedAt date-timerequired
typeOfDeletion stringrequired
Possible values: [everyone, forMe]
MessageStatus object[]required
Array [
status stringrequired
Possible values: [DELIVERY_ACK, PENDING, PLAYED, READ]
dateTime date-timerequired
]

Example (from schema)

{
  "statusOfDeletion": "everyone",
  "deletion": true,
  "message": {
    "messageId": "string",
    "keyId": "string",
    "keyFromMe": true,
    "keyRemoteJid": "string",
    "keyParticipant": "string",
    "pushName": "string",
    "contentType": "string",
    "isGroup": true,
    "content": {},
    "source": "string",
    "messageTimestamp": "string",
    "createdAt": "2025-06-12T13:21:07.164Z",
    "deletedAt": "2025-06-12T13:21:07.164Z",
    "typeOfDeletion": "everyone",
    "MessageStatus": [
      {
        "status": "DELIVERY_ACK",
        "dateTime": "2025-06-12T13:21:07.164Z"
      }
    ]
  }
}

400

BadRequestException

application/json

Schema

Schema

message string[]required

Default value: string,[object Object]

error stringrequired
statusCode numberrequired

Example (from schema)

{
  "message": [
    "string"
  ],
  "error": "string",
  "statusCode": 0
}

401

UnauthorizedException

application/json

Schema

Schema

message string[]required

Default value: string,[object Object]

error stringrequired
statusCode numberrequired

Example (from schema)

{
  "message": [
    "string"
  ],
  "error": "string",
  "statusCode": 0
}

500

InternalServerErrorException

application/json

Schema

Schema

message string[]required

Default value: string,[object Object]

error stringrequired
statusCode numberrequired

Example (from schema)

{
  "message": [
    "string"
  ],
  "error": "string",
  "statusCode": 0
}

Loading...