telegram api method · layer 229 · #e58e95d2

messages.deleteMessages

usable by users and bots

Deletes messages by their identifiers.

definition

messages.deleteMessages#e58e95d2 flags:# revoke:flags.0?true id:Vector<int> = messages.AffectedMessages;

parameters

nametypedescription
flags#Flags, see TL conditional fields
revokeflags.0?trueWhether to delete messages for all participants of the chat
idVector<int>Message ID list

returns

messages.AffectedMessages

errors (7)

codeerrordescription
400BUSINESS_CONNECTION_INVALIDThe connection_id passed to the wrapping invokeWithBusinessConnection call is invalid.
400BUSINESS_CONNECTION_NOT_ALLOWEDThis method was invoked over a business connection using invokeWithBusinessConnection, but either (1) we're a user, and users cannot invoke methods over a business connection; (2) we're a bot, but business mode was disabled in @botfather or (3); we're a bot, but this method cannot be invoked over a business connection.
400MESSAGE_ID_INVALIDThe provided message id is invalid.
400SELF_DELETE_RESTRICTEDBusiness bots can't delete messages just for the user, revoke must be set.
401AUTH_KEY_UNREGISTEREDThe specified authorization key is not registered in the system (for example, a PFS temporary key has expired).
403BOT_ACCESS_FORBIDDENThe specified method *can* be used over a business connection for some operations, but the specified query attempted an operation that is not allowed over a business connection.
403MESSAGE_DELETE_FORBIDDENYou can't delete one of the messages you tried to delete, most likely because it is a service message.

history

present in layers 2–229 · constructor id changed 2×

idlayers
#14f2dd0a2–23
#a5f1892546
#e58e95d262–229