slackapi-sdk 1.0.0

data/lib/slack_web_api/controllers/files_remote_controller.rb

@@ -0,0 +1,250 @@
+# slack_web_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module SlackWebApi
+  # FilesRemoteController
+  class FilesRemoteController < BaseController
+    # Adds a file from a remote service
+    # @param [String] token Optional parameter: Authentication token. Requires
+    # scope: `remote_files:write`
+    # @param [String] external_id Optional parameter: Creator defined GUID for
+    # the file.
+    # @param [String] title Optional parameter: Title of the file being
+    # shared.
+    # @param [String] filetype Optional parameter: type of file
+    # @param [String] external_url Optional parameter: URL of the remote file.
+    # @param [String] preview_image Optional parameter: Preview of the document
+    # via `multipart/form-data`.
+    # @param [String] indexable_file_contents Optional parameter: A text file
+    # (txt, pdf, doc, etc.) containing textual search terms that are used to
+    # improve discovery of the remote file.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def files_remote_add(token: nil,
+                         external_id: nil,
+                         title: nil,
+                         filetype: nil,
+                         external_url: nil,
+                         preview_image: nil,
+                         indexable_file_contents: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/files.remote.add',
+                                     Server::DEFAULT)
+                   .form_param(new_parameter(token, key: 'token'))
+                   .form_param(new_parameter(external_id, key: 'external_id'))
+                   .form_param(new_parameter(title, key: 'title'))
+                   .form_param(new_parameter(filetype, key: 'filetype'))
+                   .form_param(new_parameter(external_url, key: 'external_url'))
+                   .form_param(new_parameter(preview_image, key: 'preview_image'))
+                   .form_param(new_parameter(indexable_file_contents, key: 'indexable_file_contents'))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'content-type'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('slackAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(DefaultSuccessTemplate.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('default',
+                                 'Typical error response',
+                                 DefaultErrorTemplateException))
+        .execute
+    end
+
+    # Retrieve information about a remote file added to Slack
+    # @param [String] token Optional parameter: Authentication token. Requires
+    # scope: `remote_files:read`
+    # @param [String] file Optional parameter: Specify a file by providing its
+    # ID.
+    # @param [String] external_id Optional parameter: Creator defined GUID for
+    # the file.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def files_remote_info(token: nil,
+                          file: nil,
+                          external_id: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/files.remote.info',
+                                     Server::DEFAULT)
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'Content-Type'))
+                   .query_param(new_parameter(token, key: 'token'))
+                   .query_param(new_parameter(file, key: 'file'))
+                   .query_param(new_parameter(external_id, key: 'external_id'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('slackAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(DefaultSuccessTemplate.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('default',
+                                 'Typical error response',
+                                 DefaultErrorTemplateException))
+        .execute
+    end
+
+    # Retrieve information about a remote file added to Slack
+    # @param [String] token Optional parameter: Authentication token. Requires
+    # scope: `remote_files:read`
+    # @param [String] channel Optional parameter: Filter files appearing in a
+    # specific channel, indicated by its ID.
+    # @param [Float] ts_from Optional parameter: Filter files created after this
+    # timestamp (inclusive).
+    # @param [Float] ts_to Optional parameter: Filter files created before this
+    # timestamp (inclusive).
+    # @param [Integer] limit Optional parameter: The maximum number of items to
+    # return.
+    # @param [String] cursor Optional parameter: 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](/docs/pagination) for more detail.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def files_remote_list(token: nil,
+                          channel: nil,
+                          ts_from: nil,
+                          ts_to: nil,
+                          limit: nil,
+                          cursor: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/files.remote.list',
+                                     Server::DEFAULT)
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'Content-Type'))
+                   .query_param(new_parameter(token, key: 'token'))
+                   .query_param(new_parameter(channel, key: 'channel'))
+                   .query_param(new_parameter(ts_from, key: 'ts_from'))
+                   .query_param(new_parameter(ts_to, key: 'ts_to'))
+                   .query_param(new_parameter(limit, key: 'limit'))
+                   .query_param(new_parameter(cursor, key: 'cursor'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('slackAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(DefaultSuccessTemplate.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('default',
+                                 'Typical error response',
+                                 DefaultErrorTemplateException))
+        .execute
+    end
+
+    # Remove a remote file.
+    # @param [String] token Optional parameter: Authentication token. Requires
+    # scope: `remote_files:write`
+    # @param [String] file Optional parameter: Specify a file by providing its
+    # ID.
+    # @param [String] external_id Optional parameter: Creator defined GUID for
+    # the file.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def files_remote_remove(token: nil,
+                            file: nil,
+                            external_id: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/files.remote.remove',
+                                     Server::DEFAULT)
+                   .form_param(new_parameter(token, key: 'token'))
+                   .form_param(new_parameter(file, key: 'file'))
+                   .form_param(new_parameter(external_id, key: 'external_id'))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'content-type'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('slackAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(DefaultSuccessTemplate.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('default',
+                                 'Typical error response',
+                                 DefaultErrorTemplateException))
+        .execute
+    end
+
+    # Share a remote file into a channel.
+    # @param [String] token Optional parameter: Authentication token. Requires
+    # scope: `remote_files:share`
+    # @param [String] file Optional parameter: Specify a file registered with
+    # Slack by providing its ID. Either this field or `external_id` or both are
+    # required.
+    # @param [String] external_id Optional parameter: 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.
+    # @param [String] channels Optional parameter: Comma-separated list of
+    # channel IDs where the file will be shared.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def files_remote_share(token: nil,
+                           file: nil,
+                           external_id: nil,
+                           channels: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/files.remote.share',
+                                     Server::DEFAULT)
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'Content-Type'))
+                   .query_param(new_parameter(token, key: 'token'))
+                   .query_param(new_parameter(file, key: 'file'))
+                   .query_param(new_parameter(external_id, key: 'external_id'))
+                   .query_param(new_parameter(channels, key: 'channels'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('slackAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(DefaultSuccessTemplate.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('default',
+                                 'Typical error response',
+                                 DefaultErrorTemplateException))
+        .execute
+    end
+
+    # Updates an existing remote file.
+    # @param [String] token Optional parameter: Authentication token. Requires
+    # scope: `remote_files:write`
+    # @param [String] file Optional parameter: Specify a file by providing its
+    # ID.
+    # @param [String] external_id Optional parameter: Creator defined GUID for
+    # the file.
+    # @param [String] title Optional parameter: Title of the file being
+    # shared.
+    # @param [String] filetype Optional parameter: type of file
+    # @param [String] external_url Optional parameter: URL of the remote file.
+    # @param [String] preview_image Optional parameter: Preview of the document
+    # via `multipart/form-data`.
+    # @param [String] indexable_file_contents Optional parameter: File
+    # containing contents that can be used to improve searchability for the
+    # remote file.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def files_remote_update(token: nil,
+                            file: nil,
+                            external_id: nil,
+                            title: nil,
+                            filetype: nil,
+                            external_url: nil,
+                            preview_image: nil,
+                            indexable_file_contents: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/files.remote.update',
+                                     Server::DEFAULT)
+                   .form_param(new_parameter(token, key: 'token'))
+                   .form_param(new_parameter(file, key: 'file'))
+                   .form_param(new_parameter(external_id, key: 'external_id'))
+                   .form_param(new_parameter(title, key: 'title'))
+                   .form_param(new_parameter(filetype, key: 'filetype'))
+                   .form_param(new_parameter(external_url, key: 'external_url'))
+                   .form_param(new_parameter(preview_image, key: 'preview_image'))
+                   .form_param(new_parameter(indexable_file_contents, key: 'indexable_file_contents'))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'content-type'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('slackAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(DefaultSuccessTemplate.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('default',
+                                 'Typical error response',
+                                 DefaultErrorTemplateException))
+        .execute
+    end
+  end
+end

data/lib/slack_web_api/controllers/migration_controller.rb

@@ -0,0 +1,47 @@
+# slack_web_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module SlackWebApi
+  # MigrationController
+  class MigrationController < BaseController
+    # For Enterprise Grid workspaces, map local user IDs to global user IDs
+    # @param [String] token Required parameter: Authentication token. Requires
+    # scope: `tokens.basic`
+    # @param [String] users Required parameter: A comma-separated list of user
+    # ids, up to 400 per request
+    # @param [String] team_id Optional parameter: Specify team_id starts with
+    # `T` in case of Org Token
+    # @param [TrueClass | FalseClass] to_old Optional parameter: Specify `true`
+    # to convert `W` global user IDs to workspace-specific `U` IDs. Defaults to
+    # `false`.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def migration_exchange(token,
+                           users,
+                           team_id: nil,
+                           to_old: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/migration.exchange',
+                                     Server::DEFAULT)
+                   .query_param(new_parameter(token, key: 'token')
+                                 .is_required(true))
+                   .query_param(new_parameter(users, key: 'users')
+                                 .is_required(true))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'Content-Type'))
+                   .query_param(new_parameter(team_id, key: 'team_id'))
+                   .query_param(new_parameter(to_old, key: 'to_old'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('slackAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(MigrationExchangeSuccessSchema.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('default',
+                                 'Typical error response when there are no mappings to provide',
+                                 MigrationExchangeErrorSchemaException))
+        .execute
+    end
+  end
+end

data/lib/slack_web_api/controllers/oauth_authorization_controller.rb

@@ -0,0 +1,87 @@
+# slack_web_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module SlackWebApi
+  # OauthAuthorizationController
+  class OauthAuthorizationController < BaseController
+    # Create a new OAuth 2 token.
+    # @param [String] authorization Required parameter: Authorization header in
+    # Basic auth format
+    # @param [String] code Required parameter: Authorization Code
+    # @param [String] redirect_uri Required parameter: Redirect Uri
+    # @param [Hash] _field_parameters Additional optional form parameters are
+    # supported by this endpoint.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def request_token(authorization,
+                      code,
+                      redirect_uri,
+                      _field_parameters: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/oauth.access',
+                                     Server::DEFAULT)
+                   .form_param(new_parameter('authorization_code', key: 'grant_type'))
+                   .header_param(new_parameter(authorization, key: 'Authorization')
+                                  .is_required(true))
+                   .form_param(new_parameter(code, key: 'code')
+                                .is_required(true))
+                   .form_param(new_parameter(redirect_uri, key: 'redirect_uri')
+                                .is_required(true))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'content-type'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .additional_form_params(_field_parameters))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(OauthToken.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'OAuth 2 provider returned an error.',
+                                 OauthProviderException)
+                    .local_error('401',
+                                 'OAuth 2 provider says client authentication failed.',
+                                 OauthProviderException))
+        .execute
+    end
+
+    # Obtain a new access token using a refresh token
+    # @param [String] authorization Required parameter: Authorization header in
+    # Basic auth format
+    # @param [String] refresh_token Required parameter: Refresh token
+    # @param [String] scope Optional parameter: Requested scopes as a
+    # space-delimited list.
+    # @param [Hash] _field_parameters Additional optional form parameters are
+    # supported by this endpoint.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def refresh_token(authorization,
+                      refresh_token,
+                      scope: nil,
+                      _field_parameters: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/oauth.access',
+                                     Server::DEFAULT)
+                   .form_param(new_parameter('refresh_token', key: 'grant_type'))
+                   .header_param(new_parameter(authorization, key: 'Authorization')
+                                  .is_required(true))
+                   .form_param(new_parameter(refresh_token, key: 'refresh_token')
+                                .is_required(true))
+                   .form_param(new_parameter(scope, key: 'scope'))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'content-type'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .additional_form_params(_field_parameters))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(OauthToken.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('400',
+                                 'OAuth 2 provider returned an error.',
+                                 OauthProviderException)
+                    .local_error('401',
+                                 'OAuth 2 provider says client authentication failed.',
+                                 OauthProviderException))
+        .execute
+    end
+  end
+end

data/lib/slack_web_api/controllers/oauth_controller.rb

@@ -0,0 +1,88 @@
+# slack_web_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module SlackWebApi
+  # OauthController
+  class OauthController < BaseController
+    # Exchanges a temporary OAuth verifier code for an access token.
+    # @param [String] client_id Optional parameter: Issued when you created your
+    # application.
+    # @param [String] client_secret Optional parameter: Issued when you created
+    # your application.
+    # @param [String] code Optional parameter: The `code` param returned via the
+    # OAuth callback.
+    # @param [String] redirect_uri Optional parameter: This must match the
+    # originally submitted URI (if one was sent).
+    # @param [TrueClass | FalseClass] single_channel Optional parameter: Request
+    # the user to add your app only to a single channel. Only valid with a
+    # [legacy workspace app](https://api.slack.com/legacy-workspace-apps).
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def oauth_access(client_id: nil,
+                     client_secret: nil,
+                     code: nil,
+                     redirect_uri: nil,
+                     single_channel: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/oauth.access',
+                                     Server::DEFAULT)
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'Content-Type'))
+                   .query_param(new_parameter(client_id, key: 'client_id'))
+                   .query_param(new_parameter(client_secret, key: 'client_secret'))
+                   .query_param(new_parameter(code, key: 'code'))
+                   .query_param(new_parameter(redirect_uri, key: 'redirect_uri'))
+                   .query_param(new_parameter(single_channel, key: 'single_channel'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('slackAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(DefaultSuccessTemplate.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('default',
+                                 'Typical error response',
+                                 DefaultErrorTemplateException))
+        .execute
+    end
+
+    # Exchanges a temporary OAuth verifier code for a workspace token.
+    # @param [String] client_id Optional parameter: Issued when you created your
+    # application.
+    # @param [String] client_secret Optional parameter: Issued when you created
+    # your application.
+    # @param [String] code Optional parameter: The `code` param returned via the
+    # OAuth callback.
+    # @param [String] redirect_uri Optional parameter: This must match the
+    # originally submitted URI (if one was sent).
+    # @param [TrueClass | FalseClass] single_channel Optional parameter: Request
+    # the user to add your app only to a single channel.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def oauth_token(client_id: nil,
+                    client_secret: nil,
+                    code: nil,
+                    redirect_uri: nil,
+                    single_channel: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/oauth.token',
+                                     Server::DEFAULT)
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'Content-Type'))
+                   .query_param(new_parameter(client_id, key: 'client_id'))
+                   .query_param(new_parameter(client_secret, key: 'client_secret'))
+                   .query_param(new_parameter(code, key: 'code'))
+                   .query_param(new_parameter(redirect_uri, key: 'redirect_uri'))
+                   .query_param(new_parameter(single_channel, key: 'single_channel'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('slackAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(DefaultSuccessTemplate.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('default',
+                                 'Typical error response',
+                                 DefaultErrorTemplateException))
+        .execute
+    end
+  end
+end

data/lib/slack_web_api/controllers/oauth_v2_controller.rb

@@ -0,0 +1,45 @@
+# slack_web_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module SlackWebApi
+  # OauthV2Controller
+  class OauthV2Controller < BaseController
+    # Exchanges a temporary OAuth verifier code for an access token.
+    # @param [String] code Required parameter: The `code` param returned via the
+    # OAuth callback.
+    # @param [String] client_id Optional parameter: Issued when you created your
+    # application.
+    # @param [String] client_secret Optional parameter: Issued when you created
+    # your application.
+    # @param [String] redirect_uri Optional parameter: This must match the
+    # originally submitted URI (if one was sent).
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def oauth_v2_access(code,
+                        client_id: nil,
+                        client_secret: nil,
+                        redirect_uri: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/oauth.v2.access',
+                                     Server::DEFAULT)
+                   .query_param(new_parameter(code, key: 'code')
+                                 .is_required(true))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'Content-Type'))
+                   .query_param(new_parameter(client_id, key: 'client_id'))
+                   .query_param(new_parameter(client_secret, key: 'client_secret'))
+                   .query_param(new_parameter(redirect_uri, key: 'redirect_uri'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('slackAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(DefaultSuccessTemplate.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('default',
+                                 'Typical error response',
+                                 DefaultErrorTemplateException))
+        .execute
+    end
+  end
+end

data/lib/slack_web_api/controllers/pins_controller.rb

@@ -0,0 +1,102 @@
+# slack_web_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module SlackWebApi
+  # PinsController
+  class PinsController < BaseController
+    # Pins an item to a channel.
+    # @param [String] token Required parameter: Authentication token. Requires
+    # scope: `pins:write`
+    # @param [String] channel Required parameter: Channel to pin the item in.
+    # @param [String] timestamp Optional parameter: Timestamp of the message to
+    # pin.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def pins_add(token,
+                 channel,
+                 timestamp: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/pins.add',
+                                     Server::DEFAULT)
+                   .header_param(new_parameter(token, key: 'token')
+                                  .is_required(true))
+                   .form_param(new_parameter(channel, key: 'channel')
+                                .is_required(true))
+                   .form_param(new_parameter(timestamp, key: 'timestamp'))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'content-type'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('slackAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(PinsAddSchema.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('default',
+                                 'Typical error response',
+                                 PinsAddErrorSchemaException))
+        .execute
+    end
+
+    # Lists items pinned to a channel.
+    # @param [String] token Required parameter: Authentication token. Requires
+    # scope: `pins:read`
+    # @param [String] channel Required parameter: Channel to get pinned items
+    # for.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def pins_list(token,
+                  channel)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/pins.list',
+                                     Server::DEFAULT)
+                   .query_param(new_parameter(token, key: 'token')
+                                 .is_required(true))
+                   .query_param(new_parameter(channel, key: 'channel')
+                                 .is_required(true))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'Content-Type'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('slackAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:dynamic_deserializer))
+                    .is_api_response(true)
+                    .local_error('default',
+                                 'Typical error response',
+                                 PinsListErrorSchemaException))
+        .execute
+    end
+
+    # Un-pins an item from a channel.
+    # @param [String] token Required parameter: Authentication token. Requires
+    # scope: `pins:write`
+    # @param [String] channel Required parameter: Channel where the item is
+    # pinned to.
+    # @param [String] timestamp Optional parameter: Timestamp of the message to
+    # un-pin.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def pins_remove(token,
+                    channel,
+                    timestamp: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/pins.remove',
+                                     Server::DEFAULT)
+                   .header_param(new_parameter(token, key: 'token')
+                                  .is_required(true))
+                   .form_param(new_parameter(channel, key: 'channel')
+                                .is_required(true))
+                   .form_param(new_parameter(timestamp, key: 'timestamp'))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'content-type'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('slackAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(PinsRemoveSchema.method(:from_hash))
+                    .is_api_response(true)
+                    .local_error('default',
+                                 'Typical error response',
+                                 PinsRemoveErrorSchemaException))
+        .execute
+    end
+  end
+end