edit_forum_topic()#

Client.edit_forum_topic()#

Use this method to edit name and icon of a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights, unless it is the creator of the topic.

Usable by ✅ Users ✅ Bots
Parameters:

  • chat_id (int | str) – Unique identifier (int) or username (str) of the target chat. For your personal cloud (Saved Messages) you can simply use “me” or “self”. For a contact that exists in your Telegram address book you can use his phone number (str).

  • message_thread_id (int) – Unique identifier for the target message thread of the forum topic

  • name (str, optional) – New topic name, 0-128 characters. If not specified or empty, the current name of the topic will be kept

  • icon_custom_emoji_id (str, optional) – New unique identifier of the custom emoji shown as the topic icon. Use get_forum_topic_icon_stickers() to get all allowed custom emoji identifiers. Pass an empty string to remove the icon. If not specified, the current icon will be kept

Returns:

Message – On success, the edited message is returned.

Example

# Create a new Topic
message = await app.create_forum_topic(chat, "Topic Title")
# Edit the Topic
await app.edit_forum_topic(chat, message.id, "New Topic Title")
# TODO: there is `a bug <https://github.com/pyrogram/pyrogram/issues/1280>`_ here!