files.com 1.1.688 → 1.1.689

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7f181535385996d0d40c60e0c3d9c14c90d769d55c9f752f8cd32c2bb17d5685
-  data.tar.gz: a4c7317d824fa206c98d5aa4b71717ce186882bae1fa74193000f2c9226f3ab5
+  metadata.gz: 02404110f3cdedb4da5150380628bc677dfd3a1e12b38db8d5b900ae7ef6e023
+  data.tar.gz: 3f6637df82c914605a58d9d655237ee2d9627b7c909eea1458aa4fbc4e662c99
 SHA512:
-  metadata.gz: 5738704b1affb4ad7e48767347170673d9b5729c8cc5642559c522f36aa4448d105b71a10af272c731b17675af76d2b5c6a98683a946bd73c8d11f8b25228559
-  data.tar.gz: 78f447f46acb0a6021ec8f4d97fbbb9801c758364e9a2bbd26a90a7af295e109cb29f21c6d4952149a311a1fa53aa0b522896423cfb74ab6d90f666c1950e523
+  metadata.gz: 480b89ae2ecaf15a3e3e59a36fe751250dcb427487cd5a11e2b01c79b54aef7f9b3b7673e859bcc694a38d7f74851c76ac8500c12899d3b58c45d4afca32a259
+  data.tar.gz: 16f9dab189c8479bd155e96515434238139052250536defe9483e2fa402f95156297b25830ad197281623cecbc8b6ecd24a7383112b1e1ce720162d72404afbf

data/_VERSION

@@ -1 +1 @@
-1.1.688
+1.1.689

data/docs/user_additional_email_recipient.md

@@ -0,0 +1,131 @@
+# UserAdditionalEmailRecipient
+
+## Example UserAdditionalEmailRecipient Object
+
+```
+{
+  "id": 1,
+  "user_id": 1,
+  "workspace_id": 1,
+  "email": "user-copy@example.com",
+  "created_at": "2000-01-01T01:00:00Z"
+}
+```
+
+* `id` (int64): User additional email recipient ID
+* `user_id` (int64): User ID
+* `workspace_id` (int64): Workspace ID (0 for default workspace).
+* `email` (string): Additional email recipient address
+* `created_at` (date-time): Created at date/time
+
+
+---
+
+## List User Additional Email Recipients
+
+```
+Files::UserAdditionalEmailRecipient.list(
+  user_id: 1
+)
+```
+
+### Parameters
+
+* `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
+* `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 `email`, `user_id` or `workspace_id`.
+* `filter` (object): If set, return records where the specified field is equal to the supplied value. Valid fields are `email` and `workspace_id`. Valid field combinations are `[ workspace_id, email ]`.
+* `filter_prefix` (object): If set, return records where the specified field is prefixed by the supplied value. Valid fields are `email`.
+
+
+---
+
+## Show User Additional Email Recipient
+
+```
+Files::UserAdditionalEmailRecipient.find(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - User Additional Email Recipient ID.
+
+
+---
+
+## Create User Additional Email Recipient
+
+```
+Files::UserAdditionalEmailRecipient.create(
+  user_id: 1, 
+  email: "user-copy@example.com"
+)
+```
+
+### Parameters
+
+* `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
+* `email` (string): Required - Additional email recipient address
+
+
+---
+
+## Update User Additional Email Recipient
+
+```
+Files::UserAdditionalEmailRecipient.update(id, 
+  email: "user-copy@example.com"
+)
+```
+
+### Parameters
+
+* `id` (int64): Required - User Additional Email Recipient ID.
+* `email` (string): Additional email recipient address
+
+
+---
+
+## Delete User Additional Email Recipient
+
+```
+Files::UserAdditionalEmailRecipient.delete(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - User Additional Email Recipient ID.
+
+
+---
+
+## Update User Additional Email Recipient
+
+```
+user_additional_email_recipient = Files::UserAdditionalEmailRecipient.find(id)
+
+user_additional_email_recipient.update(
+  email: "user-copy@example.com"
+)
+```
+
+### Parameters
+
+* `id` (int64): Required - User Additional Email Recipient ID.
+* `email` (string): Additional email recipient address
+
+
+---
+
+## Delete User Additional Email Recipient
+
+```
+user_additional_email_recipient = Files::UserAdditionalEmailRecipient.find(id)
+
+user_additional_email_recipient.delete
+```
+
+### Parameters
+
+* `id` (int64): Required - User Additional Email Recipient ID.

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

@@ -0,0 +1,172 @@
+# frozen_string_literal: true
+
+module Files
+  class UserAdditionalEmailRecipient
+    attr_reader :options, :attributes
+
+    def initialize(attributes = {}, options = {})
+      @attributes = attributes || {}
+      @options = options || {}
+    end
+
+    # int64 - User additional email recipient ID
+    def id
+      @attributes[:id]
+    end
+
+    def id=(value)
+      @attributes[:id] = value
+    end
+
+    # int64 - User ID
+    def user_id
+      @attributes[:user_id]
+    end
+
+    def user_id=(value)
+      @attributes[:user_id] = value
+    end
+
+    # int64 - Workspace ID (0 for default workspace).
+    def workspace_id
+      @attributes[:workspace_id]
+    end
+
+    def workspace_id=(value)
+      @attributes[:workspace_id] = value
+    end
+
+    # string - Additional email recipient address
+    def email
+      @attributes[:email]
+    end
+
+    def email=(value)
+      @attributes[:email] = value
+    end
+
+    # date-time - Created at date/time
+    def created_at
+      @attributes[:created_at]
+    end
+
+    # Parameters:
+    #   email - string - Additional email recipient address
+    def update(params = {})
+      params ||= {}
+      params[:id] = @attributes[:id]
+      raise MissingParameterError.new("Current object doesn't have a id") unless @attributes[:id]
+      raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params[:id] and !params[:id].is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: email must be an String") if params[:email] and !params[:email].is_a?(String)
+      raise MissingParameterError.new("Parameter missing: id") unless params[:id]
+
+      Api.send_request("/user_additional_email_recipients/#{@attributes[:id]}", :patch, params, @options)
+    end
+
+    def delete(params = {})
+      params ||= {}
+      params[:id] = @attributes[:id]
+      raise MissingParameterError.new("Current object doesn't have a id") unless @attributes[: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]
+
+      Api.send_request("/user_additional_email_recipients/#{@attributes[:id]}", :delete, params, @options)
+    end
+
+    def destroy(params = {})
+      delete(params)
+      nil
+    end
+
+    def save
+      if @attributes[:id]
+        new_obj = update(@attributes)
+      else
+        new_obj = UserAdditionalEmailRecipient.create(@attributes, @options)
+      end
+
+      @attributes = new_obj.attributes
+      true
+    end
+
+    # Parameters:
+    #   user_id - int64 - User ID.  Provide a value of `0` to operate the current session's user.
+    #   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 `email`, `user_id` or `workspace_id`.
+    #   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `email` and `workspace_id`. Valid field combinations are `[ workspace_id, email ]`.
+    #   filter_prefix - object - If set, return records where the specified field is prefixed by the supplied value. Valid fields are `email`.
+    def self.list(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: 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)
+      raise InvalidParameterError.new("Bad parameter: filter_prefix must be an Hash") if params[:filter_prefix] and !params[:filter_prefix].is_a?(Hash)
+
+      List.new(UserAdditionalEmailRecipient, params) do
+        Api.send_request("/user_additional_email_recipients", :get, params, options)
+      end
+    end
+
+    def self.all(params = {}, options = {})
+      list(params, options)
+    end
+
+    # Parameters:
+    #   id (required) - int64 - User Additional Email Recipient ID.
+    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("/user_additional_email_recipients/#{params[:id]}", :get, params, options)
+      UserAdditionalEmailRecipient.new(response.data, options)
+    end
+
+    def self.get(id, params = {}, options = {})
+      find(id, params, options)
+    end
+
+    # Parameters:
+    #   user_id - int64 - User ID.  Provide a value of `0` to operate the current session's user.
+    #   email (required) - string - Additional email recipient address
+    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: email must be an String") if params[:email] and !params[:email].is_a?(String)
+      raise MissingParameterError.new("Parameter missing: email") unless params[:email]
+
+      response, options = Api.send_request("/user_additional_email_recipients", :post, params, options)
+      UserAdditionalEmailRecipient.new(response.data, options)
+    end
+
+    # Parameters:
+    #   email - string - Additional email recipient address
+    def self.update(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 InvalidParameterError.new("Bad parameter: email must be an String") if params[:email] and !params[:email].is_a?(String)
+      raise MissingParameterError.new("Parameter missing: id") unless params[:id]
+
+      response, options = Api.send_request("/user_additional_email_recipients/#{params[:id]}", :patch, params, options)
+      UserAdditionalEmailRecipient.new(response.data, options)
+    end
+
+    def self.delete(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]
+
+      Api.send_request("/user_additional_email_recipients/#{params[:id]}", :delete, params, options)
+      nil
+    end
+
+    def self.destroy(id, params = {}, options = {})
+      delete(id, params, options)
+      nil
+    end
+  end
+end

data/lib/files.com/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Files
-  VERSION = "1.1.688"
+  VERSION = "1.1.689"
 end

data/lib/files.com.rb

@@ -167,6 +167,7 @@ require "files.com/models/usage_by_top_level_dir"
 require "files.com/models/usage_daily_snapshot"
 require "files.com/models/usage_snapshot"
 require "files.com/models/user"
+require "files.com/models/user_additional_email_recipient"
 require "files.com/models/user_cipher_use"
 require "files.com/models/user_lifecycle_rule"
 require "files.com/models/user_request"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.688
+  version: 1.1.689
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-07-17 00:00:00.000000000 Z
+date: 2026-07-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -306,6 +306,7 @@ files:
 - docs/usage_daily_snapshot.md
 - docs/usage_snapshot.md
 - docs/user.md
+- docs/user_additional_email_recipient.md
 - docs/user_cipher_use.md
 - docs/user_lifecycle_rule.md
 - docs/user_request.md
@@ -458,6 +459,7 @@ files:
 - lib/files.com/models/usage_daily_snapshot.rb
 - lib/files.com/models/usage_snapshot.rb
 - lib/files.com/models/user.rb
+- lib/files.com/models/user_additional_email_recipient.rb
 - lib/files.com/models/user_cipher_use.rb
 - lib/files.com/models/user_lifecycle_rule.rb
 - lib/files.com/models/user_request.rb