slack-ruby-client 0.13.1 → 1.0.0

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

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module AppsEventAuthorizations
+          #
+          # Get a list of authorizations for the given event context. Each authorization represents an app installation that the event is visible to.
+          #
+          # @option options [string] :event_context
+          #   .
+          # @option options [string] :cursor
+          #   .
+          # @option options [integer] :limit
+          #   .
+          # @see https://api.slack.com/methods/apps.event.authorizations.list
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.event.authorizations/apps.event.authorizations.list.json
+          def apps_event_authorizations_list(options = {})
+            throw ArgumentError.new('Required arguments :event_context missing') if options[:event_context].nil?
+            if block_given?
+              Pagination::Cursor.new(self, :apps_event_authorizations_list, options).each do |page|
+                yield page
+              end
+            else
+              post('apps.event.authorizations.list', options)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module AppsManifest
+          #
+          # Create an app from an app manifest.
+          #
+          # @option options [manifest object as string] :manifest
+          #   A JSON app manifest encoded as a string. This manifest must use a valid app manifest schema - read our guide to creating one.
+          # @see https://api.slack.com/methods/apps.manifest.create
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.manifest/apps.manifest.create.json
+          def apps_manifest_create(options = {})
+            throw ArgumentError.new('Required arguments :manifest missing') if options[:manifest].nil?
+            post('apps.manifest.create', options)
+          end
+
+          #
+          # Permanently deletes an app created through app manifests
+          #
+          # @option options [Object] :app_id
+          #   The ID of the app you want to delete.
+          # @see https://api.slack.com/methods/apps.manifest.delete
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.manifest/apps.manifest.delete.json
+          def apps_manifest_delete(options = {})
+            throw ArgumentError.new('Required arguments :app_id missing') if options[:app_id].nil?
+            post('apps.manifest.delete', options)
+          end
+
+          #
+          # Export an app manifest from an existing app
+          #
+          # @option options [Object] :app_id
+          #   The ID of the app whose configuration you want to export as a manifest.
+          # @see https://api.slack.com/methods/apps.manifest.export
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.manifest/apps.manifest.export.json
+          def apps_manifest_export(options = {})
+            throw ArgumentError.new('Required arguments :app_id missing') if options[:app_id].nil?
+            post('apps.manifest.export', options)
+          end
+
+          #
+          # Update an app from an app manifest
+          #
+          # @option options [Object] :app_id
+          #   The ID of the app whose configuration you want to update.
+          # @option options [manifest object as string] :manifest
+          #   A JSON app manifest encoded as a string. This manifest must use a valid app manifest schema - read our guide to creating one. As this method entirely replaces any previous configuration, manifest must contain both unmodified and modified fields.
+          # @see https://api.slack.com/methods/apps.manifest.update
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.manifest/apps.manifest.update.json
+          def apps_manifest_update(options = {})
+            throw ArgumentError.new('Required arguments :app_id missing') if options[:app_id].nil?
+            throw ArgumentError.new('Required arguments :manifest missing') if options[:manifest].nil?
+            post('apps.manifest.update', options)
+          end
+
+          #
+          # Validate an app manifest
+          #
+          # @option options [manifest object as string] :manifest
+          #   The manifest to be validated. Will be validated against the app manifest schema - read our guide.
+          # @see https://api.slack.com/methods/apps.manifest.validate
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.manifest/apps.manifest.validate.json
+          def apps_manifest_validate(options = {})
+            throw ArgumentError.new('Required arguments :manifest missing') if options[:manifest].nil?
+            post('apps.manifest.validate', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -8,7 +9,7 @@ module Slack
           #
           # Revokes a token.
           #
-          # @option options [Object] :test
+          # @option options [boolean] :test
           #   Setting this parameter to 1 triggers a testing mode where the specified token will not actually be revoked.
           # @see https://api.slack.com/methods/auth.revoke
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/auth/auth.revoke.json

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

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module AuthTeams
+          #
+          # List the workspaces a token can access.
+          #
+          # @option options [string] :cursor
+          #   Set cursor to next_cursor returned by the previous call to list items in the next page.
+          # @option options [boolean] :include_icon
+          #   Whether to return icon paths for each workspace. An icon path represents a URI pointing to the image signifying the workspace.
+          # @option options [integer] :limit
+          #   The maximum number of workspaces to return. Must be a positive integer no larger than 1000.
+          # @see https://api.slack.com/methods/auth.teams.list
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/auth.teams/auth.teams.list.json
+          def auth_teams_list(options = {})
+            if block_given?
+              Pagination::Cursor.new(self, :auth_teams_list, options).each do |page|
+                yield page
+              end
+            else
+              post('auth.teams.list', options)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -8,8 +9,10 @@ module Slack
           #
           # Gets information about a bot user.
           #
-          # @option options [Object] :bot
+          # @option options [user] :bot
           #   Bot user to get info on.
+          # @option options [team] :team_id
+          #   encoded team id or enterprise id where the bot exists, required if org token is used.
           # @see https://api.slack.com/methods/bots.info
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/bots/bots.info.json
           def bots_info(options = {})

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

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module Calls
+          #
+          # Registers a new Call.
+          #
+          # @option options [string] :external_unique_id
+          #   An ID supplied by the 3rd-party Call provider. It must be unique across all Calls from that service.
+          # @option options [string] :join_url
+          #   The URL required for a client to join the Call.
+          # @option options [string] :created_by
+          #   The valid Slack user ID of the user who created this Call. When this method is called with a user token, the created_by field is optional and defaults to the authed user of the token. Otherwise, the field is required.
+          # @option options [integer] :date_start
+          #   Call start time in UTC UNIX timestamp format.
+          # @option options [string] :desktop_app_join_url
+          #   When supplied, available Slack clients will attempt to directly launch the 3rd-party Call with this URL.
+          # @option options [string] :external_display_id
+          #   An optional, human-readable ID supplied by the 3rd-party Call provider. If supplied, this ID will be displayed in the Call object.
+          # @option options [string] :title
+          #   The name of the Call.
+          # @option options [array] :users
+          #   The list of users to register as participants in the Call. Read more on how to specify users here.
+          # @see https://api.slack.com/methods/calls.add
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/calls/calls.add.json
+          def calls_add(options = {})
+            throw ArgumentError.new('Required arguments :external_unique_id missing') if options[:external_unique_id].nil?
+            throw ArgumentError.new('Required arguments :join_url missing') if options[:join_url].nil?
+            post('calls.add', options)
+          end
+
+          #
+          # Ends a Call.
+          #
+          # @option options [string] :id
+          #   id returned when registering the call using the calls.add method.
+          # @option options [integer] :duration
+          #   Call duration in seconds.
+          # @see https://api.slack.com/methods/calls.end
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/calls/calls.end.json
+          def calls_end(options = {})
+            throw ArgumentError.new('Required arguments :id missing') if options[:id].nil?
+            post('calls.end', options)
+          end
+
+          #
+          # Returns information about a Call.
+          #
+          # @option options [string] :id
+          #   id of the Call returned by the calls.add method.
+          # @see https://api.slack.com/methods/calls.info
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/calls/calls.info.json
+          def calls_info(options = {})
+            throw ArgumentError.new('Required arguments :id missing') if options[:id].nil?
+            post('calls.info', options)
+          end
+
+          #
+          # Updates information about a Call.
+          #
+          # @option options [string] :id
+          #   id returned by the calls.add method.
+          # @option options [string] :desktop_app_join_url
+          #   When supplied, available Slack clients will attempt to directly launch the 3rd-party Call with this URL.
+          # @option options [string] :join_url
+          #   The URL required for a client to join the Call.
+          # @option options [string] :title
+          #   The name of the Call.
+          # @see https://api.slack.com/methods/calls.update
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/calls/calls.update.json
+          def calls_update(options = {})
+            throw ArgumentError.new('Required arguments :id missing') if options[:id].nil?
+            post('calls.update', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module CallsParticipants
+          #
+          # Registers new participants added to a Call.
+          #
+          # @option options [string] :id
+          #   id returned by the calls.add method.
+          # @option options [array] :users
+          #   The list of users to add as participants in the Call. Read more on how to specify users here.
+          # @see https://api.slack.com/methods/calls.participants.add
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/calls.participants/calls.participants.add.json
+          def calls_participants_add(options = {})
+            throw ArgumentError.new('Required arguments :id missing') if options[:id].nil?
+            throw ArgumentError.new('Required arguments :users missing') if options[:users].nil?
+            post('calls.participants.add', options)
+          end
+
+          #
+          # Registers participants removed from a Call.
+          #
+          # @option options [string] :id
+          #   id returned by the calls.add method.
+          # @option options [array] :users
+          #   The list of users to remove as participants in the Call. Read more on how to specify users here.
+          # @see https://api.slack.com/methods/calls.participants.remove
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/calls.participants/calls.participants.remove.json
+          def calls_participants_remove(options = {})
+            throw ArgumentError.new('Required arguments :id missing') if options[:id].nil?
+            throw ArgumentError.new('Required arguments :users missing') if options[:users].nil?
+            post('calls.participants.remove', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -5,33 +6,6 @@ module Slack
     module Api
       module Endpoints
         module Channels
-          #
-          # Archives a channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to archive.
-          # @see https://api.slack.com/methods/channels.archive
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.archive.json
-          def channels_archive(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.archive', options)
-          end
-
-          #
-          # Creates a channel.
-          #
-          # @option options [Object] :name
-          #   Name of channel to create.
-          # @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/channels.create
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.create.json
-          def channels_create(options = {})
-            throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
-            post('channels.create', options)
-          end
-
           #
           # Delete a channel (undocumented)
           #
@@ -40,225 +14,10 @@ module Slack
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/undocumented/channels/channels.delete.json
           def channels_delete(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             logger.warn('The channels.delete method is undocumented.')
             post('channels.delete', options)
           end
-
-          #
-          # Fetches history of messages and events from a channel.
-          #
-          # @option options [channel] :channel
-          #   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] :unreads
-          #   Include unread_count_display in the output?.
-          # @see https://api.slack.com/methods/channels.history
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.history.json
-          def channels_history(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.history', options)
-          end
-
-          #
-          # Gets information about a channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to get info on.
-          # @option options [Object] :include_locale
-          #   Set this to true to receive the locale for this channel. Defaults to false.
-          # @see https://api.slack.com/methods/channels.info
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.info.json
-          def channels_info(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.info', options)
-          end
-
-          #
-          # Invites a user to a channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to invite user to.
-          # @option options [user] :user
-          #   User to invite to channel.
-          # @see https://api.slack.com/methods/channels.invite
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.invite.json
-          def channels_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: channels_id(options)['channel']['id']) if options[:channel]
-            options = options.merge(user: users_id(options)['user']['id']) if options[:user]
-            post('channels.invite', options)
-          end
-
-          #
-          # Joins a channel, creating it if needed.
-          #
-          # @option options [Object] :name
-          #   Name of channel to join.
-          # @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/channels.join
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.join.json
-          def channels_join(options = {})
-            throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
-            post('channels.join', options)
-          end
-
-          #
-          # Removes a user from a channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to remove user from.
-          # @option options [user] :user
-          #   User to remove from channel.
-          # @see https://api.slack.com/methods/channels.kick
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.kick.json
-          def channels_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: channels_id(options)['channel']['id']) if options[:channel]
-            options = options.merge(user: users_id(options)['user']['id']) if options[:user]
-            post('channels.kick', options)
-          end
-
-          #
-          # Leaves a channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to leave.
-          # @see https://api.slack.com/methods/channels.leave
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.leave.json
-          def channels_leave(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.leave', options)
-          end
-
-          #
-          # Lists all channels in a Slack team.
-          #
-          # @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] :exclude_archived
-          #   Exclude archived channels from the list.
-          # @option options [Object] :exclude_members
-          #   Exclude the members collection from each channel.
-          # @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 users list hasn't been reached.
-          # @see https://api.slack.com/methods/channels.list
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.list.json
-          def channels_list(options = {})
-            if block_given?
-              Pagination::Cursor.new(self, :channels_list, options).each do |page|
-                yield page
-              end
-            else
-              post('channels.list', options)
-            end
-          end
-
-          #
-          # Sets the read cursor in a channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to set reading cursor in.
-          # @option options [timestamp] :ts
-          #   Timestamp of the most recently seen message.
-          # @see https://api.slack.com/methods/channels.mark
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.mark.json
-          def channels_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: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.mark', options)
-          end
-
-          #
-          # Renames a channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to rename.
-          # @option options [Object] :name
-          #   New name for 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/channels.rename
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.rename.json
-          def channels_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: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.rename', options)
-          end
-
-          #
-          # Retrieve a thread of messages posted to a channel
-          #
-          # @option options [channel] :channel
-          #   Channel to fetch thread from.
-          # @option options [Object] :thread_ts
-          #   Unique identifier of a thread's parent message.
-          # @see https://api.slack.com/methods/channels.replies
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.replies.json
-          def channels_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: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.replies', options)
-          end
-
-          #
-          # Sets the purpose for a channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to set the purpose of.
-          # @option options [Object] :purpose
-          #   The new purpose.
-          # @see https://api.slack.com/methods/channels.setPurpose
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.setPurpose.json
-          def channels_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: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.setPurpose', options)
-          end
-
-          #
-          # Sets the topic for a channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to set the topic of.
-          # @option options [Object] :topic
-          #   The new topic.
-          # @see https://api.slack.com/methods/channels.setTopic
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.setTopic.json
-          def channels_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: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.setTopic', options)
-          end
-
-          #
-          # Unarchives a channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to unarchive.
-          # @see https://api.slack.com/methods/channels.unarchive
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.unarchive.json
-          def channels_unarchive(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.unarchive', options)
-          end
         end
       end
     end