files.com 1.1.768 → 1.1.770

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

@@ -101,9 +101,9 @@ module Files
         raise NotImplementedError.new("The Request object doesn't support updates.")
       else
         new_obj = Request.create(@attributes, @options)
+        @attributes = new_obj.attributes
       end
 
-      @attributes = new_obj.attributes
       true
     end
 
@@ -113,14 +113,19 @@ module Files
     #   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are .
     #   mine - boolean - Only show requests of the current user?  (Defaults to true if current user is not a site admin.)
     #   path - string - Path to show requests for.  If omitted, shows all paths. Send `/` to represent the root directory.
+    #
+    # 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::Request 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: path must be an String") if params[:path] and !params[:path].is_a?(String)
 
-      List.new(Request, params) do
-        Api.send_request("/requests", :get, params, options)
+      List.new(Request, params) do |page_params, &check_page|
+        Api.send_request("/requests", :get, page_params, options, &check_page)
       end
     end
 
@@ -134,6 +139,11 @@ module Files
     #   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are .
     #   mine - boolean - Only show requests of the current user?  (Defaults to true if current user is not a site admin.)
     #   path (required) - string - Path to show requests for.  If omitted, shows all paths. Send `/` to represent the root directory.
+    #
+    # 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::Request objects.
     def self.get_folder(path, params = {}, options = {})
       params ||= {}
       params[:path] = path
@@ -143,8 +153,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(Request, params) do
-        Api.send_request("/requests/folders/#{params[:path]}", :get, params, options)
+      List.new(Request, params) do |page_params, &check_page|
+        Api.send_request("/requests/folders/#{page_params[:path]}", :get, page_params, options, &check_page)
       end
     end
 
@@ -153,6 +163,11 @@ module Files
     #   destination (required) - string - Destination filename (without extension) to request.
     #   user_ids - string - A list of user IDs to request the file from. If sent as a string, it should be comma-delimited.
     #   group_ids - string - A list of group IDs to request the file from. If sent as a string, it should be comma-delimited.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::Request.
     def self.create(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: path must be an String") if params[:path] and !params[:path].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: destination must be an String") if params[:destination] and !params[:destination].is_a?(String)
@@ -161,10 +176,14 @@ module Files
       raise MissingParameterError.new("Parameter missing: path") unless params[:path]
       raise MissingParameterError.new("Parameter missing: destination") unless params[:destination]
 
-      response, options = Api.send_request("/requests", :post, params, options)
+      response, options = Api.send_request("/requests", :post, params, options) { |reply| reply.require_object("Request") }
       Request.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/restore.rb

@@ -212,9 +212,9 @@ module Files
         raise NotImplementedError.new("The Restore object doesn't support updates.")
       else
         new_obj = Restore.create(@attributes, @options)
+        @attributes = new_obj.attributes
       end
 
-      @attributes = new_obj.attributes
       true
     end
 
@@ -223,14 +223,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`.
     #   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `restoration_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::Restore 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(Restore, params) do
-        Api.send_request("/restores", :get, params, options)
+      List.new(Restore, params) do |page_params, &check_page|
+        Api.send_request("/restores", :get, page_params, options, &check_page)
       end
     end
 
@@ -246,6 +251,11 @@ module Files
     #   restore_in_place - boolean - If true, we will restore the files in place (into their original paths). If false, we will create a new restoration folder in the root and restore files there.
     #   update_timestamps - boolean - If true, we will update the last modified timestamp of restored files to today's date. If false, we might trigger File Expiration to delete the file again.
     #   workspace_id - int64 - Workspace ID for a workspace-scoped restore. `0` means the default site-wide scope.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::Restore.
     def self.create(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: earliest_date must be an String") if params[:earliest_date] and !params[:earliest_date].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: prefix must be an String") if params[:prefix] and !params[:prefix].is_a?(String)
@@ -253,7 +263,7 @@ 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: earliest_date") unless params[:earliest_date]
 
-      response, options = Api.send_request("/restores", :post, params, options)
+      response, options = Api.send_request("/restores", :post, params, options) { |reply| reply.require_object("Restore") }
       Restore.new(response.data, options)
     end
   end

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

@@ -100,7 +100,9 @@ module Files
       raise InvalidParameterError.new("Bad parameter: holiday_region must be an String") if params[:holiday_region] and !params[:holiday_region].is_a?(String)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
-      Api.send_request("/schedules/#{@attributes[:id]}", :patch, params, @options)
+      response, options = Api.send_request("/schedules/#{@attributes[:id]}", :patch, params, @options) { |reply| reply.require_object("Schedule") }
+      @attributes = response.data
+      [ response, options ]
     end
 
     def delete(params = {})
@@ -120,12 +122,12 @@ module Files
 
     def save
       if @attributes[:id]
-        new_obj = update(@attributes)
+        update(@attributes)
       else
         new_obj = Schedule.create(@attributes, @options)
+        @attributes = new_obj.attributes
       end
 
-      @attributes = new_obj.attributes
       true
     end
 
@@ -133,13 +135,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 `name`.
+    #
+    # 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::Schedule 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(Schedule, params) do
-        Api.send_request("/schedules", :get, params, options)
+      List.new(Schedule, params) do |page_params, &check_page|
+        Api.send_request("/schedules", :get, page_params, options, &check_page)
       end
     end
 
@@ -149,13 +156,18 @@ module Files
 
     # Parameters:
     #   id (required) - int64 - Schedule ID.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::Schedule.
     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("/schedules/#{params[:id]}", :get, params, options)
+      response, options = Api.send_request("/schedules/#{params[:id]}", :get, params, options) { |reply| reply.require_object("Schedule") }
       Schedule.new(response.data, options)
     end
 
@@ -169,6 +181,11 @@ module Files
     #   schedule_times_of_day (required) - array(string) - Times of day in HH:MM format (24-hour).
     #   schedule_time_zone - string - Time zone for scheduled times. If not set, times are interpreted as UTC.
     #   holiday_region - string - Optional holiday region on which linked resources do not run.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::Schedule.
     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: schedule_days_of_week must be an Array") if params[:schedule_days_of_week] and !params[:schedule_days_of_week].is_a?(Array)
@@ -179,7 +196,7 @@ module Files
       raise MissingParameterError.new("Parameter missing: schedule_days_of_week") unless params[:schedule_days_of_week]
       raise MissingParameterError.new("Parameter missing: schedule_times_of_day") unless params[:schedule_times_of_day]
 
-      response, options = Api.send_request("/schedules", :post, params, options)
+      response, options = Api.send_request("/schedules", :post, params, options) { |reply| reply.require_object("Schedule") }
       Schedule.new(response.data, options)
     end
 
@@ -189,6 +206,11 @@ module Files
     #   schedule_times_of_day - array(string) - Times of day in HH:MM format (24-hour).
     #   schedule_time_zone - string - Time zone for scheduled times. If not set, times are interpreted as UTC.
     #   holiday_region - string - Optional holiday region on which linked resources do not run.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::Schedule.
     def self.update(id, params = {}, options = {})
       params ||= {}
       params[:id] = id
@@ -200,10 +222,14 @@ module Files
       raise InvalidParameterError.new("Bad parameter: holiday_region must be an String") if params[:holiday_region] and !params[:holiday_region].is_a?(String)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
-      response, options = Api.send_request("/schedules/#{params[:id]}", :patch, params, options)
+      response, options = Api.send_request("/schedules/#{params[:id]}", :patch, params, options) { |reply| reply.require_object("Schedule") }
       Schedule.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/scheduled_export.rb

@@ -233,7 +233,9 @@ module Files
       raise InvalidParameterError.new("Bad parameter: holiday_region must be an String") if params[:holiday_region] and !params[:holiday_region].is_a?(String)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
-      Api.send_request("/scheduled_exports/#{@attributes[:id]}", :patch, params, @options)
+      response, options = Api.send_request("/scheduled_exports/#{@attributes[:id]}", :patch, params, @options) { |reply| reply.require_object("ScheduledExport") }
+      @attributes = response.data
+      [ response, options ]
     end
 
     def delete(params = {})
@@ -253,12 +255,12 @@ module Files
 
     def save
       if @attributes[:id]
-        new_obj = update(@attributes)
+        update(@attributes)
       else
         new_obj = ScheduledExport.create(@attributes, @options)
+        @attributes = new_obj.attributes
       end
 
-      @attributes = new_obj.attributes
       true
     end
 
@@ -268,6 +270,11 @@ module Files
     #   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `name`, `export_type` or `disabled`.
     #   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `disabled` and `export_type`.
     #   filter_prefix - object - If set, return records where the specified field is prefixed by the supplied value. Valid fields are `export_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::ScheduledExport 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)
@@ -275,8 +282,8 @@ module Files
       raise InvalidParameterError.new("Bad parameter: filter must be an Hash") if params[:filter] and !params[:filter].is_a?(Hash)
       raise InvalidParameterError.new("Bad parameter: filter_prefix must be an Hash") if params[:filter_prefix] and !params[:filter_prefix].is_a?(Hash)
 
-      List.new(ScheduledExport, params) do
-        Api.send_request("/scheduled_exports", :get, params, options)
+      List.new(ScheduledExport, params) do |page_params, &check_page|
+        Api.send_request("/scheduled_exports", :get, page_params, options, &check_page)
       end
     end
 
@@ -286,13 +293,18 @@ module Files
 
     # Parameters:
     #   id (required) - int64 - Scheduled Export ID.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::ScheduledExport.
     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("/scheduled_exports/#{params[:id]}", :get, params, options)
+      response, options = Api.send_request("/scheduled_exports/#{params[:id]}", :get, params, options) { |reply| reply.require_object("ScheduledExport") }
       ScheduledExport.new(response.data, options)
     end
 
@@ -315,6 +327,11 @@ module Files
     #   schedule_times_of_day - array(string) - Times of day in HH:MM format for the scheduled export schedule.
     #   schedule_time_zone - string - Time zone used by the scheduled export schedule.
     #   holiday_region - string - Optional holiday region used by the scheduled export schedule.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::ScheduledExport.
     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: export_type must be an String") if params[:export_type] and !params[:export_type].is_a?(String)
@@ -332,7 +349,7 @@ module Files
       raise MissingParameterError.new("Parameter missing: name") unless params[:name]
       raise MissingParameterError.new("Parameter missing: export_type") unless params[:export_type]
 
-      response, options = Api.send_request("/scheduled_exports", :post, params, options)
+      response, options = Api.send_request("/scheduled_exports", :post, params, options) { |reply| reply.require_object("ScheduledExport") }
       ScheduledExport.new(response.data, options)
     end
 
@@ -351,6 +368,11 @@ module Files
     #   schedule_times_of_day - array(string) - Times of day in HH:MM format for the scheduled export schedule.
     #   schedule_time_zone - string - Time zone used by the scheduled export schedule.
     #   holiday_region - string - Optional holiday region used by the scheduled export schedule.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::ScheduledExport.
     def self.update(id, params = {}, options = {})
       params ||= {}
       params[:id] = id
@@ -370,10 +392,14 @@ module Files
       raise InvalidParameterError.new("Bad parameter: holiday_region must be an String") if params[:holiday_region] and !params[:holiday_region].is_a?(String)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
-      response, options = Api.send_request("/scheduled_exports/#{params[:id]}", :patch, params, options)
+      response, options = Api.send_request("/scheduled_exports/#{params[:id]}", :patch, params, options) { |reply| reply.require_object("ScheduledExport") }
       ScheduledExport.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/scim_log.rb

@@ -53,13 +53,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 `created_at`.
+    #
+    # 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::ScimLog 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(ScimLog, params) do
-        Api.send_request("/scim_logs", :get, params, options)
+      List.new(ScimLog, params) do |page_params, &check_page|
+        Api.send_request("/scim_logs", :get, page_params, options, &check_page)
       end
     end
 
@@ -69,13 +74,18 @@ module Files
 
     # Parameters:
     #   id (required) - int64 - Scim Log ID.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::ScimLog.
     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("/scim_logs/#{params[:id]}", :get, params, options)
+      response, options = Api.send_request("/scim_logs/#{params[:id]}", :get, params, options) { |reply| reply.require_object("ScimLog") }
       ScimLog.new(response.data, options)
     end
 

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

@@ -97,7 +97,9 @@ module Files
       raise InvalidParameterError.new("Bad parameter: secret_type must be an String") if params[:secret_type] and !params[:secret_type].is_a?(String)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
-      Api.send_request("/secrets/#{@attributes[:id]}", :patch, params, @options)
+      response, options = Api.send_request("/secrets/#{@attributes[:id]}", :patch, params, @options) { |reply| reply.require_object("Secret") }
+      @attributes = response.data
+      [ response, options ]
     end
 
     def delete(params = {})
@@ -117,12 +119,12 @@ module Files
 
     def save
       if @attributes[:id]
-        new_obj = update(@attributes)
+        update(@attributes)
       else
         new_obj = Secret.create(@attributes, @options)
+        @attributes = new_obj.attributes
       end
 
-      @attributes = new_obj.attributes
       true
     end
 
@@ -132,6 +134,11 @@ module Files
     #   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `workspace_id`, `name` or `secret_type`.
     #   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `workspace_id`, `name` or `secret_type`. Valid field combinations are `[ workspace_id, name ]`, `[ workspace_id, secret_type ]`, `[ secret_type, name ]` or `[ workspace_id, secret_type, name ]`.
     #   filter_prefix - object - If set, return records where the specified field is prefixed by the supplied value. Valid fields are `name`.
+    #
+    # 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::Secret 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)
@@ -139,8 +146,8 @@ module Files
       raise InvalidParameterError.new("Bad parameter: filter must be an Hash") if params[:filter] and !params[:filter].is_a?(Hash)
       raise InvalidParameterError.new("Bad parameter: filter_prefix must be an Hash") if params[:filter_prefix] and !params[:filter_prefix].is_a?(Hash)
 
-      List.new(Secret, params) do
-        Api.send_request("/secrets", :get, params, options)
+      List.new(Secret, params) do |page_params, &check_page|
+        Api.send_request("/secrets", :get, page_params, options, &check_page)
       end
     end
 
@@ -150,13 +157,18 @@ module Files
 
     # Parameters:
     #   id (required) - int64 - Secret ID.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::Secret.
     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("/secrets/#{params[:id]}", :get, params, options)
+      response, options = Api.send_request("/secrets/#{params[:id]}", :get, params, options) { |reply| reply.require_object("Secret") }
       Secret.new(response.data, options)
     end
 
@@ -170,6 +182,11 @@ module Files
     #   secret_type (required) - string - Secret type.
     #   metadata - object - Non-secret metadata for the Secret type.
     #   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::Secret.
     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: description must be an String") if params[:description] and !params[:description].is_a?(String)
@@ -179,7 +196,7 @@ module Files
       raise MissingParameterError.new("Parameter missing: name") unless params[:name]
       raise MissingParameterError.new("Parameter missing: secret_type") unless params[:secret_type]
 
-      response, options = Api.send_request("/secrets", :post, params, options)
+      response, options = Api.send_request("/secrets", :post, params, options) { |reply| reply.require_object("Secret") }
       Secret.new(response.data, options)
     end
 
@@ -188,6 +205,11 @@ module Files
     #   description - string - Internal description for your reference.
     #   secret_type - string - Secret type.
     #   metadata - object - Non-secret metadata for the Secret type.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::Secret.
     def self.update(id, params = {}, options = {})
       params ||= {}
       params[:id] = id
@@ -198,10 +220,14 @@ module Files
       raise InvalidParameterError.new("Bad parameter: metadata must be an Hash") if params[:metadata] and !params[:metadata].is_a?(Hash)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
-      response, options = Api.send_request("/secrets/#{params[:id]}", :patch, params, options)
+      response, options = Api.send_request("/secrets/#{params[:id]}", :patch, params, options) { |reply| reply.require_object("Secret") }
       Secret.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/session.rb

@@ -90,9 +90,9 @@ module Files
         raise NotImplementedError.new("The Session object doesn't support updates.")
       else
         new_obj = Session.create(@attributes, @options)
+        @attributes = new_obj.attributes
       end
 
-      @attributes = new_obj.attributes
       true
     end
 
@@ -101,16 +101,25 @@ module Files
     #   password - string - Password for sign in
     #   otp - string - If this user has a 2FA device, provide its OTP or code here.
     #   partial_session_id - string - Identifier for a partially-completed login
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::Session.
     def self.create(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: username must be an String") if params[:username] and !params[:username].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: password must be an String") if params[:password] and !params[:password].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: otp must be an String") if params[:otp] and !params[:otp].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: partial_session_id must be an String") if params[:partial_session_id] and !params[:partial_session_id].is_a?(String)
 
-      response, options = Api.send_request("/sessions", :post, params, options)
+      response, options = Api.send_request("/sessions", :post, params, options) { |reply| reply.require_object("Session") }
       Session.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(params = {}, options = {})
       Api.send_request("/sessions", :delete, params, options)
       nil

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

@@ -49,14 +49,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 `created_at`, `api_key_id` or `user_id`.
     #   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `api_key_id` and `user_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::SettingsChange 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(SettingsChange, params) do
-        Api.send_request("/settings_changes", :get, params, options)
+      List.new(SettingsChange, params) do |page_params, &check_page|
+        Api.send_request("/settings_changes", :get, page_params, options, &check_page)
       end
     end