Source code for mattermostautodriver.endpoints.channels

from ._base import Base
from typing import Any, BinaryIO

__all__ = ["Channels"]


[docs] class Channels(Base):
[docs] def get_all_channels( self, not_associated_to_group: str | None = None, page: int | None = 0, per_page: int | None = 0, exclude_default_channels: bool | None = False, include_deleted: bool | None = False, include_total_count: bool | None = False, exclude_policy_constrained: bool | None = False, ): """Get a list of all channels not_associated_to_group: A group id to exclude channels that are associated with that group via GroupChannel records. This can also be left blank with ``not_associated_to_group=``. page: The page to select. per_page: The number of channels per page. exclude_default_channels: Whether to exclude default channels (ex Town Square, Off-Topic) from the results. include_deleted: Include channels that have been archived. This correlates to the ``DeleteAt`` flag being set in the database. include_total_count: Appends a total count of returned channels inside the response object - ex: ``{ "channels": [], "total_count" : 0 }``. exclude_policy_constrained: If set to true, channels which are part of a data retention policy will be excluded. The ``sysconsole_read_compliance`` permission is required to use this parameter. *Minimum server version*: 5.35 `Read in Mattermost API docs (channels - GetAllChannels) <https://developers.mattermost.com/api-documentation/#/operations/GetAllChannels>`_ """ __params = { "not_associated_to_group": not_associated_to_group, "page": page, "per_page": per_page, "exclude_default_channels": exclude_default_channels, "include_deleted": include_deleted, "include_total_count": include_total_count, "exclude_policy_constrained": exclude_policy_constrained, } return self.client.get("""/api/v4/channels""", params=__params)
[docs] def create_channel( self, team_id: str, name: str, display_name: str, type: str, purpose: str | None = None, header: str | None = None, ): """Create a channel team_id: The team ID of the team to create the channel on name: The unique handle for the channel, will be present in the channel URL display_name: The non-unique UI name for the channel purpose: A short description of the purpose of the channel header: Markdown-formatted text to display in the header of the channel type: 'O' for a public channel, 'P' for a private channel `Read in Mattermost API docs (channels - CreateChannel) <https://developers.mattermost.com/api-documentation/#/operations/CreateChannel>`_ """ __options = { "team_id": team_id, "name": name, "display_name": display_name, "purpose": purpose, "header": header, "type": type, } return self.client.post("""/api/v4/channels""", options=__options)
[docs] def create_direct_channel(self, options: list[str]): """Create a direct message channel `Read in Mattermost API docs (channels - CreateDirectChannel) <https://developers.mattermost.com/api-documentation/#/operations/CreateDirectChannel>`_ """ return self.client.post("""/api/v4/channels/direct""", options=options)
[docs] def create_group_channel(self, options: list[str]): """Create a group message channel `Read in Mattermost API docs (channels - CreateGroupChannel) <https://developers.mattermost.com/api-documentation/#/operations/CreateGroupChannel>`_ """ return self.client.post("""/api/v4/channels/group""", options=options)
[docs] def search_all_channels( self, term: str, not_associated_to_group: str | None = None, exclude_default_channels: bool | None = None, team_ids: list[str] | None = None, group_constrained: bool | None = None, exclude_group_constrained: bool | None = None, public: bool | None = None, private: bool | None = None, deleted: bool | None = None, page: str | None = None, per_page: str | None = None, exclude_policy_constrained: bool | None = False, include_search_by_id: bool | None = False, exclude_remote: bool | None = False, ): """Search all private and open type channels across all teams term: The string to search in the channel name, display name, and purpose. not_associated_to_group: A group id to exclude channels that are associated to that group via GroupChannel records. exclude_default_channels: Exclude default channels from the results by setting this parameter to true. team_ids: Filters results to channels belonging to the given team ids *Minimum server version*: 5.26 group_constrained: Filters results to only return channels constrained to a group *Minimum server version*: 5.26 exclude_group_constrained: Filters results to exclude channels constrained to a group *Minimum server version*: 5.26 public: Filters results to only return Public / Open channels, can be used in conjunction with ``private`` to return both ``public`` and ``private`` channels *Minimum server version*: 5.26 private: Filters results to only return Private channels, can be used in conjunction with ``public`` to return both ``private`` and ``public`` channels *Minimum server version*: 5.26 deleted: Filters results to only return deleted / archived channels *Minimum server version*: 5.26 page: The page number to return, if paginated. If this parameter is not present with the ``per_page`` parameter then the results will be returned un-paged. per_page: The number of entries to return per page, if paginated. If this parameter is not present with the ``page`` parameter then the results will be returned un-paged. exclude_policy_constrained: If set to true, only channels which do not have a granular retention policy assigned to them will be returned. The ``sysconsole_read_compliance_data_retention`` permission is required to use this parameter. *Minimum server version*: 5.35 include_search_by_id: If set to true, returns channels where given search 'term' matches channel ID. *Minimum server version*: 5.35 exclude_remote: If set to true, only returns channels that are local to this server. *Minimum server version*: 10.2 `Read in Mattermost API docs (channels - SearchAllChannels) <https://developers.mattermost.com/api-documentation/#/operations/SearchAllChannels>`_ """ __options = { "term": term, "not_associated_to_group": not_associated_to_group, "exclude_default_channels": exclude_default_channels, "team_ids": team_ids, "group_constrained": group_constrained, "exclude_group_constrained": exclude_group_constrained, "public": public, "private": private, "deleted": deleted, "page": page, "per_page": per_page, "exclude_policy_constrained": exclude_policy_constrained, "include_search_by_id": include_search_by_id, "exclude_remote": exclude_remote, } return self.client.post("""/api/v4/channels/search""", options=__options)
[docs] def search_group_channels(self, term: str): """Search Group Channels term: The search term to match against the members' usernames of the group channels `Read in Mattermost API docs (channels - SearchGroupChannels) <https://developers.mattermost.com/api-documentation/#/operations/SearchGroupChannels>`_ """ __options = {"term": term} return self.client.post("""/api/v4/channels/group/search""", options=__options)
[docs] def get_public_channels_by_ids_for_team(self, team_id: str, options: list[str]): """Get a list of channels by ids team_id: Team GUID `Read in Mattermost API docs (channels - GetPublicChannelsByIdsForTeam) <https://developers.mattermost.com/api-documentation/#/operations/GetPublicChannelsByIdsForTeam>`_ """ return self.client.post(f"/api/v4/teams/{team_id}/channels/ids", options=options)
[docs] def get_channel_members_timezones(self, channel_id: str): """Get timezones in a channel channel_id: Channel GUID `Read in Mattermost API docs (channels - GetChannelMembersTimezones) <https://developers.mattermost.com/api-documentation/#/operations/GetChannelMembersTimezones>`_ """ return self.client.get(f"/api/v4/channels/{channel_id}/timezones")
[docs] def get_channel(self, channel_id: str): """Get a channel channel_id: Channel GUID `Read in Mattermost API docs (channels - GetChannel) <https://developers.mattermost.com/api-documentation/#/operations/GetChannel>`_ """ return self.client.get(f"/api/v4/channels/{channel_id}")
[docs] def update_channel( self, channel_id: str, id: str, name: str | None = None, display_name: str | None = None, purpose: str | None = None, header: str | None = None, ): """Update a channel channel_id: Channel GUID id: The channel's id, not updatable name: The unique handle for the channel, will be present in the channel URL display_name: The non-unique UI name for the channel purpose: A short description of the purpose of the channel header: Markdown-formatted text to display in the header of the channel `Read in Mattermost API docs (channels - UpdateChannel) <https://developers.mattermost.com/api-documentation/#/operations/UpdateChannel>`_ """ __options = {"id": id, "name": name, "display_name": display_name, "purpose": purpose, "header": header} return self.client.put(f"/api/v4/channels/{channel_id}", options=__options)
[docs] def delete_channel(self, channel_id: str): """Delete a channel channel_id: Channel GUID `Read in Mattermost API docs (channels - DeleteChannel) <https://developers.mattermost.com/api-documentation/#/operations/DeleteChannel>`_ """ return self.client.delete(f"/api/v4/channels/{channel_id}")
[docs] def patch_channel( self, channel_id: str, name: str | None = None, display_name: str | None = None, purpose: str | None = None, header: str | None = None, ): """Patch a channel channel_id: Channel GUID name: The unique handle for the channel, will be present in the channel URL display_name: The non-unique UI name for the channel purpose: A short description of the purpose of the channel header: Markdown-formatted text to display in the header of the channel `Read in Mattermost API docs (channels - PatchChannel) <https://developers.mattermost.com/api-documentation/#/operations/PatchChannel>`_ """ __options = {"name": name, "display_name": display_name, "purpose": purpose, "header": header} return self.client.put(f"/api/v4/channels/{channel_id}/patch", options=__options)
[docs] def update_channel_privacy(self, channel_id: str, privacy: str): """Update channel's privacy channel_id: Channel GUID privacy: Channel privacy setting: 'O' for a public channel, 'P' for a private channel `Read in Mattermost API docs (channels - UpdateChannelPrivacy) <https://developers.mattermost.com/api-documentation/#/operations/UpdateChannelPrivacy>`_ """ __options = {"privacy": privacy} return self.client.put(f"/api/v4/channels/{channel_id}/privacy", options=__options)
[docs] def restore_channel(self, channel_id: str): """Restore a channel channel_id: Channel GUID `Read in Mattermost API docs (channels - RestoreChannel) <https://developers.mattermost.com/api-documentation/#/operations/RestoreChannel>`_ """ return self.client.post(f"/api/v4/channels/{channel_id}/restore")
[docs] def move_channel(self, channel_id: str, team_id: str, force: bool | None = None): """Move a channel channel_id: Channel GUID team_id: force: Remove members those are not member of target team before moving the channel. `Read in Mattermost API docs (channels - MoveChannel) <https://developers.mattermost.com/api-documentation/#/operations/MoveChannel>`_ """ __options = {"team_id": team_id, "force": force} return self.client.post(f"/api/v4/channels/{channel_id}/move", options=__options)
[docs] def get_channel_stats(self, channel_id: str): """Get channel statistics channel_id: Channel GUID `Read in Mattermost API docs (channels - GetChannelStats) <https://developers.mattermost.com/api-documentation/#/operations/GetChannelStats>`_ """ return self.client.get(f"/api/v4/channels/{channel_id}/stats")
[docs] def get_pinned_posts(self, channel_id: str): """Get a channel's pinned posts channel_id: Channel GUID `Read in Mattermost API docs (channels - GetPinnedPosts) <https://developers.mattermost.com/api-documentation/#/operations/GetPinnedPosts>`_ """ return self.client.get(f"/api/v4/channels/{channel_id}/pinned")
[docs] def get_public_channels_for_team(self, team_id: str, page: int | None = 0, per_page: int | None = 60): """Get public channels team_id: Team GUID page: The page to select. per_page: The number of public channels per page. `Read in Mattermost API docs (channels - GetPublicChannelsForTeam) <https://developers.mattermost.com/api-documentation/#/operations/GetPublicChannelsForTeam>`_ """ __params = {"page": page, "per_page": per_page} return self.client.get(f"/api/v4/teams/{team_id}/channels", params=__params)
[docs] def get_private_channels_for_team(self, team_id: str, page: int | None = 0, per_page: int | None = 60): """Get private channels team_id: Team GUID page: The page to select. per_page: The number of private channels per page. `Read in Mattermost API docs (channels - GetPrivateChannelsForTeam) <https://developers.mattermost.com/api-documentation/#/operations/GetPrivateChannelsForTeam>`_ """ __params = {"page": page, "per_page": per_page} return self.client.get(f"/api/v4/teams/{team_id}/channels/private", params=__params)
[docs] def get_deleted_channels_for_team(self, team_id: str, page: int | None = 0, per_page: int | None = 60): """Get deleted channels team_id: Team GUID page: The page to select. per_page: The number of public channels per page. `Read in Mattermost API docs (channels - GetDeletedChannelsForTeam) <https://developers.mattermost.com/api-documentation/#/operations/GetDeletedChannelsForTeam>`_ """ __params = {"page": page, "per_page": per_page} return self.client.get(f"/api/v4/teams/{team_id}/channels/deleted", params=__params)
[docs] def autocomplete_channels_for_team(self, team_id: str, name: str): """Autocomplete channels team_id: Team GUID name: Name or display name `Read in Mattermost API docs (channels - AutocompleteChannelsForTeam) <https://developers.mattermost.com/api-documentation/#/operations/AutocompleteChannelsForTeam>`_ """ __params = {"name": name} return self.client.get(f"/api/v4/teams/{team_id}/channels/autocomplete", params=__params)
[docs] def search_channels(self, team_id: str, term: str): """Search channels team_id: Team GUID term: The search term to match against the name or display name of channels `Read in Mattermost API docs (channels - SearchChannels) <https://developers.mattermost.com/api-documentation/#/operations/SearchChannels>`_ """ __options = {"term": term} return self.client.post(f"/api/v4/teams/{team_id}/channels/search", options=__options)
[docs] def search_archived_channels(self, team_id: str, term: str): """Search archived channels team_id: Team GUID term: The search term to match against the name or display name of archived channels `Read in Mattermost API docs (channels - SearchArchivedChannels) <https://developers.mattermost.com/api-documentation/#/operations/SearchArchivedChannels>`_ """ __options = {"term": term} return self.client.post(f"/api/v4/teams/{team_id}/channels/search_archived", options=__options)
[docs] def get_channel_by_name(self, team_id: str, channel_name: str, include_deleted: bool | None = False): """Get a channel by name team_id: Team GUID channel_name: Channel Name include_deleted: Defines if deleted channels should be returned or not (Mattermost Server 5.26.0+) `Read in Mattermost API docs (channels - GetChannelByName) <https://developers.mattermost.com/api-documentation/#/operations/GetChannelByName>`_ """ __params = {"include_deleted": include_deleted} return self.client.get(f"/api/v4/teams/{team_id}/channels/name/{channel_name}", params=__params)
[docs] def get_channel_by_name_for_team_name( self, team_name: str, channel_name: str, include_deleted: bool | None = False ): """Get a channel by name and team name team_name: Team Name channel_name: Channel Name include_deleted: Defines if deleted channels should be returned or not (Mattermost Server 5.26.0+) `Read in Mattermost API docs (channels - GetChannelByNameForTeamName) <https://developers.mattermost.com/api-documentation/#/operations/GetChannelByNameForTeamName>`_ """ __params = {"include_deleted": include_deleted} return self.client.get(f"/api/v4/teams/name/{team_name}/channels/name/{channel_name}", params=__params)
[docs] def get_channel_members(self, channel_id: str, page: int | None = 0, per_page: int | None = 60): """Get channel members channel_id: Channel GUID page: The page to select. per_page: The number of members per page. `Read in Mattermost API docs (channels - GetChannelMembers) <https://developers.mattermost.com/api-documentation/#/operations/GetChannelMembers>`_ """ __params = {"page": page, "per_page": per_page} return self.client.get(f"/api/v4/channels/{channel_id}/members", params=__params)
[docs] def add_channel_member( self, channel_id: str, user_id: str | None = None, user_ids: list[str] | None = None, post_root_id: str | None = None, ): """Add user(s) to channel channel_id: The channel ID user_id: The ID of user to add into the channel, for backwards compatibility. user_ids: The IDs of users to add into the channel, required if 'user_id' doess not exist. post_root_id: The ID of root post where link to add channel member originates `Read in Mattermost API docs (channels - AddChannelMember) <https://developers.mattermost.com/api-documentation/#/operations/AddChannelMember>`_ """ __options = {"user_id": user_id, "user_ids": user_ids, "post_root_id": post_root_id} return self.client.post(f"/api/v4/channels/{channel_id}/members", options=__options)
[docs] def get_channel_members_by_ids(self, channel_id: str, options: list[str]): """Get channel members by ids channel_id: Channel GUID `Read in Mattermost API docs (channels - GetChannelMembersByIds) <https://developers.mattermost.com/api-documentation/#/operations/GetChannelMembersByIds>`_ """ return self.client.post(f"/api/v4/channels/{channel_id}/members/ids", options=options)
[docs] def get_channel_member(self, channel_id: str, user_id: str): """Get channel member channel_id: Channel GUID user_id: User GUID `Read in Mattermost API docs (channels - GetChannelMember) <https://developers.mattermost.com/api-documentation/#/operations/GetChannelMember>`_ """ return self.client.get(f"/api/v4/channels/{channel_id}/members/{user_id}")
[docs] def remove_user_from_channel(self, channel_id: str, user_id: str): """Remove user from channel channel_id: Channel GUID user_id: User GUID `Read in Mattermost API docs (channels - RemoveUserFromChannel) <https://developers.mattermost.com/api-documentation/#/operations/RemoveUserFromChannel>`_ """ return self.client.delete(f"/api/v4/channels/{channel_id}/members/{user_id}")
[docs] def update_channel_roles(self, channel_id: str, user_id: str, roles: str): """Update channel roles channel_id: Channel GUID user_id: User GUID roles: `Read in Mattermost API docs (channels - UpdateChannelRoles) <https://developers.mattermost.com/api-documentation/#/operations/UpdateChannelRoles>`_ """ __options = {"roles": roles} return self.client.put(f"/api/v4/channels/{channel_id}/members/{user_id}/roles", options=__options)
[docs] def update_channel_member_scheme_roles(self, channel_id: str, user_id: str, scheme_admin: bool, scheme_user: bool): """Update the scheme-derived roles of a channel member. channel_id: Channel GUID user_id: User GUID scheme_admin: scheme_user: `Read in Mattermost API docs (channels - UpdateChannelMemberSchemeRoles) <https://developers.mattermost.com/api-documentation/#/operations/UpdateChannelMemberSchemeRoles>`_ """ __options = {"scheme_admin": scheme_admin, "scheme_user": scheme_user} return self.client.put(f"/api/v4/channels/{channel_id}/members/{user_id}/schemeRoles", options=__options)
[docs] def update_channel_notify_props(self, channel_id: str, user_id: str, options: Any): """Update channel notifications channel_id: Channel GUID user_id: User GUID `Read in Mattermost API docs (channels - UpdateChannelNotifyProps) <https://developers.mattermost.com/api-documentation/#/operations/UpdateChannelNotifyProps>`_ """ return self.client.put(f"/api/v4/channels/{channel_id}/members/{user_id}/notify_props", options=options)
[docs] def view_channel(self, user_id: str, channel_id: str, prev_channel_id: str | None = None): """View channel user_id: User ID to perform the view action for channel_id: The channel ID that is being viewed. Use a blank string to indicate that all channels have lost focus. prev_channel_id: The channel ID of the previous channel, used when switching channels. Providing this ID will cause push notifications to clear on the channel being switched to. `Read in Mattermost API docs (channels - ViewChannel) <https://developers.mattermost.com/api-documentation/#/operations/ViewChannel>`_ """ __options = {"channel_id": channel_id, "prev_channel_id": prev_channel_id} return self.client.post(f"/api/v4/channels/members/{user_id}/view", options=__options)
[docs] def get_channel_members_for_user(self, user_id: str, team_id: str): """Get channel memberships and roles for a user user_id: User GUID team_id: Team GUID `Read in Mattermost API docs (channels - GetChannelMembersForUser) <https://developers.mattermost.com/api-documentation/#/operations/GetChannelMembersForUser>`_ """ return self.client.get(f"/api/v4/users/{user_id}/teams/{team_id}/channels/members")
[docs] def get_channels_for_team_for_user( self, user_id: str, team_id: str, include_deleted: bool | None = False, last_delete_at: int | None = 0 ): """Get channels for user user_id: User GUID team_id: Team GUID include_deleted: Defines if deleted channels should be returned or not last_delete_at: Filters the deleted channels by this time in epoch format. Does not have any effect if include_deleted is set to false. `Read in Mattermost API docs (channels - GetChannelsForTeamForUser) <https://developers.mattermost.com/api-documentation/#/operations/GetChannelsForTeamForUser>`_ """ __params = {"include_deleted": include_deleted, "last_delete_at": last_delete_at} return self.client.get(f"/api/v4/users/{user_id}/teams/{team_id}/channels", params=__params)
[docs] def get_channels_for_user(self, user_id: str, last_delete_at: int | None = 0, include_deleted: bool | None = False): """Get all channels from all teams user_id: The ID of the user. This can also be "me" which will point to the current user. last_delete_at: Filters the deleted channels by this time in epoch format. Does not have any effect if include_deleted is set to false. include_deleted: Defines if deleted channels should be returned or not `Read in Mattermost API docs (channels - GetChannelsForUser) <https://developers.mattermost.com/api-documentation/#/operations/GetChannelsForUser>`_ """ __params = {"last_delete_at": last_delete_at, "include_deleted": include_deleted} return self.client.get(f"/api/v4/users/{user_id}/channels", params=__params)
[docs] def get_channel_unread(self, user_id: str, channel_id: str): """Get unread messages user_id: User GUID channel_id: Channel GUID `Read in Mattermost API docs (channels - GetChannelUnread) <https://developers.mattermost.com/api-documentation/#/operations/GetChannelUnread>`_ """ return self.client.get(f"/api/v4/users/{user_id}/channels/{channel_id}/unread")
[docs] def update_channel_scheme(self, channel_id: str, scheme_id: str): """Set a channel's scheme channel_id: Channel GUID scheme_id: The ID of the scheme. `Read in Mattermost API docs (channels - UpdateChannelScheme) <https://developers.mattermost.com/api-documentation/#/operations/UpdateChannelScheme>`_ """ __options = {"scheme_id": scheme_id} return self.client.put(f"/api/v4/channels/{channel_id}/scheme", options=__options)
[docs] def channel_members_minus_group_members( self, channel_id: str, group_ids: str = "", page: int | None = 0, per_page: int | None = 0 ): """Channel members minus group members. channel_id: Channel GUID group_ids: A comma-separated list of group ids. page: The page to select. per_page: The number of users per page. `Read in Mattermost API docs (channels - ChannelMembersMinusGroupMembers) <https://developers.mattermost.com/api-documentation/#/operations/ChannelMembersMinusGroupMembers>`_ """ __params = {"group_ids": group_ids, "page": page, "per_page": per_page} return self.client.get(f"/api/v4/channels/{channel_id}/members_minus_group_members", params=__params)
[docs] def get_channel_member_counts_by_group(self, channel_id: str, include_timezones: bool | None = False): """Channel members counts for each group that has atleast one member in the channel channel_id: Channel GUID include_timezones: Defines if member timezone counts should be returned or not `Read in Mattermost API docs (channels - GetChannelMemberCountsByGroup) <https://developers.mattermost.com/api-documentation/#/operations/GetChannelMemberCountsByGroup>`_ """ __params = {"include_timezones": include_timezones} return self.client.get(f"/api/v4/channels/{channel_id}/member_counts_by_group", params=__params)
[docs] def get_channel_moderations(self, channel_id: str): """Get information about channel's moderation. channel_id: Channel GUID `Read in Mattermost API docs (channels - GetChannelModerations) <https://developers.mattermost.com/api-documentation/#/operations/GetChannelModerations>`_ """ return self.client.get(f"/api/v4/channels/{channel_id}/moderations")
[docs] def patch_channel_moderations(self, channel_id: str, options: Any): """Update a channel's moderation settings. channel_id: Channel GUID `Read in Mattermost API docs (channels - PatchChannelModerations) <https://developers.mattermost.com/api-documentation/#/operations/PatchChannelModerations>`_ """ return self.client.put(f"/api/v4/channels/{channel_id}/moderations/patch", options=options)
[docs] def get_sidebar_categories_for_team_for_user(self, team_id: str, user_id: str): """Get user's sidebar categories team_id: Team GUID user_id: User GUID `Read in Mattermost API docs (channels - GetSidebarCategoriesForTeamForUser) <https://developers.mattermost.com/api-documentation/#/operations/GetSidebarCategoriesForTeamForUser>`_ """ return self.client.get(f"/api/v4/users/{user_id}/teams/{team_id}/channels/categories")
[docs] def create_sidebar_category_for_team_for_user(self, team_id: str, user_id: str, options: Any): """Create user's sidebar category team_id: Team GUID user_id: User GUID `Read in Mattermost API docs (channels - CreateSidebarCategoryForTeamForUser) <https://developers.mattermost.com/api-documentation/#/operations/CreateSidebarCategoryForTeamForUser>`_ """ return self.client.post(f"/api/v4/users/{user_id}/teams/{team_id}/channels/categories", options=options)
[docs] def update_sidebar_categories_for_team_for_user(self, team_id: str, user_id: str, options: list[Any]): """Update user's sidebar categories team_id: Team GUID user_id: User GUID `Read in Mattermost API docs (channels - UpdateSidebarCategoriesForTeamForUser) <https://developers.mattermost.com/api-documentation/#/operations/UpdateSidebarCategoriesForTeamForUser>`_ """ return self.client.put(f"/api/v4/users/{user_id}/teams/{team_id}/channels/categories", options=options)
[docs] def get_sidebar_category_order_for_team_for_user(self, team_id: str, user_id: str): """Get user's sidebar category order team_id: Team GUID user_id: User GUID `Read in Mattermost API docs (channels - GetSidebarCategoryOrderForTeamForUser) <https://developers.mattermost.com/api-documentation/#/operations/GetSidebarCategoryOrderForTeamForUser>`_ """ return self.client.get(f"/api/v4/users/{user_id}/teams/{team_id}/channels/categories/order")
[docs] def update_sidebar_category_order_for_team_for_user(self, team_id: str, user_id: str, options: list[str]): """Update user's sidebar category order team_id: Team GUID user_id: User GUID `Read in Mattermost API docs (channels - UpdateSidebarCategoryOrderForTeamForUser) <https://developers.mattermost.com/api-documentation/#/operations/UpdateSidebarCategoryOrderForTeamForUser>`_ """ return self.client.put(f"/api/v4/users/{user_id}/teams/{team_id}/channels/categories/order", options=options)
[docs] def get_sidebar_category_for_team_for_user(self, team_id: str, user_id: str, category_id: str): """Get sidebar category team_id: Team GUID user_id: User GUID category_id: Category GUID `Read in Mattermost API docs (channels - GetSidebarCategoryForTeamForUser) <https://developers.mattermost.com/api-documentation/#/operations/GetSidebarCategoryForTeamForUser>`_ """ return self.client.get(f"/api/v4/users/{user_id}/teams/{team_id}/channels/categories/{category_id}")
[docs] def update_sidebar_category_for_team_for_user(self, team_id: str, user_id: str, category_id: str, options: Any): """Update sidebar category team_id: Team GUID user_id: User GUID category_id: Category GUID `Read in Mattermost API docs (channels - UpdateSidebarCategoryForTeamForUser) <https://developers.mattermost.com/api-documentation/#/operations/UpdateSidebarCategoryForTeamForUser>`_ """ return self.client.put( f"/api/v4/users/{user_id}/teams/{team_id}/channels/categories/{category_id}", options=options )
[docs] def remove_sidebar_category_for_team_for_user(self, team_id: str, user_id: str, category_id: str): """Delete sidebar category team_id: Team GUID user_id: User GUID category_id: Category GUID `Read in Mattermost API docs (channels - RemoveSidebarCategoryForTeamForUser) <https://developers.mattermost.com/api-documentation/#/operations/RemoveSidebarCategoryForTeamForUser>`_ """ return self.client.delete(f"/api/v4/users/{user_id}/teams/{team_id}/channels/categories/{category_id}")
[docs] def get_channel_access_control_attributes(self, channel_id: str): """Get access control attributes for a channel channel_id: The ID of the channel. `Read in Mattermost API docs (channels - GetChannelAccessControlAttributes) <https://developers.mattermost.com/api-documentation/#/operations/GetChannelAccessControlAttributes>`_ """ return self.client.get(f"/api/v4/channels/{channel_id}/access_control/attributes")