# Method: messages.deleteHistory

Back to methods index

Deletes communication history.

# Parameters:

Name Type Description Required
just_clear Bool Just clear history for the current user, without actually removing messages for every chat user Optional
revoke Bool Whether to delete the message history for all chat participants Optional
peer Username, chat ID, Update, Message or InputPeer User or chat, communication history of which will be deleted Optional
max_id int Maximum ID of message to delete Yes

# Return type: messages.AffectedHistory

# Can bots use this method: NO

# MadelineProto Example (now async for huge speed and parallelism!):

if (!file_exists('madeline.php')) {
    copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php');
include 'madeline.php';

$MadelineProto = new \danog\MadelineProto\API('session.madeline');

$messages_AffectedHistory = $MadelineProto->messages->deleteHistory(['just_clear' => Bool, 'revoke' => Bool, 'peer' => InputPeer, 'max_id' => int, ]);

Or, if you’re into Lua:

messages_AffectedHistory = messages.deleteHistory({just_clear=Bool, revoke=Bool, peer=InputPeer, max_id=int, })

# Errors

Code Type Description
400 CHAT_ID_INVALID The provided chat id is invalid
400 MESSAGE_ID_INVALID The provided message id is invalid
400 MSG_ID_INVALID Invalid message ID provided
400 PEER_ID_INVALID The provided peer id is invalid
406 AUTH_KEY_DUPLICATED An auth key with the same ID was already generated
-503 Timeout Timeout while fetching data
This site uses cookies, as described in the cookie policy. By clicking on "Accept" you consent to the use of cookies.