Skip to content


The method deletes a message from a chat.


To delete a message, you have to execute a request at:


For idInstance and apiTokenInstance request parameters, refer to Before you start section.

Request parameters#

Parameter Type Mandatory Description
chatId string Yes User or group chat Id
idMessage string Yes Deleted message ID

Request body example#

    "chatId": "",
    "idMessage": "BAE5F4886F6F2D05"


Response parameters#

The response body is empty. If successful, the server response is 200.

DeleteMessage errors#

For a list of errors common to all methods, refer to Common errors section

HTTP code Error identifier Description
400 chatId not found chatID is not found
400 ID message notfound IDMessage is not found

Python request example#

import requests

url = "{{idInstance}}/deleteMessage/{{apiTokenInstance}}"

payload = "{\r\n    \"chatId\": \"\, \"idMessage\": \"BAE5F4886F6F2D05\" \"r\n}"
headers = {
  'Content-Type': 'application/json'

response = requests.request("POST", url, headers=headers, data = payload)