set_chat_member_tag()

async Client.set_chat_member_tag()

Set a custom tag for a member of a group or a supergroup.

Requires the can_manage_tags administrator right.

Usable by Users Bots
Parameters:

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

  • user_id (int | str) – Unique identifier (int) or username (str) of the target user.

  • tag (str, optional) – New tag for the member, 0-16 characters, emoji are not allowed. Pass None to remove the current tag.

Returns:

bool – On success, True is returned.

Example

await app.set_chat_member_tag(chat_id, user_id, "Cool guy")