append_todo_list()

Client.append_todo_list()

Append new tasks to an existing todo/checklist message.

Part of Bot API 9.6 checklist support. Only works on messages containing a TodoList media object, and only when others_can_append is True or you are the original sender.

Usable by Users Bots

Parameters:
  • chat_id (int | str) – Unique identifier (int) or username (str) of the target chat.

  • message_id (int) – Identifier of the message containing the todo list.

  • tasks (List of str) – List of task titles to append. Each string becomes a new todo item.

  • parse_mode (ParseMode, optional) – Parse mode applied to each task title.

Returns:

Message – On success, the updated todo list message is returned.

Example

await app.append_todo_list(
    chat_id,
    message_id,
    ["Buy milk", "Call dentist", "Review PR"]
)