Skip to content
Back to top
View this page

# ChatMemberAdministrator

class telegram.ChatMemberAdministrator(user, can_be_edited, is_anonymous, can_manage_chat, can_delete_messages, can_manage_video_chats, can_restrict_members, can_promote_members, can_change_info, can_invite_users, can_post_stories, can_edit_stories, can_delete_stories, can_post_messages=None, can_edit_messages=None, can_pin_messages=None, can_manage_topics=None, custom_title=None, can_manage_direct_messages=None, can_manage_tags=None, *, api_kwargs=None)

  Bases: `telegram.ChatMember`

  Represents a chat member that has some additional privileges.

  Available In

  - `telegram.ChatMemberUpdated.new_chat_member`

  - `telegram.ChatMemberUpdated.old_chat_member`

  Returned In

  - `telegram.Bot.get_chat_administrators()`

  - `telegram.Bot.get_chat_member()`

  Added in version 13.7.

  Changed in version 20.0:

  - Argument and attribute `can_manage_voice_chats` were renamed to `can_manage_video_chats` and `can_manage_video_chats` in accordance to Bot API 6.0.

  - The argument `can_manage_topics` was added, which changes the position of the optional argument `custom_title`.

  Changed in version 21.1: As of this version, `can_post_stories`, `can_edit_stories`, and `can_delete_stories` is now required. Thus, the order of arguments had to be changed.

  Parameters:

    - user (`telegram.User`) – Information about the user.

    - can_be_edited (`bool`) – `True`, if the bot is allowed to edit administrator privileges of that user.

    - is_anonymous (`bool`) – `True`, if the user’s presence in the chat is hidden.

    - can_manage_chat (`bool`) – `True`, if the administrator can access the chat event log, get boost list, see hidden supergroup and channel members, report spam messages and ignore slow mode. Implied by any other administrator privilege.

    - can_delete_messages (`bool`) – `True`, if the administrator can delete messages of other users.

    - can_manage_video_chats (`bool`) –

      `True`, if the administrator can manage video chats.

      Added in version 20.0.

    - can_restrict_members (`bool`) – `True`, if the administrator can restrict, ban or unban chat members.

    - can_promote_members (`bool`) – `True`, if the administrator can add new administrators with a subset of his own privileges or demote administrators that he has promoted, directly or indirectly (promoted by administrators that were appointed by the user).

    - can_change_info (`bool`) – `True`, if the user can change the chat title, photo and other settings.

    - can_invite_users (`bool`) – `True`, if the user can invite new users to the chat.

    - can_post_messages (`bool`, optional) – `True`, if the administrator can post messages in the channel, or access channel statistics; for channels only.

    - can_edit_messages (`bool`, optional) – `True`, if the administrator can edit messages of other users and can pin messages; for channels only.

    - can_pin_messages (`bool`, optional) – `True`, if the user is allowed to pin messages; for groups and supergroups only.

    - can_post_stories (`bool`) –

      `True`, if the administrator can post stories to the chat.

      Added in version 20.6.

      Changed in version 21.0: As of this version, this argument is now required. In accordance with our stability policy, the signature will be kept as optional for now, though they are mandatory and an error will be raised if you don’t pass it.

    - can_edit_stories (`bool`) –

      `True`, if the administrator can edit stories posted by other users, post stories to the chat page, pin chat stories, and access the chat’s story archive

      Added in version 20.6.

      Changed in version 21.0: As of this version, this argument is now required. In accordance with our stability policy, the signature will be kept as optional for now, though they are mandatory and an error will be raised if you don’t pass it.

    - can_delete_stories (`bool`) –

      `True`, if the administrator can delete stories posted by other users.

      Added in version 20.6.

      Changed in version 21.0: As of this version, this argument is now required. In accordance with our stability policy, the signature will be kept as optional for now, though they are mandatory and an error will be raised if you don’t pass it.

    - can_manage_topics (`bool`, optional) –

      `True`, if the user is allowed to create, rename, close, and reopen forum topics; for supergroups only.

      Added in version 20.0.

    - custom_title (`str`, optional) – Custom title for this user.

    - can_manage_direct_messages (`bool`, optional) –

      `True`, if the administrator can manage direct messages of the channel and decline suggested posts; for channels only.

      Added in version 22.4.

    - can_manage_tags (`bool`, optional) –

      `True`, if the administrator can edit the tags of regular members; for groups and supergroups only. If omitted defaults to the value of `can_pin_messages`.

      Added in version 22.7.

  status

    The member’s status in the chat, always `'administrator'`.

    Type:

      `str`

  user

    Information about the user.

    Type:

      `telegram.User`

  can_be_edited

    `True`, if the bot is allowed to edit administrator privileges of that user.

    Type:

      `bool`

  is_anonymous

    `True`, if the user’s presence in the chat is hidden.

    Type:

      `bool`

  can_manage_chat

    `True`, if the administrator can access the chat event log, get boost list, see hidden supergroup and channel members, report spam messages and ignore slow mode. Implied by any other administrator privilege.

    Type:

      `bool`

  can_delete_messages

    `True`, if the administrator can delete messages of other users.

    Type:

      `bool`

  can_manage_video_chats

    `True`, if the administrator can manage video chats.

    Added in version 20.0.

    Type:

      `bool`

  can_restrict_members

    `True`, if the administrator can restrict, ban or unban chat members, or access supergroup statistics.

    Type:

      `bool`

  can_promote_members

    `True`, if the administrator can add new administrators with a subset of their own privileges or demote administrators that they have promoted, directly or indirectly (promoted by administrators that were appointed by the user).

    Type:

      `bool`

  can_change_info

    `True`, if the user can change the chat title, photo and other settings.

    Type:

      `bool`

  can_invite_users

    `True`, if the user can invite new users to the chat.

    Type:

      `bool`

  can_post_messages

    Optional. `True`, if the administrator can post messages in the channel or access channel statistics; for channels only.

    Type:

      `bool`

  can_edit_messages

    Optional. `True`, if the administrator can edit messages of other users and can pin messages; for channels only.

    Type:

      `bool`

  can_pin_messages

    Optional. `True`, if the user is allowed to pin messages; for groups and supergroups only.

    Type:

      `bool`

  can_post_stories

    `True`, if the administrator can post stories to the chat.

    Added in version 20.6.

    Changed in version 21.0: As of this version, this argument is now required. In accordance with our stability policy, the signature will be kept as optional for now, though they are mandatory and an error will be raised if you don’t pass it.

    Type:

      `bool`

  can_edit_stories

    `True`, if the administrator can edit stories posted by other users, post stories to the chat page, pin chat stories, and access the chat’s story archive

    Added in version 20.6.

    Changed in version 21.0: As of this version, this argument is now required. In accordance with our stability policy, the signature will be kept as optional for now, though they are mandatory and an error will be raised if you don’t pass it.

    Type:

      `bool`

  can_delete_stories

    `True`, if the administrator can delete stories posted by other users.

    Added in version 20.6.

    Changed in version 21.0: As of this version, this argument is now required. In accordance with our stability policy, the signature will be kept as optional for now, though they are mandatory and an error will be raised if you don’t pass it.

    Type:

      `bool`

  can_manage_topics

    Optional. `True`, if the user is allowed to create, rename, close, and reopen forum topics; for supergroups only

    Added in version 20.0.

    Type:

      `bool`

  custom_title

    Optional. Custom title for this user.

    Type:

      `str`

  can_manage_direct_messages

    Optional. `True`, if the administrator can manage direct messages of the channel and decline suggested posts; for channels only.

    Added in version 22.4.

    Type:

      `bool`

  can_manage_tags

    Optional. `True`, if the administrator can edit the tags of regular members; for groups and supergroups only. If omitted defaults to the value of `can_pin_messages`.

    Added in version 22.7.

    Type:

      `bool`