files.com 1.1.768 → 1.1.770

data/lib/files.com/models/integration_centric_profile.rb

@@ -69,7 +69,9 @@ module Files
       raise InvalidParameterError.new("Bad parameter: expected_remote_servers must be an Array") if params[:expected_remote_servers] and !params[:expected_remote_servers].is_a?(Array)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
-      Api.send_request("/integration_centric_profiles/#{@attributes[:id]}", :patch, params, @options)
+      response, options = Api.send_request("/integration_centric_profiles/#{@attributes[:id]}", :patch, params, @options) { |reply| reply.require_object("IntegrationCentricProfile") }
+      @attributes = response.data
+      [ response, options ]
     end
 
     def delete(params = {})
@@ -89,12 +91,12 @@ module Files
 
     def save
       if @attributes[:id]
-        new_obj = update(@attributes)
+        update(@attributes)
       else
         new_obj = IntegrationCentricProfile.create(@attributes, @options)
+        @attributes = new_obj.attributes
       end
 
-      @attributes = new_obj.attributes
       true
     end
 
@@ -103,14 +105,19 @@ module Files
     #   per_page - int64 - Number of records to show per page.  (Max: 10000, 1,000 or less is recommended).
     #   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `workspace_id` and `name`.
     #   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `workspace_id`.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::List of Files::IntegrationCentricProfile objects.
     def self.list(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: cursor must be an String") if params[:cursor] and !params[:cursor].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: per_page must be an Integer") if params[:per_page] and !params[:per_page].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: sort_by must be an Hash") if params[:sort_by] and !params[:sort_by].is_a?(Hash)
       raise InvalidParameterError.new("Bad parameter: filter must be an Hash") if params[:filter] and !params[:filter].is_a?(Hash)
 
-      List.new(IntegrationCentricProfile, params) do
-        Api.send_request("/integration_centric_profiles", :get, params, options)
+      List.new(IntegrationCentricProfile, params) do |page_params, &check_page|
+        Api.send_request("/integration_centric_profiles", :get, page_params, options, &check_page)
       end
     end
 
@@ -120,13 +127,18 @@ module Files
 
     # Parameters:
     #   id (required) - int64 - Integration Centric Profile ID.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::IntegrationCentricProfile.
     def self.find(id, params = {}, options = {})
       params ||= {}
       params[:id] = id
       raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params[:id] and !params[:id].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
-      response, options = Api.send_request("/integration_centric_profiles/#{params[:id]}", :get, params, options)
+      response, options = Api.send_request("/integration_centric_profiles/#{params[:id]}", :get, params, options) { |reply| reply.require_object("IntegrationCentricProfile") }
       IntegrationCentricProfile.new(response.data, options)
     end
 
@@ -139,6 +151,11 @@ module Files
     #   expected_remote_servers (required) - array(object) - Remote Server integrations the user is expected to add and connect. Each entry requires `server_type` and may include a display `name`.
     #   workspace_id - int64 - Workspace ID
     #   use_for_all_users - boolean - Whether this profile applies to all users in the Workspace by default
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::IntegrationCentricProfile.
     def self.create(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: name must be an String") if params[:name] and !params[:name].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: expected_remote_servers must be an Array") if params[:expected_remote_servers] and !params[:expected_remote_servers].is_a?(Array)
@@ -146,7 +163,7 @@ module Files
       raise MissingParameterError.new("Parameter missing: name") unless params[:name]
       raise MissingParameterError.new("Parameter missing: expected_remote_servers") unless params[:expected_remote_servers]
 
-      response, options = Api.send_request("/integration_centric_profiles", :post, params, options)
+      response, options = Api.send_request("/integration_centric_profiles", :post, params, options) { |reply| reply.require_object("IntegrationCentricProfile") }
       IntegrationCentricProfile.new(response.data, options)
     end
 
@@ -155,6 +172,11 @@ module Files
     #   workspace_id - int64 - Workspace ID
     #   expected_remote_servers - array(object) - Remote Server integrations the user is expected to add and connect. Each entry requires `server_type` and may include a display `name`.
     #   use_for_all_users - boolean - Whether this profile applies to all users in the Workspace by default
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::IntegrationCentricProfile.
     def self.update(id, params = {}, options = {})
       params ||= {}
       params[:id] = id
@@ -164,10 +186,14 @@ module Files
       raise InvalidParameterError.new("Bad parameter: expected_remote_servers must be an Array") if params[:expected_remote_servers] and !params[:expected_remote_servers].is_a?(Array)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
-      response, options = Api.send_request("/integration_centric_profiles/#{params[:id]}", :patch, params, options)
+      response, options = Api.send_request("/integration_centric_profiles/#{params[:id]}", :patch, params, options) { |reply| reply.require_object("IntegrationCentricProfile") }
       IntegrationCentricProfile.new(response.data, options)
     end
 
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns nil.
     def self.delete(id, params = {}, options = {})
       params ||= {}
       params[:id] = id

data/lib/files.com/models/invoice.rb

@@ -85,12 +85,17 @@ module Files
     # Parameters:
     #   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
     #   per_page - int64 - Number of records to show per page.  (Max: 10000, 1,000 or less is recommended).
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::List of Files::AccountLineItem objects.
     def self.list(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: cursor must be an String") if params[:cursor] and !params[:cursor].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: per_page must be an Integer") if params[:per_page] and !params[:per_page].is_a?(Integer)
 
-      List.new(AccountLineItem, params) do
-        Api.send_request("/invoices", :get, params, options)
+      List.new(AccountLineItem, params) do |page_params, &check_page|
+        Api.send_request("/invoices", :get, page_params, options, &check_page)
       end
     end
 
@@ -100,13 +105,18 @@ module Files
 
     # Parameters:
     #   id (required) - int64 - Invoice ID.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::AccountLineItem.
     def self.find(id, params = {}, options = {})
       params ||= {}
       params[:id] = id
       raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params[:id] and !params[:id].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
-      response, options = Api.send_request("/invoices/#{params[:id]}", :get, params, options)
+      response, options = Api.send_request("/invoices/#{params[:id]}", :get, params, options) { |reply| reply.require_object("AccountLineItem") }
       AccountLineItem.new(response.data, options)
     end
 

data/lib/files.com/models/ip_address.rb

@@ -32,12 +32,17 @@ module Files
     # Parameters:
     #   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
     #   per_page - int64 - Number of records to show per page.  (Max: 10000, 1,000 or less is recommended).
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::List of Files::IpAddress objects.
     def self.list(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: cursor must be an String") if params[:cursor] and !params[:cursor].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: per_page must be an Integer") if params[:per_page] and !params[:per_page].is_a?(Integer)
 
-      List.new(IpAddress, params) do
-        Api.send_request("/ip_addresses", :get, params, options)
+      List.new(IpAddress, params) do |page_params, &check_page|
+        Api.send_request("/ip_addresses", :get, page_params, options, &check_page)
       end
     end
 
@@ -48,36 +53,51 @@ module Files
     # Parameters:
     #   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
     #   per_page - int64 - Number of records to show per page.  (Max: 10000, 1,000 or less is recommended).
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::List of Files::PublicIpAddress objects.
     def self.get_smartfile_reserved(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: cursor must be an String") if params[:cursor] and !params[:cursor].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: per_page must be an Integer") if params[:per_page] and !params[:per_page].is_a?(Integer)
 
-      List.new(PublicIpAddress, params) do
-        Api.send_request("/ip_addresses/smartfile-reserved", :get, params, options)
+      List.new(PublicIpAddress, params) do |page_params, &check_page|
+        Api.send_request("/ip_addresses/smartfile-reserved", :get, page_params, options, &check_page)
       end
     end
 
     # Parameters:
     #   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
     #   per_page - int64 - Number of records to show per page.  (Max: 10000, 1,000 or less is recommended).
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::List of Files::PublicIpAddress objects.
     def self.get_exavault_reserved(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: cursor must be an String") if params[:cursor] and !params[:cursor].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: per_page must be an Integer") if params[:per_page] and !params[:per_page].is_a?(Integer)
 
-      List.new(PublicIpAddress, params) do
-        Api.send_request("/ip_addresses/exavault-reserved", :get, params, options)
+      List.new(PublicIpAddress, params) do |page_params, &check_page|
+        Api.send_request("/ip_addresses/exavault-reserved", :get, page_params, options, &check_page)
       end
     end
 
     # Parameters:
     #   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
     #   per_page - int64 - Number of records to show per page.  (Max: 10000, 1,000 or less is recommended).
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::List of Files::PublicIpAddress objects.
     def self.get_reserved(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: cursor must be an String") if params[:cursor] and !params[:cursor].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: per_page must be an Integer") if params[:per_page] and !params[:per_page].is_a?(Integer)
 
-      List.new(PublicIpAddress, params) do
-        Api.send_request("/ip_addresses/reserved", :get, params, options)
+      List.new(PublicIpAddress, params) do |page_params, &check_page|
+        Api.send_request("/ip_addresses/reserved", :get, page_params, options, &check_page)
       end
     end
   end

data/lib/files.com/models/key_lifecycle_rule.rb

@@ -91,7 +91,9 @@ module Files
       raise InvalidParameterError.new("Bad parameter: workspace_id must be an Integer") if params[:workspace_id] and !params[:workspace_id].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
-      Api.send_request("/key_lifecycle_rules/#{@attributes[:id]}", :patch, params, @options)
+      response, options = Api.send_request("/key_lifecycle_rules/#{@attributes[:id]}", :patch, params, @options) { |reply| reply.require_object("KeyLifecycleRule") }
+      @attributes = response.data
+      [ response, options ]
     end
 
     def delete(params = {})
@@ -111,12 +113,12 @@ module Files
 
     def save
       if @attributes[:id]
-        new_obj = update(@attributes)
+        update(@attributes)
       else
         new_obj = KeyLifecycleRule.create(@attributes, @options)
+        @attributes = new_obj.attributes
       end
 
-      @attributes = new_obj.attributes
       true
     end
 
@@ -125,14 +127,19 @@ module Files
     #   per_page - int64 - Number of records to show per page.  (Max: 10000, 1,000 or less is recommended).
     #   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `workspace_id` and `key_type`.
     #   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `key_type` and `workspace_id`. Valid field combinations are `[ workspace_id, key_type ]`.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::List of Files::KeyLifecycleRule objects.
     def self.list(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: cursor must be an String") if params[:cursor] and !params[:cursor].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: per_page must be an Integer") if params[:per_page] and !params[:per_page].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: sort_by must be an Hash") if params[:sort_by] and !params[:sort_by].is_a?(Hash)
       raise InvalidParameterError.new("Bad parameter: filter must be an Hash") if params[:filter] and !params[:filter].is_a?(Hash)
 
-      List.new(KeyLifecycleRule, params) do
-        Api.send_request("/key_lifecycle_rules", :get, params, options)
+      List.new(KeyLifecycleRule, params) do |page_params, &check_page|
+        Api.send_request("/key_lifecycle_rules", :get, page_params, options, &check_page)
       end
     end
 
@@ -142,13 +149,18 @@ module Files
 
     # Parameters:
     #   id (required) - int64 - Key Lifecycle Rule ID.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::KeyLifecycleRule.
     def self.find(id, params = {}, options = {})
       params ||= {}
       params[:id] = id
       raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params[:id] and !params[:id].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
-      response, options = Api.send_request("/key_lifecycle_rules/#{params[:id]}", :get, params, options)
+      response, options = Api.send_request("/key_lifecycle_rules/#{params[:id]}", :get, params, options) { |reply| reply.require_object("KeyLifecycleRule") }
       KeyLifecycleRule.new(response.data, options)
     end
 
@@ -163,6 +175,11 @@ module Files
     #   inactivity_days - int64 - Number of days of inactivity before the rule applies.
     #   name - string - Key Lifecycle Rule name
     #   workspace_id - int64 - Workspace ID. `0` means the default workspace.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::KeyLifecycleRule.
     def self.create(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: expiration_days must be an Integer") if params[:expiration_days] and !params[:expiration_days].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: key_type must be an String") if params[:key_type] and !params[:key_type].is_a?(String)
@@ -170,7 +187,7 @@ module Files
       raise InvalidParameterError.new("Bad parameter: name must be an String") if params[:name] and !params[:name].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: workspace_id must be an Integer") if params[:workspace_id] and !params[:workspace_id].is_a?(Integer)
 
-      response, options = Api.send_request("/key_lifecycle_rules", :post, params, options)
+      response, options = Api.send_request("/key_lifecycle_rules", :post, params, options) { |reply| reply.require_object("KeyLifecycleRule") }
       KeyLifecycleRule.new(response.data, options)
     end
 
@@ -181,6 +198,11 @@ module Files
     #   inactivity_days - int64 - Number of days of inactivity before the rule applies.
     #   name - string - Key Lifecycle Rule name
     #   workspace_id - int64 - Workspace ID. `0` means the default workspace.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::KeyLifecycleRule.
     def self.update(id, params = {}, options = {})
       params ||= {}
       params[:id] = id
@@ -192,10 +214,14 @@ module Files
       raise InvalidParameterError.new("Bad parameter: workspace_id must be an Integer") if params[:workspace_id] and !params[:workspace_id].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
-      response, options = Api.send_request("/key_lifecycle_rules/#{params[:id]}", :patch, params, options)
+      response, options = Api.send_request("/key_lifecycle_rules/#{params[:id]}", :patch, params, options) { |reply| reply.require_object("KeyLifecycleRule") }
       KeyLifecycleRule.new(response.data, options)
     end
 
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns nil.
     def self.delete(id, params = {}, options = {})
       params ||= {}
       params[:id] = id

data/lib/files.com/models/lock.rb

@@ -156,6 +156,11 @@ module Files
     #   per_page - int64 - Number of records to show per page.  (Max: 10000, 1,000 or less is recommended).
     #   path (required) - string - Path to operate on.
     #   include_children - boolean - Include locks from children objects?
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::List of Files::Lock objects.
     def self.list_for(path, params = {}, options = {})
       params ||= {}
       params[:path] = path
@@ -164,8 +169,8 @@ module Files
       raise InvalidParameterError.new("Bad parameter: path must be an String") if params[:path] and !params[:path].is_a?(String)
       raise MissingParameterError.new("Parameter missing: path") unless params[:path]
 
-      List.new(Lock, params) do
-        Api.send_request("/locks/#{params[:path]}", :get, params, options)
+      List.new(Lock, params) do |page_params, &check_page|
+        Api.send_request("/locks/#{page_params[:path]}", :get, page_params, options, &check_page)
       end
     end
 
@@ -178,6 +183,11 @@ module Files
     #   recursive - boolean - Does lock apply to subfolders?
     #   owner - string - Arbitrary descriptive label for the lock. Does not change the lock creator or permissions.
     #   timeout - int64 - Lock timeout in seconds
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::Lock.
     def self.create(path, params = {}, options = {})
       params ||= {}
       params[:path] = path
@@ -188,12 +198,17 @@ module Files
       raise InvalidParameterError.new("Bad parameter: timeout must be an Integer") if params[:timeout] and !params[:timeout].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: path") unless params[:path]
 
-      response, options = Api.send_request("/locks/#{params[:path]}", :post, params, options)
+      response, options = Api.send_request("/locks/#{params[:path]}", :post, params, options) { |reply| reply.require_object("Lock") }
       Lock.new(response.data, options)
     end
 
     # Parameters:
     #   token (required) - string - Lock token
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns nil.
     def self.delete(path, params = {}, options = {})
       params ||= {}
       params[:path] = path

data/lib/files.com/models/metadata_category.rb

@@ -57,7 +57,9 @@ module Files
       raise InvalidParameterError.new("Bad parameter: default_columns must be an Array") if params[:default_columns] and !params[:default_columns].is_a?(Array)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
-      Api.send_request("/metadata_categories/#{@attributes[:id]}", :patch, params, @options)
+      response, options = Api.send_request("/metadata_categories/#{@attributes[:id]}", :patch, params, @options) { |reply| reply.require_object("MetadataCategory") }
+      @attributes = response.data
+      [ response, options ]
     end
 
     def delete(params = {})
@@ -77,12 +79,12 @@ module Files
 
     def save
       if @attributes[:id]
-        new_obj = update(@attributes)
+        update(@attributes)
       else
         new_obj = MetadataCategory.create(@attributes, @options)
+        @attributes = new_obj.attributes
       end
 
-      @attributes = new_obj.attributes
       true
     end
 
@@ -90,13 +92,18 @@ module Files
     #   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
     #   per_page - int64 - Number of records to show per page.  (Max: 10000, 1,000 or less is recommended).
     #   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are .
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::List of Files::MetadataCategory objects.
     def self.list(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: cursor must be an String") if params[:cursor] and !params[:cursor].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: per_page must be an Integer") if params[:per_page] and !params[:per_page].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: sort_by must be an Hash") if params[:sort_by] and !params[:sort_by].is_a?(Hash)
 
-      List.new(MetadataCategory, params) do
-        Api.send_request("/metadata_categories", :get, params, options)
+      List.new(MetadataCategory, params) do |page_params, &check_page|
+        Api.send_request("/metadata_categories", :get, page_params, options, &check_page)
       end
     end
 
@@ -106,13 +113,18 @@ module Files
 
     # Parameters:
     #   id (required) - int64 - Metadata Category ID.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::MetadataCategory.
     def self.find(id, params = {}, options = {})
       params ||= {}
       params[:id] = id
       raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params[:id] and !params[:id].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
-      response, options = Api.send_request("/metadata_categories/#{params[:id]}", :get, params, options)
+      response, options = Api.send_request("/metadata_categories/#{params[:id]}", :get, params, options) { |reply| reply.require_object("MetadataCategory") }
       MetadataCategory.new(response.data, options)
     end
 
@@ -124,6 +136,11 @@ module Files
     #   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
     #   per_page - int64 - Number of records to show per page.  (Max: 10000, 1,000 or less is recommended).
     #   path (required) - string - Path to operate on.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::List of Files::MetadataCategory objects.
     def self.list_for(path, params = {}, options = {})
       params ||= {}
       params[:path] = path
@@ -132,26 +149,36 @@ module Files
       raise InvalidParameterError.new("Bad parameter: path must be an String") if params[:path] and !params[:path].is_a?(String)
       raise MissingParameterError.new("Parameter missing: path") unless params[:path]
 
-      List.new(MetadataCategory, params) do
-        Api.send_request("/metadata_categories/list_by_path/#{params[:path]}", :get, params, options)
+      List.new(MetadataCategory, params) do |page_params, &check_page|
+        Api.send_request("/metadata_categories/list_by_path/#{page_params[:path]}", :get, page_params, options, &check_page)
       end
     end
 
     # Parameters:
     #   name (required) - string - Name of the metadata category.
     #   default_columns - array(string) - Metadata keys that should appear as columns in the UI by default.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::MetadataCategory.
     def self.create(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: name must be an String") if params[:name] and !params[:name].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: default_columns must be an Array") if params[:default_columns] and !params[:default_columns].is_a?(Array)
       raise MissingParameterError.new("Parameter missing: name") unless params[:name]
 
-      response, options = Api.send_request("/metadata_categories", :post, params, options)
+      response, options = Api.send_request("/metadata_categories", :post, params, options) { |reply| reply.require_object("MetadataCategory") }
       MetadataCategory.new(response.data, options)
     end
 
     # Parameters:
     #   name - string - Name of the metadata category.
     #   default_columns - array(string) - Metadata keys that should appear as columns in the UI by default.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::MetadataCategory.
     def self.update(id, params = {}, options = {})
       params ||= {}
       params[:id] = id
@@ -160,10 +187,14 @@ module Files
       raise InvalidParameterError.new("Bad parameter: default_columns must be an Array") if params[:default_columns] and !params[:default_columns].is_a?(Array)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
-      response, options = Api.send_request("/metadata_categories/#{params[:id]}", :patch, params, options)
+      response, options = Api.send_request("/metadata_categories/#{params[:id]}", :patch, params, options) { |reply| reply.require_object("MetadataCategory") }
       MetadataCategory.new(response.data, options)
     end
 
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns nil.
     def self.delete(id, params = {}, options = {})
       params ||= {}
       params[:id] = id

data/lib/files.com/models/notification.rb

@@ -273,7 +273,9 @@ module Files
       raise InvalidParameterError.new("Bad parameter: workspace_id must be an Integer") if params[:workspace_id] and !params[:workspace_id].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
-      Api.send_request("/notifications/#{@attributes[:id]}", :patch, params, @options)
+      response, options = Api.send_request("/notifications/#{@attributes[:id]}", :patch, params, @options) { |reply| reply.require_object("Notification") }
+      @attributes = response.data
+      [ response, options ]
     end
 
     def delete(params = {})
@@ -293,12 +295,12 @@ module Files
 
     def save
       if @attributes[:id]
-        new_obj = update(@attributes)
+        update(@attributes)
       else
         new_obj = Notification.create(@attributes, @options)
+        @attributes = new_obj.attributes
       end
 
-      @attributes = new_obj.attributes
       true
     end
 
@@ -311,6 +313,11 @@ module Files
     #   path - string - Show notifications for this Path.
     #   include_ancestors - boolean - If `include_ancestors` is `true` and `path` is specified, include notifications for any parent paths. Ignored if `path` is not specified.
     #   group_id - string
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::List of Files::Notification objects.
     def self.list(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: cursor must be an String") if params[:cursor] and !params[:cursor].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: per_page must be an Integer") if params[:per_page] and !params[:per_page].is_a?(Integer)
@@ -320,8 +327,8 @@ module Files
       raise InvalidParameterError.new("Bad parameter: path must be an String") if params[:path] and !params[:path].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: group_id must be an String") if params[:group_id] and !params[:group_id].is_a?(String)
 
-      List.new(Notification, params) do
-        Api.send_request("/notifications", :get, params, options)
+      List.new(Notification, params) do |page_params, &check_page|
+        Api.send_request("/notifications", :get, page_params, options, &check_page)
       end
     end
 
@@ -331,13 +338,18 @@ module Files
 
     # Parameters:
     #   id (required) - int64 - Notification ID.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::Notification.
     def self.find(id, params = {}, options = {})
       params ||= {}
       params[:id] = id
       raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params[:id] and !params[:id].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
-      response, options = Api.send_request("/notifications/#{params[:id]}", :get, params, options)
+      response, options = Api.send_request("/notifications/#{params[:id]}", :get, params, options) { |reply| reply.require_object("Notification") }
       Notification.new(response.data, options)
     end
 
@@ -366,6 +378,11 @@ module Files
     #   group_ids - string - Group IDs when the notification requires multiple groups. If sent as a string, it should be comma-delimited.
     #   path - string - Path
     #   username - string - The username of the user to notify.  Provide `user_id`, `username` or `group_id`.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::Notification.
     def self.create(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: user_id must be an Integer") if params[:user_id] and !params[:user_id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: send_interval must be an String") if params[:send_interval] and !params[:send_interval].is_a?(String)
@@ -380,7 +397,7 @@ module Files
       raise InvalidParameterError.new("Bad parameter: path must be an String") if params[:path] and !params[:path].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: username must be an String") if params[:username] and !params[:username].is_a?(String)
 
-      response, options = Api.send_request("/notifications", :post, params, options)
+      response, options = Api.send_request("/notifications", :post, params, options) { |reply| reply.require_object("Notification") }
       Notification.new(response.data, options)
     end
 
@@ -400,6 +417,11 @@ module Files
     #   triggering_user_ids - array(int64) - If set, will only notify on actions made one of the specified users
     #   trigger_by_share_recipients - boolean - Notify when actions are performed by a share recipient?
     #   workspace_id - int64 - Workspace ID. `0` means the default workspace.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::Notification.
     def self.update(id, params = {}, options = {})
       params ||= {}
       params[:id] = id
@@ -413,10 +435,14 @@ module Files
       raise InvalidParameterError.new("Bad parameter: workspace_id must be an Integer") if params[:workspace_id] and !params[:workspace_id].is_a?(Integer)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
-      response, options = Api.send_request("/notifications/#{params[:id]}", :patch, params, options)
+      response, options = Api.send_request("/notifications/#{params[:id]}", :patch, params, options) { |reply| reply.require_object("Notification") }
       Notification.new(response.data, options)
     end
 
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns nil.
     def self.delete(id, params = {}, options = {})
       params ||= {}
       params[:id] = id