merge_ruby_client 0.1.4 → 1.1.0

data/lib/merge_ruby_client/filestorage/files/client.rb

@@ -8,6 +8,8 @@ require_relative "../types/file_request"
 require_relative "../types/file_storage_file_response"
 require_relative "types/files_retrieve_request_expand"
 require_relative "../types/file"
+require_relative "../types/download_request_meta"
+require_relative "../types/paginated_download_request_meta_list"
 require_relative "../types/meta_response"
 require "async"
 
@@ -34,9 +36,14 @@ module Merge
       #  should be comma separated without spaces.
       # @param folder_id [String] Specifying a folder id returns only the files in that folder. Specifying null
       #  returns only the files in root directory.
-      # @param include_deleted_data [Boolean] Whether to include data that was marked as deleted by third party webhooks.
+      # @param include_deleted_data [Boolean] Indicates whether or not this object has been deleted in the third party
+      #  platform. Full coverage deletion detection is a premium add-on. Native deletion
+      #  detection is offered for free with limited coverage. [Learn
+      #  more](https://docs.merge.dev/integrations/hris/supported-features/).
       # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
       #  produce these models.
+      # @param include_shell_data [Boolean] Whether to include shell records. Shell records are empty records (they may
+      #  contain some metadata but all other fields are null).
       # @param mime_type [String] If provided, will only return files with these mime_types. Multiple values can
       #  be separated by commas.
       # @param modified_after [DateTime] If provided, only objects synced by Merge after this date time will be returned.
@@ -56,7 +63,7 @@ module Merge
       #  )
       #  api.filestorage.files.list
       def list(created_after: nil, created_before: nil, cursor: nil, drive_id: nil, expand: nil, folder_id: nil,
-               include_deleted_data: nil, include_remote_data: nil, mime_type: nil, modified_after: nil, modified_before: nil, name: nil, page_size: nil, remote_id: nil, request_options: nil)
+               include_deleted_data: nil, include_remote_data: nil, include_shell_data: nil, mime_type: nil, modified_after: nil, modified_before: nil, name: nil, page_size: nil, remote_id: nil, request_options: nil)
         response = @request_client.conn.get do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
           req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
@@ -76,6 +83,7 @@ module Merge
             "folder_id": folder_id,
             "include_deleted_data": include_deleted_data,
             "include_remote_data": include_remote_data,
+            "include_shell_data": include_shell_data,
             "mime_type": mime_type,
             "modified_after": modified_after,
             "modified_before": modified_before,
@@ -99,7 +107,7 @@ module Merge
       #   * :name (String)
       #   * :file_url (String)
       #   * :file_thumbnail_url (String)
-      #   * :size (Integer)
+      #   * :size (Long)
       #   * :mime_type (String)
       #   * :description (String)
       #   * :folder (Hash)
@@ -144,6 +152,8 @@ module Merge
       #  should be comma separated without spaces.
       # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
       #  produce these models.
+      # @param include_shell_data [Boolean] Whether to include shell records. Shell records are empty records (they may
+      #  contain some metadata but all other fields are null).
       # @param request_options [Merge::RequestOptions]
       # @return [Merge::Filestorage::File]
       # @example
@@ -153,7 +163,7 @@ module Merge
       #    api_key: "YOUR_AUTH_TOKEN"
       #  )
       #  api.filestorage.files.retrieve(id: "id")
-      def retrieve(id:, expand: nil, include_remote_data: nil, request_options: nil)
+      def retrieve(id:, expand: nil, include_remote_data: nil, include_shell_data: nil, request_options: nil)
         response = @request_client.conn.get do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
           req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
@@ -166,7 +176,8 @@ module Merge
           req.params = {
             **(request_options&.additional_query_parameters || {}),
             "expand": expand,
-            "include_remote_data": include_remote_data
+            "include_remote_data": include_remote_data,
+            "include_shell_data": include_shell_data
           }.compact
           unless request_options.nil? || request_options&.additional_body_parameters.nil?
             req.body = { **(request_options&.additional_body_parameters || {}) }.compact
@@ -179,6 +190,8 @@ module Merge
       # Returns the `File` content with the given `id` as a stream of bytes.
       #
       # @param id [String]
+      # @param include_shell_data [Boolean] Whether to include shell records. Shell records are empty records (they may
+      #  contain some metadata but all other fields are null).
       # @param mime_type [String] If provided, specifies the export format of the file to be downloaded. For
       #  information on supported export formats, please refer to our <a
       #  tps://help.merge.dev/en/articles/8615316-file-export-and-download-specification'
@@ -189,15 +202,48 @@ module Merge
       #  response environment. The latter will allow access to the response status,
       #  headers and reason, as well as the request info.
       # @return [Void]
+      def download_retrieve(id:, include_shell_data: nil, mime_type: nil, request_options: nil, &on_data)
+        @request_client.conn.get do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          req.options.on_data = on_data
+          req.params = {
+            **(request_options&.additional_query_parameters || {}),
+            "include_shell_data": include_shell_data,
+            "mime_type": mime_type
+          }.compact
+          unless request_options.nil? || request_options&.additional_body_parameters.nil?
+            req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+          end
+          req.url "#{@request_client.get_url(request_options: request_options)}/filestorage/v1/files/#{id}/download"
+        end
+      end
+
+      # Returns metadata to construct an authenticated file download request for a
+      #  singular file, allowing you to download file directly from the third-party.
+      #
+      # @param id [String]
+      # @param mime_type [String] If provided, specifies the export format of the file to be downloaded. For
+      #  information on supported export formats, please refer to our <a
+      #  tps://help.merge.dev/en/articles/8615316-file-export-and-download-specification'
+      #  target='_blank'>export format help center article</a>.
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Filestorage::DownloadRequestMeta]
       # @example
       #  api = Merge::Client.new(
       #    base_url: "https://api.example.com",
       #    environment: Merge::Environment::PRODUCTION,
       #    api_key: "YOUR_AUTH_TOKEN"
       #  )
-      #  api.filestorage.files.download_retrieve(id: "string", mime_type: "string")
-      def download_retrieve(id:, mime_type: nil, request_options: nil, &on_data)
-        @request_client.conn.get do |req|
+      #  api.filestorage.files.download_request_meta_retrieve(id: "id")
+      def download_request_meta_retrieve(id:, mime_type: nil, request_options: nil)
+        response = @request_client.conn.get do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
           req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
           req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
@@ -206,13 +252,61 @@ module Merge
         **@request_client.get_headers,
         **(request_options&.additional_headers || {})
           }.compact
-          req.options.on_data = on_data
           req.params = { **(request_options&.additional_query_parameters || {}), "mime_type": mime_type }.compact
           unless request_options.nil? || request_options&.additional_body_parameters.nil?
             req.body = { **(request_options&.additional_body_parameters || {}) }.compact
           end
-          req.url "#{@request_client.get_url(request_options: request_options)}/filestorage/v1/files/#{id}/download"
+          req.url "#{@request_client.get_url(request_options: request_options)}/filestorage/v1/files/#{id}/download/request-meta"
+        end
+        Merge::Filestorage::DownloadRequestMeta.from_json(json_object: response.body)
+      end
+
+      # Returns metadata to construct authenticated file download requests, allowing you
+      #  to download files directly from the third-party.
+      #
+      # @param cursor [String] The pagination cursor value.
+      # @param include_deleted_data [Boolean] Indicates whether or not this object has been deleted in the third party
+      #  platform. Full coverage deletion detection is a premium add-on. Native deletion
+      #  detection is offered for free with limited coverage. [Learn
+      #  more](https://docs.merge.dev/integrations/hris/supported-features/).
+      # @param mime_type [String] If provided, specifies the export format of the files to be downloaded. For
+      #  information on supported export formats, please refer to our <a
+      #  tps://help.merge.dev/en/articles/8615316-file-export-and-download-specification'
+      #  target='_blank'>export format help center article</a>.
+      # @param page_size [Integer] Number of results to return per page.
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Filestorage::PaginatedDownloadRequestMetaList]
+      # @example
+      #  api = Merge::Client.new(
+      #    base_url: "https://api.example.com",
+      #    environment: Merge::Environment::PRODUCTION,
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.filestorage.files.download_request_meta_list
+      def download_request_meta_list(cursor: nil, include_deleted_data: nil, mime_type: nil, page_size: nil,
+                                     request_options: nil)
+        response = @request_client.conn.get do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          req.params = {
+            **(request_options&.additional_query_parameters || {}),
+            "cursor": cursor,
+            "include_deleted_data": include_deleted_data,
+            "mime_type": mime_type,
+            "page_size": page_size
+          }.compact
+          unless request_options.nil? || request_options&.additional_body_parameters.nil?
+            req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+          end
+          req.url "#{@request_client.get_url(request_options: request_options)}/filestorage/v1/files/download/request-meta"
         end
+        Merge::Filestorage::PaginatedDownloadRequestMetaList.from_json(json_object: response.body)
       end
 
       # Returns metadata for `FileStorageFile` POSTs.
@@ -269,9 +363,14 @@ module Merge
       #  should be comma separated without spaces.
       # @param folder_id [String] Specifying a folder id returns only the files in that folder. Specifying null
       #  returns only the files in root directory.
-      # @param include_deleted_data [Boolean] Whether to include data that was marked as deleted by third party webhooks.
+      # @param include_deleted_data [Boolean] Indicates whether or not this object has been deleted in the third party
+      #  platform. Full coverage deletion detection is a premium add-on. Native deletion
+      #  detection is offered for free with limited coverage. [Learn
+      #  more](https://docs.merge.dev/integrations/hris/supported-features/).
       # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
       #  produce these models.
+      # @param include_shell_data [Boolean] Whether to include shell records. Shell records are empty records (they may
+      #  contain some metadata but all other fields are null).
       # @param mime_type [String] If provided, will only return files with these mime_types. Multiple values can
       #  be separated by commas.
       # @param modified_after [DateTime] If provided, only objects synced by Merge after this date time will be returned.
@@ -291,7 +390,7 @@ module Merge
       #  )
       #  api.filestorage.files.list
       def list(created_after: nil, created_before: nil, cursor: nil, drive_id: nil, expand: nil, folder_id: nil,
-               include_deleted_data: nil, include_remote_data: nil, mime_type: nil, modified_after: nil, modified_before: nil, name: nil, page_size: nil, remote_id: nil, request_options: nil)
+               include_deleted_data: nil, include_remote_data: nil, include_shell_data: nil, mime_type: nil, modified_after: nil, modified_before: nil, name: nil, page_size: nil, remote_id: nil, request_options: nil)
         Async do
           response = @request_client.conn.get do |req|
             req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
@@ -312,6 +411,7 @@ module Merge
               "folder_id": folder_id,
               "include_deleted_data": include_deleted_data,
               "include_remote_data": include_remote_data,
+              "include_shell_data": include_shell_data,
               "mime_type": mime_type,
               "modified_after": modified_after,
               "modified_before": modified_before,
@@ -336,7 +436,7 @@ module Merge
       #   * :name (String)
       #   * :file_url (String)
       #   * :file_thumbnail_url (String)
-      #   * :size (Integer)
+      #   * :size (Long)
       #   * :mime_type (String)
       #   * :description (String)
       #   * :folder (Hash)
@@ -383,6 +483,8 @@ module Merge
       #  should be comma separated without spaces.
       # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
       #  produce these models.
+      # @param include_shell_data [Boolean] Whether to include shell records. Shell records are empty records (they may
+      #  contain some metadata but all other fields are null).
       # @param request_options [Merge::RequestOptions]
       # @return [Merge::Filestorage::File]
       # @example
@@ -392,7 +494,7 @@ module Merge
       #    api_key: "YOUR_AUTH_TOKEN"
       #  )
       #  api.filestorage.files.retrieve(id: "id")
-      def retrieve(id:, expand: nil, include_remote_data: nil, request_options: nil)
+      def retrieve(id:, expand: nil, include_remote_data: nil, include_shell_data: nil, request_options: nil)
         Async do
           response = @request_client.conn.get do |req|
             req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
@@ -406,7 +508,8 @@ module Merge
             req.params = {
               **(request_options&.additional_query_parameters || {}),
               "expand": expand,
-              "include_remote_data": include_remote_data
+              "include_remote_data": include_remote_data,
+              "include_shell_data": include_shell_data
             }.compact
             unless request_options.nil? || request_options&.additional_body_parameters.nil?
               req.body = { **(request_options&.additional_body_parameters || {}) }.compact
@@ -420,6 +523,8 @@ module Merge
       # Returns the `File` content with the given `id` as a stream of bytes.
       #
       # @param id [String]
+      # @param include_shell_data [Boolean] Whether to include shell records. Shell records are empty records (they may
+      #  contain some metadata but all other fields are null).
       # @param mime_type [String] If provided, specifies the export format of the file to be downloaded. For
       #  information on supported export formats, please refer to our <a
       #  tps://help.merge.dev/en/articles/8615316-file-export-and-download-specification'
@@ -430,16 +535,51 @@ module Merge
       #  response environment. The latter will allow access to the response status,
       #  headers and reason, as well as the request info.
       # @return [Void]
+      def download_retrieve(id:, include_shell_data: nil, mime_type: nil, request_options: nil, &on_data)
+        Async do
+          @request_client.conn.get do |req|
+            req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+            req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+            req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+            req.headers = {
+          **(req.headers || {}),
+          **@request_client.get_headers,
+          **(request_options&.additional_headers || {})
+            }.compact
+            req.options.on_data = on_data
+            req.params = {
+              **(request_options&.additional_query_parameters || {}),
+              "include_shell_data": include_shell_data,
+              "mime_type": mime_type
+            }.compact
+            unless request_options.nil? || request_options&.additional_body_parameters.nil?
+              req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+            end
+            req.url "#{@request_client.get_url(request_options: request_options)}/filestorage/v1/files/#{id}/download"
+          end
+        end
+      end
+
+      # Returns metadata to construct an authenticated file download request for a
+      #  singular file, allowing you to download file directly from the third-party.
+      #
+      # @param id [String]
+      # @param mime_type [String] If provided, specifies the export format of the file to be downloaded. For
+      #  information on supported export formats, please refer to our <a
+      #  tps://help.merge.dev/en/articles/8615316-file-export-and-download-specification'
+      #  target='_blank'>export format help center article</a>.
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Filestorage::DownloadRequestMeta]
       # @example
       #  api = Merge::Client.new(
       #    base_url: "https://api.example.com",
       #    environment: Merge::Environment::PRODUCTION,
       #    api_key: "YOUR_AUTH_TOKEN"
       #  )
-      #  api.filestorage.files.download_retrieve(id: "string", mime_type: "string")
-      def download_retrieve(id:, mime_type: nil, request_options: nil, &on_data)
+      #  api.filestorage.files.download_request_meta_retrieve(id: "id")
+      def download_request_meta_retrieve(id:, mime_type: nil, request_options: nil)
         Async do
-          @request_client.conn.get do |req|
+          response = @request_client.conn.get do |req|
             req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
             req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
             req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
@@ -448,13 +588,63 @@ module Merge
           **@request_client.get_headers,
           **(request_options&.additional_headers || {})
             }.compact
-            req.options.on_data = on_data
             req.params = { **(request_options&.additional_query_parameters || {}), "mime_type": mime_type }.compact
             unless request_options.nil? || request_options&.additional_body_parameters.nil?
               req.body = { **(request_options&.additional_body_parameters || {}) }.compact
             end
-            req.url "#{@request_client.get_url(request_options: request_options)}/filestorage/v1/files/#{id}/download"
+            req.url "#{@request_client.get_url(request_options: request_options)}/filestorage/v1/files/#{id}/download/request-meta"
+          end
+          Merge::Filestorage::DownloadRequestMeta.from_json(json_object: response.body)
+        end
+      end
+
+      # Returns metadata to construct authenticated file download requests, allowing you
+      #  to download files directly from the third-party.
+      #
+      # @param cursor [String] The pagination cursor value.
+      # @param include_deleted_data [Boolean] Indicates whether or not this object has been deleted in the third party
+      #  platform. Full coverage deletion detection is a premium add-on. Native deletion
+      #  detection is offered for free with limited coverage. [Learn
+      #  more](https://docs.merge.dev/integrations/hris/supported-features/).
+      # @param mime_type [String] If provided, specifies the export format of the files to be downloaded. For
+      #  information on supported export formats, please refer to our <a
+      #  tps://help.merge.dev/en/articles/8615316-file-export-and-download-specification'
+      #  target='_blank'>export format help center article</a>.
+      # @param page_size [Integer] Number of results to return per page.
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Filestorage::PaginatedDownloadRequestMetaList]
+      # @example
+      #  api = Merge::Client.new(
+      #    base_url: "https://api.example.com",
+      #    environment: Merge::Environment::PRODUCTION,
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.filestorage.files.download_request_meta_list
+      def download_request_meta_list(cursor: nil, include_deleted_data: nil, mime_type: nil, page_size: nil,
+                                     request_options: nil)
+        Async do
+          response = @request_client.conn.get do |req|
+            req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+            req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+            req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+            req.headers = {
+          **(req.headers || {}),
+          **@request_client.get_headers,
+          **(request_options&.additional_headers || {})
+            }.compact
+            req.params = {
+              **(request_options&.additional_query_parameters || {}),
+              "cursor": cursor,
+              "include_deleted_data": include_deleted_data,
+              "mime_type": mime_type,
+              "page_size": page_size
+            }.compact
+            unless request_options.nil? || request_options&.additional_body_parameters.nil?
+              req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+            end
+            req.url "#{@request_client.get_url(request_options: request_options)}/filestorage/v1/files/download/request-meta"
           end
+          Merge::Filestorage::PaginatedDownloadRequestMetaList.from_json(json_object: response.body)
         end
       end
 

data/lib/merge_ruby_client/filestorage/folders/client.rb

@@ -31,9 +31,14 @@ module Merge
       # @param drive_id [String] If provided, will only return folders in this drive.
       # @param expand [Merge::Filestorage::Folders::FoldersListRequestExpand] Which relations should be returned in expanded form. Multiple relation names
       #  should be comma separated without spaces.
-      # @param include_deleted_data [Boolean] Whether to include data that was marked as deleted by third party webhooks.
+      # @param include_deleted_data [Boolean] Indicates whether or not this object has been deleted in the third party
+      #  platform. Full coverage deletion detection is a premium add-on. Native deletion
+      #  detection is offered for free with limited coverage. [Learn
+      #  more](https://docs.merge.dev/integrations/hris/supported-features/).
       # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
       #  produce these models.
+      # @param include_shell_data [Boolean] Whether to include shell records. Shell records are empty records (they may
+      #  contain some metadata but all other fields are null).
       # @param modified_after [DateTime] If provided, only objects synced by Merge after this date time will be returned.
       # @param modified_before [DateTime] If provided, only objects synced by Merge before this date time will be
       #  returned.
@@ -53,7 +58,7 @@ module Merge
       #  )
       #  api.filestorage.folders.list
       def list(created_after: nil, created_before: nil, cursor: nil, drive_id: nil, expand: nil,
-               include_deleted_data: nil, include_remote_data: nil, modified_after: nil, modified_before: nil, name: nil, page_size: nil, parent_folder_id: nil, remote_id: nil, request_options: nil)
+               include_deleted_data: nil, include_remote_data: nil, include_shell_data: nil, modified_after: nil, modified_before: nil, name: nil, page_size: nil, parent_folder_id: nil, remote_id: nil, request_options: nil)
         response = @request_client.conn.get do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
           req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
@@ -72,6 +77,7 @@ module Merge
             "expand": expand,
             "include_deleted_data": include_deleted_data,
             "include_remote_data": include_remote_data,
+            "include_shell_data": include_shell_data,
             "modified_after": modified_after,
             "modified_before": modified_before,
             "name": name,
@@ -94,7 +100,7 @@ module Merge
       # @param model [Hash] Request of type Merge::Filestorage::FolderRequest, as a Hash
       #   * :name (String)
       #   * :folder_url (String)
-      #   * :size (Integer)
+      #   * :size (Long)
       #   * :description (String)
       #   * :parent_folder (Hash)
       #   * :drive (Hash)
@@ -138,6 +144,8 @@ module Merge
       #  should be comma separated without spaces.
       # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
       #  produce these models.
+      # @param include_shell_data [Boolean] Whether to include shell records. Shell records are empty records (they may
+      #  contain some metadata but all other fields are null).
       # @param request_options [Merge::RequestOptions]
       # @return [Merge::Filestorage::Folder]
       # @example
@@ -147,7 +155,7 @@ module Merge
       #    api_key: "YOUR_AUTH_TOKEN"
       #  )
       #  api.filestorage.folders.retrieve(id: "id")
-      def retrieve(id:, expand: nil, include_remote_data: nil, request_options: nil)
+      def retrieve(id:, expand: nil, include_remote_data: nil, include_shell_data: nil, request_options: nil)
         response = @request_client.conn.get do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
           req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
@@ -160,7 +168,8 @@ module Merge
           req.params = {
             **(request_options&.additional_query_parameters || {}),
             "expand": expand,
-            "include_remote_data": include_remote_data
+            "include_remote_data": include_remote_data,
+            "include_shell_data": include_shell_data
           }.compact
           unless request_options.nil? || request_options&.additional_body_parameters.nil?
             req.body = { **(request_options&.additional_body_parameters || {}) }.compact
@@ -221,9 +230,14 @@ module Merge
       # @param drive_id [String] If provided, will only return folders in this drive.
       # @param expand [Merge::Filestorage::Folders::FoldersListRequestExpand] Which relations should be returned in expanded form. Multiple relation names
       #  should be comma separated without spaces.
-      # @param include_deleted_data [Boolean] Whether to include data that was marked as deleted by third party webhooks.
+      # @param include_deleted_data [Boolean] Indicates whether or not this object has been deleted in the third party
+      #  platform. Full coverage deletion detection is a premium add-on. Native deletion
+      #  detection is offered for free with limited coverage. [Learn
+      #  more](https://docs.merge.dev/integrations/hris/supported-features/).
       # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
       #  produce these models.
+      # @param include_shell_data [Boolean] Whether to include shell records. Shell records are empty records (they may
+      #  contain some metadata but all other fields are null).
       # @param modified_after [DateTime] If provided, only objects synced by Merge after this date time will be returned.
       # @param modified_before [DateTime] If provided, only objects synced by Merge before this date time will be
       #  returned.
@@ -243,7 +257,7 @@ module Merge
       #  )
       #  api.filestorage.folders.list
       def list(created_after: nil, created_before: nil, cursor: nil, drive_id: nil, expand: nil,
-               include_deleted_data: nil, include_remote_data: nil, modified_after: nil, modified_before: nil, name: nil, page_size: nil, parent_folder_id: nil, remote_id: nil, request_options: nil)
+               include_deleted_data: nil, include_remote_data: nil, include_shell_data: nil, modified_after: nil, modified_before: nil, name: nil, page_size: nil, parent_folder_id: nil, remote_id: nil, request_options: nil)
         Async do
           response = @request_client.conn.get do |req|
             req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
@@ -263,6 +277,7 @@ module Merge
               "expand": expand,
               "include_deleted_data": include_deleted_data,
               "include_remote_data": include_remote_data,
+              "include_shell_data": include_shell_data,
               "modified_after": modified_after,
               "modified_before": modified_before,
               "name": name,
@@ -286,7 +301,7 @@ module Merge
       # @param model [Hash] Request of type Merge::Filestorage::FolderRequest, as a Hash
       #   * :name (String)
       #   * :folder_url (String)
-      #   * :size (Integer)
+      #   * :size (Long)
       #   * :description (String)
       #   * :parent_folder (Hash)
       #   * :drive (Hash)
@@ -332,6 +347,8 @@ module Merge
       #  should be comma separated without spaces.
       # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
       #  produce these models.
+      # @param include_shell_data [Boolean] Whether to include shell records. Shell records are empty records (they may
+      #  contain some metadata but all other fields are null).
       # @param request_options [Merge::RequestOptions]
       # @return [Merge::Filestorage::Folder]
       # @example
@@ -341,7 +358,7 @@ module Merge
       #    api_key: "YOUR_AUTH_TOKEN"
       #  )
       #  api.filestorage.folders.retrieve(id: "id")
-      def retrieve(id:, expand: nil, include_remote_data: nil, request_options: nil)
+      def retrieve(id:, expand: nil, include_remote_data: nil, include_shell_data: nil, request_options: nil)
         Async do
           response = @request_client.conn.get do |req|
             req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
@@ -355,7 +372,8 @@ module Merge
             req.params = {
               **(request_options&.additional_query_parameters || {}),
               "expand": expand,
-              "include_remote_data": include_remote_data
+              "include_remote_data": include_remote_data,
+              "include_shell_data": include_shell_data
             }.compact
             unless request_options.nil? || request_options&.additional_body_parameters.nil?
               req.body = { **(request_options&.additional_body_parameters || {}) }.compact

data/lib/merge_ruby_client/filestorage/force_resync/client.rb

@@ -17,11 +17,11 @@ module Merge
         @request_client = request_client
       end
 
-      # Force re-sync of all models. This is available for all organizations via the
-      #  dashboard. Force re-sync is also available programmatically via API for monthly,
-      #  quarterly, and highest sync frequency customers on the Launch, Professional, or
-      #  Enterprise plans. Doing so will consume a sync credit for the relevant linked
-      #  account.
+      # Force re-sync of all models. This endpoint is available for monthly, quarterly,
+      #  and highest sync frequency customers on the Professional or Enterprise plans.
+      #  Doing so will consume a sync credit for the relevant linked account. Force
+      #  re-syncs can also be triggered manually in the Merge Dashboard and is available
+      #  for all customers.
       #
       # @param request_options [Merge::RequestOptions]
       # @return [Array<Merge::Filestorage::SyncStatus>]
@@ -68,11 +68,11 @@ module Merge
         @request_client = request_client
       end
 
-      # Force re-sync of all models. This is available for all organizations via the
-      #  dashboard. Force re-sync is also available programmatically via API for monthly,
-      #  quarterly, and highest sync frequency customers on the Launch, Professional, or
-      #  Enterprise plans. Doing so will consume a sync credit for the relevant linked
-      #  account.
+      # Force re-sync of all models. This endpoint is available for monthly, quarterly,
+      #  and highest sync frequency customers on the Professional or Enterprise plans.
+      #  Doing so will consume a sync credit for the relevant linked account. Force
+      #  re-syncs can also be triggered manually in the Merge Dashboard and is available
+      #  for all customers.
       #
       # @param request_options [Merge::RequestOptions]
       # @return [Array<Merge::Filestorage::SyncStatus>]