files.com 1.0.91

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

@@ -0,0 +1,179 @@
+# frozen_string_literal: true
+
+module Files
+  class Request
+    attr_reader :options, :attributes
+
+    def initialize(attributes = {}, options = {})
+      @attributes = attributes || {}
+      @options = options || {}
+    end
+
+    # int64 - Request ID
+    def id
+      @attributes[:id]
+    end
+
+    def id=(value)
+      @attributes[:id] = value
+    end
+
+    # string - Folder path This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
+    def path
+      @attributes[:path]
+    end
+
+    def path=(value)
+      @attributes[:path] = value
+    end
+
+    # string - Source filename, if applicable
+    def source
+      @attributes[:source]
+    end
+
+    def source=(value)
+      @attributes[:source] = value
+    end
+
+    # string - Destination filename
+    def destination
+      @attributes[:destination]
+    end
+
+    def destination=(value)
+      @attributes[:destination] = value
+    end
+
+    # string - ID of automation that created request
+    def automation_id
+      @attributes[:automation_id]
+    end
+
+    def automation_id=(value)
+      @attributes[:automation_id] = value
+    end
+
+    # string - User making the request (if applicable)
+    def user_display_name
+      @attributes[:user_display_name]
+    end
+
+    def user_display_name=(value)
+      @attributes[:user_display_name] = value
+    end
+
+    # string - A list of user IDs to request the file from. If sent as a string, it should be comma-delimited.
+    def user_ids
+      @attributes[:user_ids]
+    end
+
+    def user_ids=(value)
+      @attributes[:user_ids] = value
+    end
+
+    # string - A list of group IDs to request the file from. If sent as a string, it should be comma-delimited.
+    def group_ids
+      @attributes[:group_ids]
+    end
+
+    def group_ids=(value)
+      @attributes[:group_ids] = value
+    end
+
+    def save
+      if @attributes[:path]
+        raise NotImplementedError.new("The Request object doesn't support updates.")
+      else
+        new_obj = Request.create(@attributes, @options)
+        @attributes = new_obj.attributes
+      end
+    end
+
+    # Parameters:
+    #   page - int64 - Current page number.
+    #   per_page - int64 - Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
+    #   action - string - Deprecated: If set to `count` returns a count of matching records rather than the records themselves.
+    #   cursor - string - Send cursor to resume an existing list from the point at which you left off.  Get a cursor from an existing list via the X-Files-Cursor-Next header.
+    #   sort_by - object - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `site_id`, `folder_id` or `destination`.
+    #   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.
+    def self.list(path, params = {}, options = {})
+      params ||= {}
+      params[:path] = path
+      raise InvalidParameterError.new("Bad parameter: page must be an Integer") if params.dig(:page) and !params.dig(:page).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: per_page must be an Integer") if params.dig(:per_page) and !params.dig(:per_page).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: action must be an String") if params.dig(:action) and !params.dig(:action).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: cursor must be an String") if params.dig(:cursor) and !params.dig(:cursor).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: sort_by must be an Hash") if params.dig(:sort_by) and !params.dig(:sort_by).is_a?(Hash)
+      raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
+
+      List.new(Request, params) do
+        Api.send_request("/requests", :get, params, options)
+      end
+    end
+
+    def self.all(path, params = {}, options = {})
+      list(path, params, options)
+    end
+
+    # Parameters:
+    #   page - int64 - Current page number.
+    #   per_page - int64 - Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
+    #   action - string - Deprecated: If set to `count` returns a count of matching records rather than the records themselves.
+    #   cursor - string - Send cursor to resume an existing list from the point at which you left off.  Get a cursor from an existing list via the X-Files-Cursor-Next header.
+    #   sort_by - object - If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `site_id`, `folder_id` or `destination`.
+    #   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.
+    def self.find_folder(path, params = {}, options = {})
+      params ||= {}
+      params[:path] = path
+      raise InvalidParameterError.new("Bad parameter: page must be an Integer") if params.dig(:page) and !params.dig(:page).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: per_page must be an Integer") if params.dig(:per_page) and !params.dig(:per_page).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: action must be an String") if params.dig(:action) and !params.dig(:action).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: cursor must be an String") if params.dig(:cursor) and !params.dig(:cursor).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: sort_by must be an Hash") if params.dig(:sort_by) and !params.dig(:sort_by).is_a?(Hash)
+      raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
+      raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)
+
+      List.new(Request, params) do
+        Api.send_request("/requests/folders/#{params[:path]}", :get, params, options)
+      end
+    end
+
+    # Parameters:
+    #   path (required) - string - Folder path on which to request the file.
+    #   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.
+    def self.create(path, params = {}, options = {})
+      params ||= {}
+      params[:path] = path
+      raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: destination must be an String") if params.dig(:destination) and !params.dig(:destination).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: user_ids must be an String") if params.dig(:user_ids) and !params.dig(:user_ids).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: group_ids must be an String") if params.dig(:group_ids) and !params.dig(:group_ids).is_a?(String)
+      raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)
+      raise MissingParameterError.new("Parameter missing: destination") unless params.dig(:destination)
+
+      response, options = Api.send_request("/requests", :post, params, options)
+      Request.new(response.data, options)
+    end
+
+    # Parameters:
+    #   id (required) - int64 - Request ID.
+    def self.delete(id, params = {}, options = {})
+      params ||= {}
+      params[:id] = id
+      raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params.dig(:id) and !params.dig(:id).is_a?(Integer)
+      raise MissingParameterError.new("Parameter missing: id") unless params.dig(:id)
+
+      response, _options = Api.send_request("/requests/#{params[:id]}", :delete, params, options)
+      response.data
+    end
+
+    def self.destroy(id, params = {}, options = {})
+      delete(id, params, options)
+    end
+  end
+end

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

@@ -0,0 +1,247 @@
+# frozen_string_literal: true
+
+module Files
+  class Session
+    attr_reader :options, :attributes
+
+    def destroy(params = {}, options = {})
+      Session.destroy(params, options.merge(session: self, session_id: nil))
+    end
+
+    def initialize(attributes = {}, options = {})
+      @attributes = attributes || {}
+      @options = options || {}
+    end
+
+    # string - Session ID
+    def id
+      @attributes[:id]
+    end
+
+    def id=(value)
+      @attributes[:id] = value
+    end
+
+    # string - Session language
+    def language
+      @attributes[:language]
+    end
+
+    def language=(value)
+      @attributes[:language] = value
+    end
+
+    # string - Login token. If set, this token will allow your user to log in via browser at the domain in `login_token_domain`.
+    def login_token
+      @attributes[:login_token]
+    end
+
+    def login_token=(value)
+      @attributes[:login_token] = value
+    end
+
+    # string - Domain to use with `login_token`.
+    def login_token_domain
+      @attributes[:login_token_domain]
+    end
+
+    def login_token_domain=(value)
+      @attributes[:login_token_domain] = value
+    end
+
+    # int64 - Maximum number of files to retrieve per folder for a directory listing.  This is based on the user's plan.
+    def max_dir_listing_size
+      @attributes[:max_dir_listing_size]
+    end
+
+    def max_dir_listing_size=(value)
+      @attributes[:max_dir_listing_size] = value
+    end
+
+    # boolean - Can access multiple regions?
+    def multiple_regions
+      @attributes[:multiple_regions]
+    end
+
+    def multiple_regions=(value)
+      @attributes[:multiple_regions] = value
+    end
+
+    # boolean - Is this session read only?
+    def read_only
+      @attributes[:read_only]
+    end
+
+    def read_only=(value)
+      @attributes[:read_only] = value
+    end
+
+    # string - Initial root path to start the user's session in.
+    def root_path
+      @attributes[:root_path]
+    end
+
+    def root_path=(value)
+      @attributes[:root_path] = value
+    end
+
+    # int64 - Site ID
+    def site_id
+      @attributes[:site_id]
+    end
+
+    def site_id=(value)
+      @attributes[:site_id] = value
+    end
+
+    # boolean - Is SSL required for this user?  (If so, ensure all your communications with this user use SSL.)
+    def ssl_required
+      @attributes[:ssl_required]
+    end
+
+    def ssl_required=(value)
+      @attributes[:ssl_required] = value
+    end
+
+    # boolean - Is strong TLS disabled for this user? (If this is set to true, the site administrator has signaled that it is ok to use less secure TLS versions for this user.)
+    def tls_disabled
+      @attributes[:tls_disabled]
+    end
+
+    def tls_disabled=(value)
+      @attributes[:tls_disabled] = value
+    end
+
+    # boolean - If true, this user needs to add a Two Factor Authentication method before performing any further actions.
+    def two_factor_setup_needed
+      @attributes[:two_factor_setup_needed]
+    end
+
+    def two_factor_setup_needed=(value)
+      @attributes[:two_factor_setup_needed] = value
+    end
+
+    # boolean - Sent only if 2FA setup is needed. Is SMS two factor authentication allowed?
+    def allowed_2fa_method_sms
+      @attributes[:allowed_2fa_method_sms]
+    end
+
+    def allowed_2fa_method_sms=(value)
+      @attributes[:allowed_2fa_method_sms] = value
+    end
+
+    # boolean - Sent only if 2FA setup is needed. Is TOTP two factor authentication allowed?
+    def allowed_2fa_method_totp
+      @attributes[:allowed_2fa_method_totp]
+    end
+
+    def allowed_2fa_method_totp=(value)
+      @attributes[:allowed_2fa_method_totp] = value
+    end
+
+    # boolean - Sent only if 2FA setup is needed. Is U2F two factor authentication allowed?
+    def allowed_2fa_method_u2f
+      @attributes[:allowed_2fa_method_u2f]
+    end
+
+    def allowed_2fa_method_u2f=(value)
+      @attributes[:allowed_2fa_method_u2f] = value
+    end
+
+    # boolean - Sent only if 2FA setup is needed. Is Yubikey two factor authentication allowed?
+    def allowed_2fa_method_yubi
+      @attributes[:allowed_2fa_method_yubi]
+    end
+
+    def allowed_2fa_method_yubi=(value)
+      @attributes[:allowed_2fa_method_yubi] = value
+    end
+
+    # boolean - Allow the user to provide file/folder modified at dates?  If false, the server will always use the current date/time.
+    def use_provided_modified_at
+      @attributes[:use_provided_modified_at]
+    end
+
+    def use_provided_modified_at=(value)
+      @attributes[:use_provided_modified_at] = value
+    end
+
+    # boolean - Does this user want to use Windows line-ending emulation?  (CR vs CRLF)
+    def windows_mode_ftp
+      @attributes[:windows_mode_ftp]
+    end
+
+    def windows_mode_ftp=(value)
+      @attributes[:windows_mode_ftp] = value
+    end
+
+    # string - Username to sign in as
+    def username
+      @attributes[:username]
+    end
+
+    def username=(value)
+      @attributes[:username] = value
+    end
+
+    # string - Password for sign in
+    def password
+      @attributes[:password]
+    end
+
+    def password=(value)
+      @attributes[:password] = value
+    end
+
+    # string - If this user has a 2FA device, provide its OTP or code here.
+    def otp
+      @attributes[:otp]
+    end
+
+    def otp=(value)
+      @attributes[:otp] = value
+    end
+
+    # string - Identifier for a partially-completed login
+    def partial_session_id
+      @attributes[:partial_session_id]
+    end
+
+    def partial_session_id=(value)
+      @attributes[:partial_session_id] = value
+    end
+
+    def save
+      if @attributes[:id]
+        raise NotImplementedError.new("The Session object doesn't support updates.")
+      else
+        new_obj = Session.create(@attributes, @options)
+        @attributes = new_obj.attributes
+      end
+    end
+
+    # Parameters:
+    #   username - string - Username to sign in as
+    #   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
+    def self.create(params = {}, options = {})
+      raise InvalidParameterError.new("Bad parameter: username must be an String") if params.dig(:username) and !params.dig(:username).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: password must be an String") if params.dig(:password) and !params.dig(:password).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: otp must be an String") if params.dig(:otp) and !params.dig(:otp).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: partial_session_id must be an String") if params.dig(:partial_session_id) and !params.dig(:partial_session_id).is_a?(String)
+
+      response, options = Api.send_request("/sessions", :post, params, options)
+      Session.new(response.data, options)
+    end
+
+    def self.delete(params = {}, options = {})
+      response, _options = Api.send_request("/sessions", :delete, params, options)
+      response.data
+    end
+
+    def self.destroy(params = {}, options = {})
+      delete(params, options)
+    end
+  end
+end

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

@@ -0,0 +1,733 @@
+# frozen_string_literal: true
+
+module Files
+  class Site
+    attr_reader :options, :attributes
+
+    def initialize(attributes = {}, options = {})
+      @attributes = attributes || {}
+      @options = options || {}
+    end
+
+    # string - Site name
+    def name
+      @attributes[:name]
+    end
+
+    # boolean - Is SMS two factor authentication allowed?
+    def allowed_2fa_method_sms
+      @attributes[:allowed_2fa_method_sms]
+    end
+
+    # boolean - Is TOTP two factor authentication allowed?
+    def allowed_2fa_method_totp
+      @attributes[:allowed_2fa_method_totp]
+    end
+
+    # boolean - Is U2F two factor authentication allowed?
+    def allowed_2fa_method_u2f
+      @attributes[:allowed_2fa_method_u2f]
+    end
+
+    # boolean - Is yubikey two factor authentication allowed?
+    def allowed_2fa_method_yubi
+      @attributes[:allowed_2fa_method_yubi]
+    end
+
+    # int64 - User ID for the main site administrator
+    def admin_user_id
+      @attributes[:admin_user_id]
+    end
+
+    # boolean - Are manual Bundle names allowed?
+    def allow_bundle_names
+      @attributes[:allow_bundle_names]
+    end
+
+    # string - List of allowed IP addresses
+    def allowed_ips
+      @attributes[:allowed_ips]
+    end
+
+    # boolean - If false, rename conflicting files instead of asking for overwrite confirmation.  Only applies to web interface.
+    def ask_about_overwrites
+      @attributes[:ask_about_overwrites]
+    end
+
+    # int64 - Site-wide Bundle expiration in days
+    def bundle_expiration
+      @attributes[:bundle_expiration]
+    end
+
+    # boolean - Do Bundles require password protection?
+    def bundle_password_required
+      @attributes[:bundle_password_required]
+    end
+
+    # string - Page link and button color
+    def color2_left
+      @attributes[:color2_left]
+    end
+
+    # string - Top bar link color
+    def color2_link
+      @attributes[:color2_link]
+    end
+
+    # string - Page link and button color
+    def color2_text
+      @attributes[:color2_text]
+    end
+
+    # string - Top bar background color
+    def color2_top
+      @attributes[:color2_top]
+    end
+
+    # string - Top bar text color
+    def color2_top_text
+      @attributes[:color2_top_text]
+    end
+
+    # date-time - Time this site was created
+    def created_at
+      @attributes[:created_at]
+    end
+
+    # string - Preferred currency
+    def currency
+      @attributes[:currency]
+    end
+
+    # boolean - Is this site using a custom namespace for users?
+    def custom_namespace
+      @attributes[:custom_namespace]
+    end
+
+    # int64 - Number of days to keep deleted files
+    def days_to_retain_backups
+      @attributes[:days_to_retain_backups]
+    end
+
+    # string - Site default time zone
+    def default_time_zone
+      @attributes[:default_time_zone]
+    end
+
+    # boolean - Is the desktop app enabled?
+    def desktop_app
+      @attributes[:desktop_app]
+    end
+
+    # boolean - Is desktop app session IP pinning enabled?
+    def desktop_app_session_ip_pinning
+      @attributes[:desktop_app_session_ip_pinning]
+    end
+
+    # int64 - Desktop app session lifetime (in hours)
+    def desktop_app_session_lifetime
+      @attributes[:desktop_app_session_lifetime]
+    end
+
+    # boolean - Are notifications disabled?
+    def disable_notifications
+      @attributes[:disable_notifications]
+    end
+
+    # boolean - Is password reset disabled?
+    def disable_password_reset
+      @attributes[:disable_password_reset]
+    end
+
+    # string - Custom domain
+    def domain
+      @attributes[:domain]
+    end
+
+    # email - Main email for this site
+    def email
+      @attributes[:email]
+    end
+
+    # boolean - If true, groups can be manually created / modified / deleted by Site Admins. Otherwise, groups can only be managed via your SSO provider.
+    def non_sso_groups_allowed
+      @attributes[:non_sso_groups_allowed]
+    end
+
+    # boolean - If true, users can be manually created / modified / deleted by Site Admins. Otherwise, users can only be managed via your SSO provider.
+    def non_sso_users_allowed
+      @attributes[:non_sso_users_allowed]
+    end
+
+    # boolean - If true, permissions for this site must be bound to a group (not a user). Otherwise, permissions must be bound to a user.
+    def folder_permissions_groups_only
+      @attributes[:folder_permissions_groups_only]
+    end
+
+    # boolean - Is there a signed HIPAA BAA between Files.com and this site?
+    def hipaa
+      @attributes[:hipaa]
+    end
+
+    # Branded icon 128x128
+    def icon128
+      @attributes[:icon128]
+    end
+
+    # Branded icon 16x16
+    def icon16
+      @attributes[:icon16]
+    end
+
+    # Branded icon 32x32
+    def icon32
+      @attributes[:icon32]
+    end
+
+    # Branded icon 48x48
+    def icon48
+      @attributes[:icon48]
+    end
+
+    # date-time - Can files be modified?
+    def immutable_files_set_at
+      @attributes[:immutable_files_set_at]
+    end
+
+    # boolean - Include password in emails to new users?
+    def include_password_in_welcome_email
+      @attributes[:include_password_in_welcome_email]
+    end
+
+    # string - Site default language
+    def language
+      @attributes[:language]
+    end
+
+    # string - Base DN for looking up users in LDAP server
+    def ldap_base_dn
+      @attributes[:ldap_base_dn]
+    end
+
+    # string - Domain name that will be appended to usernames
+    def ldap_domain
+      @attributes[:ldap_domain]
+    end
+
+    # boolean - Main LDAP setting: is LDAP enabled?
+    def ldap_enabled
+      @attributes[:ldap_enabled]
+    end
+
+    # string - Should we sync groups from LDAP server?
+    def ldap_group_action
+      @attributes[:ldap_group_action]
+    end
+
+    # string - Comma or newline separated list of group names (with optional wildcards) to exclude when syncing.
+    def ldap_group_exclusion
+      @attributes[:ldap_group_exclusion]
+    end
+
+    # string - Comma or newline separated list of group names (with optional wildcards) to include when syncing.
+    def ldap_group_inclusion
+      @attributes[:ldap_group_inclusion]
+    end
+
+    # string - LDAP host
+    def ldap_host
+      @attributes[:ldap_host]
+    end
+
+    # string - LDAP backup host
+    def ldap_host_2
+      @attributes[:ldap_host_2]
+    end
+
+    # string - LDAP backup host
+    def ldap_host_3
+      @attributes[:ldap_host_3]
+    end
+
+    # int64 - LDAP port
+    def ldap_port
+      @attributes[:ldap_port]
+    end
+
+    # boolean - Use secure LDAP?
+    def ldap_secure
+      @attributes[:ldap_secure]
+    end
+
+    # string - LDAP type
+    def ldap_type
+      @attributes[:ldap_type]
+    end
+
+    # string - Should we sync users from LDAP server?
+    def ldap_user_action
+      @attributes[:ldap_user_action]
+    end
+
+    # string - Comma or newline separated list of group names (with optional wildcards) - if provided, only users in these groups will be added or synced.
+    def ldap_user_include_groups
+      @attributes[:ldap_user_include_groups]
+    end
+
+    # string - Username for signing in to LDAP server.
+    def ldap_username
+      @attributes[:ldap_username]
+    end
+
+    # string - LDAP username field
+    def ldap_username_field
+      @attributes[:ldap_username_field]
+    end
+
+    # string - Login help text
+    def login_help_text
+      @attributes[:login_help_text]
+    end
+
+    # Branded logo
+    def logo
+      @attributes[:logo]
+    end
+
+    # int64 - Number of prior passwords to disallow
+    def max_prior_passwords
+      @attributes[:max_prior_passwords]
+    end
+
+    # double - Next billing amount
+    def next_billing_amount
+      @attributes[:next_billing_amount]
+    end
+
+    # string - Next billing date
+    def next_billing_date
+      @attributes[:next_billing_date]
+    end
+
+    # boolean - Allow users to use Office for the web?
+    def office_integration_available
+      @attributes[:office_integration_available]
+    end
+
+    # boolean - Use servers in the USA only?
+    def opt_out_global
+      @attributes[:opt_out_global]
+    end
+
+    # date-time - Last time the site was notified about an overage
+    def overage_notified_at
+      @attributes[:overage_notified_at]
+    end
+
+    # boolean - Notify site email of overages?
+    def overage_notify
+      @attributes[:overage_notify]
+    end
+
+    # boolean - Is this site's billing overdue?
+    def overdue
+      @attributes[:overdue]
+    end
+
+    # int64 - Shortest password length for users
+    def password_min_length
+      @attributes[:password_min_length]
+    end
+
+    # boolean - Require a letter in passwords?
+    def password_require_letter
+      @attributes[:password_require_letter]
+    end
+
+    # boolean - Require lower and upper case letters in passwords?
+    def password_require_mixed
+      @attributes[:password_require_mixed]
+    end
+
+    # boolean - Require a number in passwords?
+    def password_require_number
+      @attributes[:password_require_number]
+    end
+
+    # boolean - Require special characters in password?
+    def password_require_special
+      @attributes[:password_require_special]
+    end
+
+    # boolean - Require passwords that have not been previously breached? (see https://haveibeenpwned.com/)
+    def password_require_unbreached
+      @attributes[:password_require_unbreached]
+    end
+
+    # boolean - Require bundles' passwords, and passwords for other items (inboxes, public shares, etc.) to conform to the same requirements as users' passwords?
+    def password_requirements_apply_to_bundles
+      @attributes[:password_requirements_apply_to_bundles]
+    end
+
+    # int64 - Number of days password is valid
+    def password_validity_days
+      @attributes[:password_validity_days]
+    end
+
+    # string - Site phone number
+    def phone
+      @attributes[:phone]
+    end
+
+    # boolean - Require two-factor authentication for all users?
+    def require_2fa
+      @attributes[:require_2fa]
+    end
+
+    # date-time - If set, requirement for two-factor authentication has been scheduled to end on this date-time.
+    def require_2fa_stop_time
+      @attributes[:require_2fa_stop_time]
+    end
+
+    # string - What type of user is required to use two-factor authentication (when require_2fa is set to `true` for this site)?
+    def require_2fa_user_type
+      @attributes[:require_2fa_user_type]
+    end
+
+    # Current session
+    def session
+      @attributes[:session]
+    end
+
+    # boolean - Are sessions locked to the same IP? (i.e. do users need to log in again if they change IPs?)
+    def session_pinned_by_ip
+      @attributes[:session_pinned_by_ip]
+    end
+
+    # boolean - Use user FTP roots also for SFTP?
+    def sftp_user_root_enabled
+      @attributes[:sftp_user_root_enabled]
+    end
+
+    # boolean - Allow bundle creation
+    def sharing_enabled
+      @attributes[:sharing_enabled]
+    end
+
+    # boolean - Show request access link for users without access?  Currently unused.
+    def show_request_access_link
+      @attributes[:show_request_access_link]
+    end
+
+    # string - Custom site footer text
+    def site_footer
+      @attributes[:site_footer]
+    end
+
+    # string - Custom site header text
+    def site_header
+      @attributes[:site_header]
+    end
+
+    # string - SMTP server hostname or IP
+    def smtp_address
+      @attributes[:smtp_address]
+    end
+
+    # string - SMTP server authentication type
+    def smtp_authentication
+      @attributes[:smtp_authentication]
+    end
+
+    # string - From address to use when mailing through custom SMTP
+    def smtp_from
+      @attributes[:smtp_from]
+    end
+
+    # int64 - SMTP server port
+    def smtp_port
+      @attributes[:smtp_port]
+    end
+
+    # string - SMTP server username
+    def smtp_username
+      @attributes[:smtp_username]
+    end
+
+    # double - Session expiry in hours
+    def session_expiry
+      @attributes[:session_expiry]
+    end
+
+    # boolean - Is SSL required?  Disabling this is insecure.
+    def ssl_required
+      @attributes[:ssl_required]
+    end
+
+    # string - Site subdomain
+    def subdomain
+      @attributes[:subdomain]
+    end
+
+    # date-time - If switching plans, when does the new plan take effect?
+    def switch_to_plan_date
+      @attributes[:switch_to_plan_date]
+    end
+
+    # boolean - Is TLS disabled(site setting)?
+    def tls_disabled
+      @attributes[:tls_disabled]
+    end
+
+    # int64 - Number of days left in trial
+    def trial_days_left
+      @attributes[:trial_days_left]
+    end
+
+    # date-time - When does this Site trial expire?
+    def trial_until
+      @attributes[:trial_until]
+    end
+
+    # date-time - Last time this Site was updated
+    def updated_at
+      @attributes[:updated_at]
+    end
+
+    # boolean - Allow uploaders to set `provided_modified_at` for uploaded files?
+    def use_provided_modified_at
+      @attributes[:use_provided_modified_at]
+    end
+
+    # User of current session
+    def user
+      @attributes[:user]
+    end
+
+    # boolean - Will users be locked out after incorrect login attempts?
+    def user_lockout
+      @attributes[:user_lockout]
+    end
+
+    # int64 - How many hours to lock user out for failed password?
+    def user_lockout_lock_period
+      @attributes[:user_lockout_lock_period]
+    end
+
+    # int64 - Number of login tries within `user_lockout_within` hours before users are locked out
+    def user_lockout_tries
+      @attributes[:user_lockout_tries]
+    end
+
+    # int64 - Number of hours for user lockout window
+    def user_lockout_within
+      @attributes[:user_lockout_within]
+    end
+
+    # boolean - Enable User Requests feature
+    def user_requests_enabled
+      @attributes[:user_requests_enabled]
+    end
+
+    # string - Custom text send in user welcome email
+    def welcome_custom_text
+      @attributes[:welcome_custom_text]
+    end
+
+    # email - Include this email in welcome emails if enabled
+    def welcome_email_cc
+      @attributes[:welcome_email_cc]
+    end
+
+    # boolean - Will the welcome email be sent to new users?
+    def welcome_email_enabled
+      @attributes[:welcome_email_enabled]
+    end
+
+    # string - Does the welcome screen appear?
+    def welcome_screen
+      @attributes[:welcome_screen]
+    end
+
+    # boolean - Does FTP user Windows emulation mode?
+    def windows_mode_ftp
+      @attributes[:windows_mode_ftp]
+    end
+
+    # int64 - If greater than zero, users will unable to login if they do not show activity within this number of days.
+    def disable_users_from_inactivity_period_days
+      @attributes[:disable_users_from_inactivity_period_days]
+    end
+
+    def self.get(params = {}, options = {})
+      response, options = Api.send_request("/site", :get, params, options)
+      Site.new(response.data, options)
+    end
+
+    def self.get_usage(params = {}, options = {})
+      response, options = Api.send_request("/site/usage", :get, params, options)
+      UsageSnapshot.new(response.data, options)
+    end
+
+    # Parameters:
+    #   name - string - Site name
+    #   subdomain - string - Site subdomain
+    #   domain - string - Custom domain
+    #   email - string - Main email for this site
+    #   allow_bundle_names - boolean - Are manual Bundle names allowed?
+    #   bundle_expiration - int64 - Site-wide Bundle expiration in days
+    #   overage_notify - boolean - Notify site email of overages?
+    #   welcome_email_enabled - boolean - Will the welcome email be sent to new users?
+    #   ask_about_overwrites - boolean - If false, rename conflicting files instead of asking for overwrite confirmation.  Only applies to web interface.
+    #   show_request_access_link - boolean - Show request access link for users without access?  Currently unused.
+    #   welcome_email_cc - string - Include this email in welcome emails if enabled
+    #   welcome_custom_text - string - Custom text send in user welcome email
+    #   language - string - Site default language
+    #   windows_mode_ftp - boolean - Does FTP user Windows emulation mode?
+    #   default_time_zone - string - Site default time zone
+    #   desktop_app - boolean - Is the desktop app enabled?
+    #   desktop_app_session_ip_pinning - boolean - Is desktop app session IP pinning enabled?
+    #   desktop_app_session_lifetime - int64 - Desktop app session lifetime (in hours)
+    #   folder_permissions_groups_only - boolean - If true, permissions for this site must be bound to a group (not a user). Otherwise, permissions must be bound to a user.
+    #   welcome_screen - string - Does the welcome screen appear?
+    #   office_integration_available - boolean - Allow users to use Office for the web?
+    #   session_expiry - double - Session expiry in hours
+    #   ssl_required - boolean - Is SSL required?  Disabling this is insecure.
+    #   tls_disabled - boolean - Is TLS disabled(site setting)?
+    #   user_lockout - boolean - Will users be locked out after incorrect login attempts?
+    #   user_lockout_tries - int64 - Number of login tries within `user_lockout_within` hours before users are locked out
+    #   user_lockout_within - int64 - Number of hours for user lockout window
+    #   user_lockout_lock_period - int64 - How many hours to lock user out for failed password?
+    #   include_password_in_welcome_email - boolean - Include password in emails to new users?
+    #   allowed_ips - string - List of allowed IP addresses
+    #   days_to_retain_backups - int64 - Number of days to keep deleted files
+    #   max_prior_passwords - int64 - Number of prior passwords to disallow
+    #   password_validity_days - int64 - Number of days password is valid
+    #   password_min_length - int64 - Shortest password length for users
+    #   password_require_letter - boolean - Require a letter in passwords?
+    #   password_require_mixed - boolean - Require lower and upper case letters in passwords?
+    #   password_require_special - boolean - Require special characters in password?
+    #   password_require_number - boolean - Require a number in passwords?
+    #   password_require_unbreached - boolean - Require passwords that have not been previously breached? (see https://haveibeenpwned.com/)
+    #   sftp_user_root_enabled - boolean - Use user FTP roots also for SFTP?
+    #   disable_password_reset - boolean - Is password reset disabled?
+    #   immutable_files - boolean - Are files protected from modification?
+    #   session_pinned_by_ip - boolean - Are sessions locked to the same IP? (i.e. do users need to log in again if they change IPs?)
+    #   bundle_password_required - boolean - Do Bundles require password protection?
+    #   password_requirements_apply_to_bundles - boolean - Require bundles' passwords, and passwords for other items (inboxes, public shares, etc.) to conform to the same requirements as users' passwords?
+    #   opt_out_global - boolean - Use servers in the USA only?
+    #   use_provided_modified_at - boolean - Allow uploaders to set `provided_modified_at` for uploaded files?
+    #   custom_namespace - boolean - Is this site using a custom namespace for users?
+    #   disable_users_from_inactivity_period_days - int64 - If greater than zero, users will unable to login if they do not show activity within this number of days.
+    #   non_sso_groups_allowed - boolean - If true, groups can be manually created / modified / deleted by Site Admins. Otherwise, groups can only be managed via your SSO provider.
+    #   non_sso_users_allowed - boolean - If true, users can be manually created / modified / deleted by Site Admins. Otherwise, users can only be managed via your SSO provider.
+    #   sharing_enabled - boolean - Allow bundle creation
+    #   user_requests_enabled - boolean - Enable User Requests feature
+    #   allowed_2fa_method_sms - boolean - Is SMS two factor authentication allowed?
+    #   allowed_2fa_method_u2f - boolean - Is U2F two factor authentication allowed?
+    #   allowed_2fa_method_totp - boolean - Is TOTP two factor authentication allowed?
+    #   allowed_2fa_method_yubi - boolean - Is yubikey two factor authentication allowed?
+    #   require_2fa - boolean - Require two-factor authentication for all users?
+    #   require_2fa_user_type - string - What type of user is required to use two-factor authentication (when require_2fa is set to `true` for this site)?
+    #   color2_top - string - Top bar background color
+    #   color2_left - string - Page link and button color
+    #   color2_link - string - Top bar link color
+    #   color2_text - string - Page link and button color
+    #   color2_top_text - string - Top bar text color
+    #   site_header - string - Custom site header text
+    #   site_footer - string - Custom site footer text
+    #   login_help_text - string - Login help text
+    #   smtp_address - string - SMTP server hostname or IP
+    #   smtp_authentication - string - SMTP server authentication type
+    #   smtp_from - string - From address to use when mailing through custom SMTP
+    #   smtp_username - string - SMTP server username
+    #   smtp_port - int64 - SMTP server port
+    #   ldap_enabled - boolean - Main LDAP setting: is LDAP enabled?
+    #   ldap_type - string - LDAP type
+    #   ldap_host - string - LDAP host
+    #   ldap_host_2 - string - LDAP backup host
+    #   ldap_host_3 - string - LDAP backup host
+    #   ldap_port - int64 - LDAP port
+    #   ldap_secure - boolean - Use secure LDAP?
+    #   ldap_username - string - Username for signing in to LDAP server.
+    #   ldap_username_field - string - LDAP username field
+    #   ldap_domain - string - Domain name that will be appended to usernames
+    #   ldap_user_action - string - Should we sync users from LDAP server?
+    #   ldap_group_action - string - Should we sync groups from LDAP server?
+    #   ldap_user_include_groups - string - Comma or newline separated list of group names (with optional wildcards) - if provided, only users in these groups will be added or synced.
+    #   ldap_group_exclusion - string - Comma or newline separated list of group names (with optional wildcards) to exclude when syncing.
+    #   ldap_group_inclusion - string - Comma or newline separated list of group names (with optional wildcards) to include when syncing.
+    #   ldap_base_dn - string - Base DN for looking up users in LDAP server
+    #   icon16_file - file
+    #   icon16_delete - boolean - If true, will delete the file stored in icon16
+    #   icon32_file - file
+    #   icon32_delete - boolean - If true, will delete the file stored in icon32
+    #   icon48_file - file
+    #   icon48_delete - boolean - If true, will delete the file stored in icon48
+    #   icon128_file - file
+    #   icon128_delete - boolean - If true, will delete the file stored in icon128
+    #   logo_file - file
+    #   logo_delete - boolean - If true, will delete the file stored in logo
+    #   disable_2fa_with_delay - boolean - If set to true, we will begin the process of disabling 2FA on this site.
+    #   ldap_password_change - string - New LDAP password.
+    #   ldap_password_change_confirmation - string - Confirm new LDAP password.
+    #   smtp_password - string - Password for SMTP server.
+    def self.update(params = {}, options = {})
+      raise InvalidParameterError.new("Bad parameter: name must be an String") if params.dig(:name) and !params.dig(:name).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: subdomain must be an String") if params.dig(:subdomain) and !params.dig(:subdomain).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: domain must be an String") if params.dig(:domain) and !params.dig(:domain).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: email must be an String") if params.dig(:email) and !params.dig(:email).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: bundle_expiration must be an Integer") if params.dig(:bundle_expiration) and !params.dig(:bundle_expiration).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: welcome_email_cc must be an String") if params.dig(:welcome_email_cc) and !params.dig(:welcome_email_cc).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: welcome_custom_text must be an String") if params.dig(:welcome_custom_text) and !params.dig(:welcome_custom_text).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: language must be an String") if params.dig(:language) and !params.dig(:language).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: default_time_zone must be an String") if params.dig(:default_time_zone) and !params.dig(:default_time_zone).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: desktop_app_session_lifetime must be an Integer") if params.dig(:desktop_app_session_lifetime) and !params.dig(:desktop_app_session_lifetime).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: welcome_screen must be an String") if params.dig(:welcome_screen) and !params.dig(:welcome_screen).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: session_expiry must be an Float") if params.dig(:session_expiry) and !params.dig(:session_expiry).is_a?(Float)
+      raise InvalidParameterError.new("Bad parameter: user_lockout_tries must be an Integer") if params.dig(:user_lockout_tries) and !params.dig(:user_lockout_tries).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: user_lockout_within must be an Integer") if params.dig(:user_lockout_within) and !params.dig(:user_lockout_within).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: user_lockout_lock_period must be an Integer") if params.dig(:user_lockout_lock_period) and !params.dig(:user_lockout_lock_period).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: allowed_ips must be an String") if params.dig(:allowed_ips) and !params.dig(:allowed_ips).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: days_to_retain_backups must be an Integer") if params.dig(:days_to_retain_backups) and !params.dig(:days_to_retain_backups).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: max_prior_passwords must be an Integer") if params.dig(:max_prior_passwords) and !params.dig(:max_prior_passwords).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: password_validity_days must be an Integer") if params.dig(:password_validity_days) and !params.dig(:password_validity_days).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: password_min_length must be an Integer") if params.dig(:password_min_length) and !params.dig(:password_min_length).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: disable_users_from_inactivity_period_days must be an Integer") if params.dig(:disable_users_from_inactivity_period_days) and !params.dig(:disable_users_from_inactivity_period_days).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: require_2fa_user_type must be an String") if params.dig(:require_2fa_user_type) and !params.dig(:require_2fa_user_type).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: color2_top must be an String") if params.dig(:color2_top) and !params.dig(:color2_top).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: color2_left must be an String") if params.dig(:color2_left) and !params.dig(:color2_left).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: color2_link must be an String") if params.dig(:color2_link) and !params.dig(:color2_link).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: color2_text must be an String") if params.dig(:color2_text) and !params.dig(:color2_text).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: color2_top_text must be an String") if params.dig(:color2_top_text) and !params.dig(:color2_top_text).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: site_header must be an String") if params.dig(:site_header) and !params.dig(:site_header).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: site_footer must be an String") if params.dig(:site_footer) and !params.dig(:site_footer).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: login_help_text must be an String") if params.dig(:login_help_text) and !params.dig(:login_help_text).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: smtp_address must be an String") if params.dig(:smtp_address) and !params.dig(:smtp_address).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: smtp_authentication must be an String") if params.dig(:smtp_authentication) and !params.dig(:smtp_authentication).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: smtp_from must be an String") if params.dig(:smtp_from) and !params.dig(:smtp_from).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: smtp_username must be an String") if params.dig(:smtp_username) and !params.dig(:smtp_username).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: smtp_port must be an Integer") if params.dig(:smtp_port) and !params.dig(:smtp_port).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: ldap_type must be an String") if params.dig(:ldap_type) and !params.dig(:ldap_type).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: ldap_host must be an String") if params.dig(:ldap_host) and !params.dig(:ldap_host).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: ldap_host_2 must be an String") if params.dig(:ldap_host_2) and !params.dig(:ldap_host_2).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: ldap_host_3 must be an String") if params.dig(:ldap_host_3) and !params.dig(:ldap_host_3).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: ldap_port must be an Integer") if params.dig(:ldap_port) and !params.dig(:ldap_port).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: ldap_username must be an String") if params.dig(:ldap_username) and !params.dig(:ldap_username).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: ldap_username_field must be an String") if params.dig(:ldap_username_field) and !params.dig(:ldap_username_field).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: ldap_domain must be an String") if params.dig(:ldap_domain) and !params.dig(:ldap_domain).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: ldap_user_action must be an String") if params.dig(:ldap_user_action) and !params.dig(:ldap_user_action).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: ldap_group_action must be an String") if params.dig(:ldap_group_action) and !params.dig(:ldap_group_action).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: ldap_user_include_groups must be an String") if params.dig(:ldap_user_include_groups) and !params.dig(:ldap_user_include_groups).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: ldap_group_exclusion must be an String") if params.dig(:ldap_group_exclusion) and !params.dig(:ldap_group_exclusion).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: ldap_group_inclusion must be an String") if params.dig(:ldap_group_inclusion) and !params.dig(:ldap_group_inclusion).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: ldap_base_dn must be an String") if params.dig(:ldap_base_dn) and !params.dig(:ldap_base_dn).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: ldap_password_change must be an String") if params.dig(:ldap_password_change) and !params.dig(:ldap_password_change).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: ldap_password_change_confirmation must be an String") if params.dig(:ldap_password_change_confirmation) and !params.dig(:ldap_password_change_confirmation).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: smtp_password must be an String") if params.dig(:smtp_password) and !params.dig(:smtp_password).is_a?(String)
+
+      response, options = Api.send_request("/site", :patch, params, options)
+      Site.new(response.data, options)
+    end
+  end
+end