purge_messages()

Client.purge_messages(chat_id: int | str, limit: int = 100, from_message_id: int | None = None, to_message_id: int | None = None, from_user: int | str | None = None) → int

Purge and bulk delete messages in a chat safely with rate-limit protection.

Parameters:

  • chat_id (int | str) – Target chat ID or username.

  • limit (int, optional) – Maximum number of messages to delete. Defaults to 100.

  • from_message_id (int, optional) – Starting message ID range.

  • to_message_id (int, optional) – Ending message ID range.

  • from_user (int | str, optional) – Filter messages from a specific user only.

Returns:

int – The total count of deleted messages.

Purge and bulk delete messages in a chat safely with rate-limit protection.