slack-ruby-client 0.7.9 → 0.16.0

data/lib/slack/web/api/endpoints/emoji.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -6,10 +7,10 @@ module Slack
       module Endpoints
         module Emoji
           #
-          # This method lists the custom emoji for a team.
+          # Lists custom emoji for a team.
           #
           # @see https://api.slack.com/methods/emoji.list
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/emoji/emoji.list.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/emoji/emoji.list.json
           def emoji_list(options = {})
             post('emoji.list', options)
           end

data/lib/slack/web/api/endpoints/files.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -6,107 +7,143 @@ module Slack
       module Endpoints
         module Files
           #
-          # This method deletes a file from your team.
+          # Deletes a file.
           #
           # @option options [file] :file
           #   ID of file to delete.
           # @see https://api.slack.com/methods/files.delete
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files/files.delete.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files/files.delete.json
           def files_delete(options = {})
             throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
             post('files.delete', options)
           end
 
           #
-          # This method returns information about a file in your team.
+          # Change the properties of a file (undocumented)
+          #
+          # @option options [Object] :file
+          #   ID of the file to be edited
+          # @option options [Object] :title
+          #   New title of the file
+          # @option options [Object] :filetype
+          #   New filetype of the file. See https://api.slack.com/types/file#file_types for a list of all supported types.
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/undocumented/files/files.edit.json
+          def files_edit(options = {})
+            throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
+            throw ArgumentError.new('Required arguments :title missing') if options[:title].nil?
+            logger.warn('The files.edit method is undocumented.')
+            post('files.edit', options)
+          end
+
+          #
+          # Gets information about a file.
           #
           # @option options [file] :file
           #   Specify a file by providing its ID.
+          # @option options [Object] :cursor
+          #   Parameter for pagination. File comments are paginated for a single file. Set cursor equal to the next_cursor attribute returned by the previous request's response_metadata. This parameter is optional, but pagination is mandatory: the default value simply fetches the first "page" of the collection of comments. See pagination for more details.
+          # @option options [Object] :limit
+          #   The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached.
           # @see https://api.slack.com/methods/files.info
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files/files.info.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files/files.info.json
           def files_info(options = {})
             throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
-            post('files.info', options)
+            if block_given?
+              Pagination::Cursor.new(self, :files_info, options).each do |page|
+                yield page
+              end
+            else
+              post('files.info', options)
+            end
           end
 
           #
-          # This method returns a list of files within the team. It can be filtered and sliced in various ways.
+          # List for a team, in a channel, or from a user with applied filters.
           #
-          # @option options [user] :user
-          #   Filter files created by a single user.
           # @option options [channel] :channel
           #   Filter files appearing in a specific channel, indicated by its ID.
+          # @option options [Object] :show_files_hidden_by_limit
+          #   Show truncated file info for files hidden due to being too old, and the team who owns the file being over the file limit.
+          # @option options [Object] :team_id
+          #   encoded team id to list files in, required if org token is used.
           # @option options [Object] :ts_from
           #   Filter files created after this timestamp (inclusive).
           # @option options [Object] :ts_to
           #   Filter files created before this timestamp (inclusive).
           # @option options [Object] :types
-          #   Filter files by type:
-          #
-          #   all - All files
-          #   spaces - Posts
-          #   snippets - Snippets
-          #   images - Image files
-          #   gdocs - Google docs
-          #   zips - Zip files
-          #   pdfs - PDF files
-          #
-          #
-          #   You can pass multiple values in the types argument, like types=spaces,snippets.The default value is all, which does not filter the list.
-          #   .
+          #   Filter files by type (see below). You can pass multiple values in the types argument, like types=spaces,snippets.The default value is all, which does not filter the list.
+          # @option options [user] :user
+          #   Filter files created by a single user.
           # @see https://api.slack.com/methods/files.list
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files/files.list.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files/files.list.json
           def files_list(options = {})
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             options = options.merge(user: users_id(options)['user']['id']) if options[:user]
             post('files.list', options)
           end
 
           #
-          # This method disables public/external sharing for a file.
+          # Revokes public/external sharing access for a file
           #
           # @option options [file] :file
           #   File to revoke.
           # @see https://api.slack.com/methods/files.revokePublicURL
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files/files.revokePublicURL.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files/files.revokePublicURL.json
           def files_revokePublicURL(options = {})
             throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
             post('files.revokePublicURL', options)
           end
 
           #
-          # This method enables public/external sharing for a file.
+          # Share an existing file in a channel (undocumented)
+          #
+          # @option options [Object] :file
+          #   ID of the file to be shared
+          # @option options [channel] :channel
+          #   Channel to share the file in. Works with both public (channel ID) and private channels (group ID).
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/undocumented/files/files.share.json
+          def files_share(options = {})
+            throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
+            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
+            logger.warn('The files.share method is undocumented.')
+            post('files.share', options)
+          end
+
+          #
+          # Enables a file for public/external sharing.
           #
           # @option options [file] :file
           #   File to share.
           # @see https://api.slack.com/methods/files.sharedPublicURL
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files/files.sharedPublicURL.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files/files.sharedPublicURL.json
           def files_sharedPublicURL(options = {})
             throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
             post('files.sharedPublicURL', options)
           end
 
           #
-          # This method allows you to create or upload an existing file.
+          # Uploads or creates a file.
           #
-          # @option options [file] :file
-          #   File contents via multipart/form-data. If omitting this parameter, you must submit content.
+          # @option options [Object] :channels
+          #   Comma-separated list of channel names or IDs where the file will be shared.
           # @option options [Object] :content
           #   File contents via a POST variable. If omitting this parameter, you must provide a file.
-          # @option options [Object] :filetype
-          #   A file type identifier.
+          # @option options [file] :file
+          #   File contents via multipart/form-data. If omitting this parameter, you must submit content.
           # @option options [Object] :filename
           #   Filename of file.
+          # @option options [Object] :filetype
+          #   A file type identifier.
+          # @option options [Object] :initial_comment
+          #   The message text introducing the file in specified channels.
+          # @option options [Object] :thread_ts
+          #   Provide another message's ts value to upload this file as a reply. Never use a reply's ts value; use its parent instead.
           # @option options [Object] :title
           #   Title of file.
-          # @option options [Object] :initial_comment
-          #   Initial comment to add to file.
-          # @option options [Object] :channels
-          #   Comma-separated list of channel names or IDs where the file will be shared.
           # @see https://api.slack.com/methods/files.upload
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files/files.upload.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files/files.upload.json
           def files_upload(options = {})
-            throw ArgumentError.new('Required arguments :filename missing') if options[:filename].nil?
             post('files.upload', options)
           end
         end

data/lib/slack/web/api/endpoints/files_comments.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -6,55 +7,19 @@ module Slack
       module Endpoints
         module FilesComments
           #
-          # Add a comment to an existing file.
-          #
-          # @option options [file] :file
-          #   File to add a comment to.
-          # @option options [Object] :comment
-          #   Text of the comment to add.
-          # @option options [channel] :channel
-          #   Channel id (encoded) of which location to associate with the new comment.
-          # @see https://api.slack.com/methods/files.comments.add
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files.comments/files.comments.add.json
-          def files_comments_add(options = {})
-            throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
-            throw ArgumentError.new('Required arguments :comment missing') if options[:comment].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('files.comments.add', options)
-          end
-
-          #
-          # Delete an existing comment on a file. Only the original author of the comment or a Team Administrator may delete a file comment.
+          # Deletes an existing comment on a file.
           #
           # @option options [file] :file
           #   File to delete a comment from.
           # @option options [Object] :id
           #   The comment to delete.
           # @see https://api.slack.com/methods/files.comments.delete
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files.comments/files.comments.delete.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files.comments/files.comments.delete.json
           def files_comments_delete(options = {})
             throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
             throw ArgumentError.new('Required arguments :id missing') if options[:id].nil?
             post('files.comments.delete', options)
           end
-
-          #
-          # Edit an existing comment on a file. Only the user who created a comment may make edits. Teams may configure a limited time window during which file comment edits are allowed.
-          #
-          # @option options [file] :file
-          #   File containing the comment to edit.
-          # @option options [Object] :id
-          #   The comment to edit.
-          # @option options [Object] :comment
-          #   Text of the comment to edit.
-          # @see https://api.slack.com/methods/files.comments.edit
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files.comments/files.comments.edit.json
-          def files_comments_edit(options = {})
-            throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
-            throw ArgumentError.new('Required arguments :id missing') if options[:id].nil?
-            throw ArgumentError.new('Required arguments :comment missing') if options[:comment].nil?
-            post('files.comments.edit', options)
-          end
         end
       end
     end

data/lib/slack/web/api/endpoints/files_remote.rb

@@ -0,0 +1,127 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module FilesRemote
+          #
+          # Adds a file from a remote service
+          #
+          # @option options [Object] :external_id
+          #   Creator defined GUID for the file.
+          # @option options [Object] :external_url
+          #   URL of the remote file.
+          # @option options [Object] :title
+          #   Title of the file being shared.
+          # @option options [Object] :filetype
+          #   type of file.
+          # @option options [Object] :indexable_file_contents
+          #   A text file (txt, pdf, doc, etc.) containing textual search terms that are used to improve discovery of the remote file.
+          # @option options [Object] :preview_image
+          #   Preview of the document via multipart/form-data.
+          # @see https://api.slack.com/methods/files.remote.add
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files.remote/files.remote.add.json
+          def files_remote_add(options = {})
+            throw ArgumentError.new('Required arguments :external_id missing') if options[:external_id].nil?
+            throw ArgumentError.new('Required arguments :external_url missing') if options[:external_url].nil?
+            throw ArgumentError.new('Required arguments :title missing') if options[:title].nil?
+            post('files.remote.add', options)
+          end
+
+          #
+          # Retrieve information about a remote file added to Slack
+          #
+          # @option options [Object] :external_id
+          #   Creator defined GUID for the file.
+          # @option options [file] :file
+          #   Specify a file by providing its ID.
+          # @see https://api.slack.com/methods/files.remote.info
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files.remote/files.remote.info.json
+          def files_remote_info(options = {})
+            post('files.remote.info', options)
+          end
+
+          #
+          # Retrieve information about a remote file added to Slack
+          #
+          # @option options [channel] :channel
+          #   Filter files appearing in a specific channel, indicated by its ID.
+          # @option options [Object] :cursor
+          #   Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first "page" of the collection. See pagination for more detail.
+          # @option options [Object] :limit
+          #   The maximum number of items to return.
+          # @option options [Object] :ts_from
+          #   Filter files created after this timestamp (inclusive).
+          # @option options [Object] :ts_to
+          #   Filter files created before this timestamp (inclusive).
+          # @see https://api.slack.com/methods/files.remote.list
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files.remote/files.remote.list.json
+          def files_remote_list(options = {})
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
+            if block_given?
+              Pagination::Cursor.new(self, :files_remote_list, options).each do |page|
+                yield page
+              end
+            else
+              post('files.remote.list', options)
+            end
+          end
+
+          #
+          # Remove a remote file.
+          #
+          # @option options [Object] :external_id
+          #   Creator defined GUID for the file.
+          # @option options [file] :file
+          #   Specify a file by providing its ID.
+          # @see https://api.slack.com/methods/files.remote.remove
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files.remote/files.remote.remove.json
+          def files_remote_remove(options = {})
+            post('files.remote.remove', options)
+          end
+
+          #
+          # Share a remote file into a channel.
+          #
+          # @option options [Object] :channels
+          #   Comma-separated list of channel IDs where the file will be shared.
+          # @option options [Object] :external_id
+          #   The globally unique identifier (GUID) for the file, as set by the app registering the file with Slack.  Either this field or file or both are required.
+          # @option options [file] :file
+          #   Specify a file registered with Slack by providing its ID. Either this field or external_id or both are required.
+          # @see https://api.slack.com/methods/files.remote.share
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files.remote/files.remote.share.json
+          def files_remote_share(options = {})
+            throw ArgumentError.new('Required arguments :channels missing') if options[:channels].nil?
+            post('files.remote.share', options)
+          end
+
+          #
+          # Updates an existing remote file.
+          #
+          # @option options [Object] :external_id
+          #   Creator defined GUID for the file.
+          # @option options [Object] :external_url
+          #   URL of the remote file.
+          # @option options [file] :file
+          #   Specify a file by providing its ID.
+          # @option options [Object] :filetype
+          #   type of file.
+          # @option options [Object] :indexable_file_contents
+          #   File containing contents that can be used to improve searchability for the remote file.
+          # @option options [Object] :preview_image
+          #   Preview of the document via multipart/form-data.
+          # @option options [Object] :title
+          #   Title of the file being shared.
+          # @see https://api.slack.com/methods/files.remote.update
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files.remote/files.remote.update.json
+          def files_remote_update(options = {})
+            post('files.remote.update', options)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/slack/web/api/endpoints/groups.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -6,254 +7,276 @@ module Slack
       module Endpoints
         module Groups
           #
-          # This method archives a private channel.
+          # Archives a private channel.
           #
           # @option options [group] :channel
           #   Private channel to archive.
           # @see https://api.slack.com/methods/groups.archive
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.archive.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.archive.json
           def groups_archive(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
+            logger.warn('groups.archive: This method is deprecated. It will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. Alternative methods: conversations.archive.')
             post('groups.archive', options)
           end
 
           #
-          # This method closes a private channel.
-          #
-          # @option options [group] :channel
-          #   Private channel to close.
-          # @see https://api.slack.com/methods/groups.close
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.close.json
-          def groups_close(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
-            post('groups.close', options)
-          end
-
-          #
-          # This method creates a private channel.
+          # Creates a private channel.
           #
           # @option options [Object] :name
           #   Name of private channel to create.
+          # @option options [Object] :team_id
+          #   encoded team id to create the channel in, required if org token is used.
+          # @option options [Object] :validate
+          #   Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.
           # @see https://api.slack.com/methods/groups.create
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.create.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.create.json
           def groups_create(options = {})
             throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
+            logger.warn('groups.create: This method is deprecated. It will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. Alternative methods: conversations.create.')
             post('groups.create', options)
           end
 
           #
-          # This method takes an existing private channel and performs the following steps:
+          # Clones and archives a private channel.
           #
           # @option options [group] :channel
           #   Private channel to clone and archive.
           # @see https://api.slack.com/methods/groups.createChild
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.createChild.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.createChild.json
           def groups_createChild(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
+            logger.warn('groups.createChild: This method is deprecated. It will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. Alternative methods: .')
             post('groups.createChild', options)
           end
 
           #
-          # This method returns a portion of messages/events from the specified private channel.
-          # To read the entire history for a private channel, call the method with no latest or
-          # oldest arguments, and then continue paging using the instructions below.
+          # Fetches history of messages and events from a private channel.
           #
           # @option options [group] :channel
           #   Private channel to fetch history for.
+          # @option options [Object] :inclusive
+          #   Include messages with latest or oldest timestamp in results.
           # @option options [timestamp] :latest
           #   End of time range of messages to include in results.
           # @option options [timestamp] :oldest
           #   Start of time range of messages to include in results.
-          # @option options [Object] :inclusive
-          #   Include messages with latest or oldest timestamp in results.
           # @option options [Object] :unreads
           #   Include unread_count_display in the output?.
           # @see https://api.slack.com/methods/groups.history
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.history.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.history.json
           def groups_history(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
+            logger.warn('groups.history: This method is deprecated. It will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. Alternative methods: conversations.history.')
             post('groups.history', options)
           end
 
           #
-          # This method returns information about a private channel.
+          # Gets information about a private channel.
           #
           # @option options [group] :channel
           #   Private channel to get info on.
+          # @option options [Object] :include_locale
+          #   Set this to true to receive the locale for this group. Defaults to false.
           # @see https://api.slack.com/methods/groups.info
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.info.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.info.json
           def groups_info(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
+            logger.warn('groups.info: This method is deprecated. It will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. Alternative methods: conversations.info.')
             post('groups.info', options)
           end
 
           #
-          # This method is used to invite a user to a private channel. The calling user must be a member of the private channel.
+          # Invites a user to a private channel.
           #
           # @option options [group] :channel
           #   Private channel to invite user to.
           # @option options [user] :user
           #   User to invite.
           # @see https://api.slack.com/methods/groups.invite
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.invite.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.invite.json
           def groups_invite(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :user missing') if options[:user].nil?
             options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
             options = options.merge(user: users_id(options)['user']['id']) if options[:user]
+            logger.warn('groups.invite: This method is deprecated. It will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. Alternative methods: conversations.invite.')
             post('groups.invite', options)
           end
 
           #
-          # This method allows a user to remove another member from a private channel.
+          # Removes a user from a private channel.
           #
           # @option options [group] :channel
           #   Private channel to remove user from.
           # @option options [user] :user
           #   User to remove from private channel.
           # @see https://api.slack.com/methods/groups.kick
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.kick.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.kick.json
           def groups_kick(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :user missing') if options[:user].nil?
             options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
             options = options.merge(user: users_id(options)['user']['id']) if options[:user]
+            logger.warn('groups.kick: This method is deprecated. It will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. Alternative methods: conversations.kick.')
             post('groups.kick', options)
           end
 
           #
-          # This method is used to leave a private channel.
+          # Leaves a private channel.
           #
           # @option options [group] :channel
           #   Private channel to leave.
           # @see https://api.slack.com/methods/groups.leave
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.leave.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.leave.json
           def groups_leave(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
+            logger.warn('groups.leave: This method is deprecated. It will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. Alternative methods: conversations.leave.')
             post('groups.leave', options)
           end
 
           #
-          # This method returns a list of private channels in the team that the caller is in and archived groups that the caller was in.
-          # The list of (non-deactivated) members in each private channel is also returned.
+          # Lists private channels that the calling user has access to.
           #
+          # @option options [Object] :cursor
+          #   Parameter for pagination. Set cursor equal to the next_cursor attribute returned by the previous request's response_metadata. This parameter is optional, but pagination is mandatory: the default value simply fetches the first "page" of the collection. See pagination for more details.
           # @option options [Object] :exclude_archived
           #   Don't return archived private channels.
+          # @option options [Object] :exclude_members
+          #   Exclude the members from each group.
+          # @option options [Object] :limit
+          #   The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached.
+          # @option options [Object] :team_id
+          #   encoded team id to list channels in, required if org token is used.
           # @see https://api.slack.com/methods/groups.list
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.list.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.list.json
           def groups_list(options = {})
-            post('groups.list', options)
+            logger.warn('groups.list: This method is deprecated. It will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. Alternative methods: conversations.list, users.conversations.')
+            if block_given?
+              Pagination::Cursor.new(self, :groups_list, options).each do |page|
+                yield page
+              end
+            else
+              post('groups.list', options)
+            end
           end
 
           #
-          # This method moves the read cursor in a private channel.
+          # Sets the read cursor in a private channel.
           #
           # @option options [group] :channel
-          #   Private channel to set reading cursor in.
+          #   Channel or conversation to set the read cursor for.
           # @option options [timestamp] :ts
-          #   Timestamp of the most recently seen message.
+          #   Unique identifier of message you want marked as most recently seen in this conversation.
           # @see https://api.slack.com/methods/groups.mark
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.mark.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.mark.json
           def groups_mark(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :ts missing') if options[:ts].nil?
             options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
+            logger.warn('groups.mark: This method is deprecated. It will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. Alternative methods: conversations.mark.')
             post('groups.mark', options)
           end
 
           #
-          # This method opens a private channel.
+          # Opens a private channel.
           #
           # @option options [group] :channel
           #   Private channel to open.
           # @see https://api.slack.com/methods/groups.open
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.open.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.open.json
           def groups_open(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
+            logger.warn('groups.open: This method is deprecated. It will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. Alternative methods: .')
             post('groups.open', options)
           end
 
           #
-          # This method renames a private channel.
+          # Renames a private channel.
           #
           # @option options [group] :channel
           #   Private channel to rename.
           # @option options [Object] :name
           #   New name for private channel.
+          # @option options [Object] :validate
+          #   Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.
           # @see https://api.slack.com/methods/groups.rename
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.rename.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.rename.json
           def groups_rename(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
             options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
+            logger.warn('groups.rename: This method is deprecated. It will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. Alternative methods: conversations.rename.')
             post('groups.rename', options)
           end
 
           #
-          # This method returns an entire thread (a message plus all the messages in reply to it).
+          # Retrieve a thread of messages posted to a private channel
           #
           # @option options [group] :channel
           #   Private channel to fetch thread from.
           # @option options [Object] :thread_ts
           #   Unique identifier of a thread's parent message.
           # @see https://api.slack.com/methods/groups.replies
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.replies.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.replies.json
           def groups_replies(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :thread_ts missing') if options[:thread_ts].nil?
             options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
+            logger.warn('groups.replies: This method is deprecated. It will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. Alternative methods: conversations.replies.')
             post('groups.replies', options)
           end
 
           #
-          # This method is used to change the purpose of a private channel. The calling user must be a member of the private channel.
+          # Sets the purpose for a private channel.
           #
           # @option options [group] :channel
           #   Private channel to set the purpose of.
           # @option options [Object] :purpose
           #   The new purpose.
           # @see https://api.slack.com/methods/groups.setPurpose
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.setPurpose.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.setPurpose.json
           def groups_setPurpose(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :purpose missing') if options[:purpose].nil?
             options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
+            logger.warn('groups.setPurpose: This method is deprecated. It will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. Alternative methods: conversations.setPurpose.')
             post('groups.setPurpose', options)
           end
 
           #
-          # This method is used to change the topic of a private channel. The calling user must be a member of the private channel.
+          # Sets the topic for a private channel.
           #
           # @option options [group] :channel
           #   Private channel to set the topic of.
           # @option options [Object] :topic
           #   The new topic.
           # @see https://api.slack.com/methods/groups.setTopic
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.setTopic.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.setTopic.json
           def groups_setTopic(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :topic missing') if options[:topic].nil?
             options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
+            logger.warn('groups.setTopic: This method is deprecated. It will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. Alternative methods: conversations.setTopic.')
             post('groups.setTopic', options)
           end
 
           #
-          # This method unarchives a private channel.
+          # Unarchives a private channel.
           #
           # @option options [group] :channel
           #   Private channel to unarchive.
           # @see https://api.slack.com/methods/groups.unarchive
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.unarchive.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.unarchive.json
           def groups_unarchive(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
+            logger.warn('groups.unarchive: This method is deprecated. It will stop functioning in February 2021 and will not work with newly created apps after June 10th, 2020. Alternative methods: conversations.unarchive.')
             post('groups.unarchive', options)
           end
         end