files.com 1.1.760 → 1.1.762

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 863eebcc7d0dfdd28d2ef610470ca2b796e28e0e6d32c4b8670ba423affe1e2a
-  data.tar.gz: 9538a214f58b655770f68af638e7311b9a93a820bb31e9c7f26db40fba282019
+  metadata.gz: cf73e3d192ff3f0f0c3080260cf28b789d40b244874762d11c567d7503134a50
+  data.tar.gz: e190c5b8448ee93c21c4dbe305fe4cacc40acf3fd177e85108e41b6b49ef2072
 SHA512:
-  metadata.gz: 3672c8b78beb7952a2a00114bbafd782c7baf70bddc752e6bb4a097eaf0c4e9177de6ef006e51f7cbc13cbb8ee2ee2eed71b87f985691049f605b6def7e81c28
-  data.tar.gz: 6068131aa6e7ef5e828bb41492f4f01dece6b2afe1ecaf8a0d1ad90f31d9dfaa9e644d72e7784d55aed7d0a8046dd9c047ee8cca887867b85258206d61f24289
+  metadata.gz: 329c7e14bceb7ad4d0543fe5ef2965b239347f5372fbdff69e0fba921bbfdcd6e6c64b61d349e2d0a9942b06adf9ad6911669a2fc3de9eb240e795f8e9f66c8c
+  data.tar.gz: 838cae9505b9f6e9e54e90d01dd1729a369b4d8317a9659adeb9e87000b785e898202395f403c2868f33c9c1b6f2c7cc9713bedf7922f4f35ec12c423a939390

data/_VERSION

@@ -1 +1 @@
-1.1.760
+1.1.762

data/docs/remote_server_credential.md

@@ -79,7 +79,7 @@ Files::RemoteServerCredential.list
 
 * `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 `workspace_id` and `id`.
+* `sort_by` (object): If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `workspace_id` and `name`.
 * `filter` (object): If set, return records where the specified field is equal to the supplied value. Valid fields are `workspace_id` and `name`. Valid field combinations are `[ workspace_id, name ]`.
 * `filter_prefix` (object): If set, return records where the specified field is prefixed by the supplied value. Valid fields are `name`.
 

data/docs/restore.md

@@ -31,7 +31,7 @@
 }
 ```
 
-* `earliest_date` (date-time): Restore all files deleted after this date/time. Don't set this earlier than you need. Can not be greater than 365 days prior to the restore request.
+* `earliest_date` (date-time): Restore files or users deleted on or after this date/time. Don't set this earlier than you need. Can not be greater than 365 days prior to the restore request.
 * `id` (int64): Restore Record ID.
 * `dirs_restored` (int64): Number of directories that were successfully restored.
 * `dirs_errored` (int64): Number of directories that were not able to be restored.
@@ -39,10 +39,10 @@
 * `files_restored` (int64): Number of files successfully restored.
 * `files_errored` (int64): Number of files that were not able to be restored.
 * `files_total` (int64): Total number of files processed.
-* `prefix` (string): Prefix of the files/folders to restore. To restore a folder, add a trailing slash to the folder name. Do not use a leading slash. To restore all deleted items, specify an empty string (`''`) in the prefix field or omit the field from the request.
-* `restoration_type` (string): Type of restoration to perform. `files` restores deleted filesystem items. `users` restores deleted users and associated access/authentication records.
+* `prefix` (string): Prefix of the files/folders to restore, or a case-insensitive username prefix for a user restore. To restore a folder, add a trailing slash to the folder name. Do not use a leading slash. To restore all deleted items of the selected restoration type, specify an empty string (`''`) in the prefix field or omit the field from the request.
+* `restoration_type` (string): Type of restoration to perform. `files` restores deleted filesystem items. `users` restores deleted users and associated access/authentication records removed as part of deleting those users.
 * `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.
-* `restore_deleted_permissions` (boolean): If true, we will also restore any Permissions that match the same path prefix from the same dates.
+* `restore_deleted_permissions` (boolean): If true, restore permissions removed as part of deleting the selected users for a user restore, or permissions matching the selected path prefix and deletion dates for a file restore.
 * `users_restored` (int64): Number of users successfully restored (only present for `restoration_type=users`).
 * `users_errored` (int64): Number of users that failed to restore (only present for `restoration_type=users`).
 * `users_total` (int64): Total number of users processed (only present for `restoration_type=users`).
@@ -89,10 +89,10 @@ Files::Restore.create(
 
 ### Parameters
 
-* `earliest_date` (string): Required - Restore all files deleted after this date/time. Don't set this earlier than you need. Can not be greater than 365 days prior to the restore request.
-* `prefix` (string): Prefix of the files/folders to restore. To restore a folder, add a trailing slash to the folder name. Do not use a leading slash. To restore all deleted items, specify an empty string (`''`) in the prefix field or omit the field from the request.
-* `restoration_type` (string): Type of restoration to perform. `files` restores deleted filesystem items. `users` restores deleted users and associated access/authentication records.
-* `restore_deleted_permissions` (boolean): If true, we will also restore any Permissions that match the same path prefix from the same dates.
+* `earliest_date` (string): Required - Restore files or users deleted on or after this date/time. Don't set this earlier than you need. Can not be greater than 365 days prior to the restore request.
+* `prefix` (string): Prefix of the files/folders to restore, or a case-insensitive username prefix for a user restore. To restore a folder, add a trailing slash to the folder name. Do not use a leading slash. To restore all deleted items of the selected restoration type, specify an empty string (`''`) in the prefix field or omit the field from the request.
+* `restoration_type` (string): Type of restoration to perform. `files` restores deleted filesystem items. `users` restores deleted users and associated access/authentication records removed as part of deleting those users.
+* `restore_deleted_permissions` (boolean): If true, restore permissions removed as part of deleting the selected users for a user restore, or permissions matching the selected path prefix and deletion dates for a file restore.
 * `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.

data/docs/site.md

@@ -251,6 +251,7 @@
   "smtp_authentication": "plain",
   "smtp_from": "me@my-mail-server.com",
   "smtp_port": 25,
+  "smtp_ssl": "require",
   "smtp_username": "mail",
   "session_expiry_minutes": 360,
   "snapshot_sharing_enabled": true,
@@ -545,6 +546,7 @@
 * `smtp_authentication` (string): SMTP server authentication type
 * `smtp_from` (string): From address to use when mailing through custom SMTP
 * `smtp_port` (int64): SMTP server port
+* `smtp_ssl` (string): Custom SMTP encryption mode: if_available (default) uses STARTTLS when offered and otherwise sends credentials and messages unencrypted; require requires STARTTLS before authentication; require_implicit uses TLS from connection start; never disables TLS. TLS verifies the server certificate against smtp_address.
 * `smtp_username` (string): SMTP server username
 * `session_expiry_minutes` (int64): Session expiry in minutes
 * `snapshot_sharing_enabled` (boolean): Allow snapshot share links creation
@@ -750,6 +752,7 @@ Files::Site.update(
   smtp_from: "me@my-mail-server.com", 
   smtp_username: "mail", 
   smtp_port: 1, 
+  smtp_ssl: "require", 
   ldap_enabled: false, 
   ldap_type: "open_ldap", 
   ldap_host: "ldap.site.com", 
@@ -936,6 +939,7 @@ Files::Site.update(
 * `smtp_from` (string): From address to use when mailing through custom SMTP
 * `smtp_username` (string): SMTP server username
 * `smtp_port` (int64): SMTP server port
+* `smtp_ssl` (string): Custom SMTP encryption mode: if_available (default) uses STARTTLS when offered and otherwise sends credentials and messages unencrypted; require requires STARTTLS before authentication; require_implicit uses TLS from connection start; never disables TLS. TLS verifies the server certificate against smtp_address.
 * `ldap_enabled` (boolean): Main LDAP setting: is LDAP enabled?
 * `ldap_type` (string): LDAP type
 * `ldap_host` (string): LDAP host

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

@@ -468,7 +468,7 @@ module Files
     # Parameters:
     #   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
     #   per_page - int64 - Number of records to show per page.  (Max: 10000, 1,000 or less is recommended).
-    #   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `workspace_id` and `id`.
+    #   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `workspace_id` and `name`.
     #   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `workspace_id` and `name`. Valid field combinations are `[ workspace_id, name ]`.
     #   filter_prefix - object - If set, return records where the specified field is prefixed by the supplied value. Valid fields are `name`.
     def self.list(params = {}, options = {})

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

@@ -9,7 +9,7 @@ module Files
       @options = options || {}
     end
 
-    # date-time - Restore all files deleted after this date/time. Don't set this earlier than you need. Can not be greater than 365 days prior to the restore request.
+    # date-time - Restore files or users deleted on or after this date/time. Don't set this earlier than you need. Can not be greater than 365 days prior to the restore request.
     def earliest_date
       @attributes[:earliest_date]
     end
@@ -81,7 +81,7 @@ module Files
       @attributes[:files_total] = value
     end
 
-    # string - Prefix of the files/folders to restore. To restore a folder, add a trailing slash to the folder name. Do not use a leading slash. To restore all deleted items, specify an empty string (`''`) in the prefix field or omit the field from the request.
+    # string - Prefix of the files/folders to restore, or a case-insensitive username prefix for a user restore. To restore a folder, add a trailing slash to the folder name. Do not use a leading slash. To restore all deleted items of the selected restoration type, specify an empty string (`''`) in the prefix field or omit the field from the request.
     def prefix
       @attributes[:prefix]
     end
@@ -90,7 +90,7 @@ module Files
       @attributes[:prefix] = value
     end
 
-    # string - Type of restoration to perform. `files` restores deleted filesystem items. `users` restores deleted users and associated access/authentication records.
+    # string - Type of restoration to perform. `files` restores deleted filesystem items. `users` restores deleted users and associated access/authentication records removed as part of deleting those users.
     def restoration_type
       @attributes[:restoration_type]
     end
@@ -108,7 +108,7 @@ module Files
       @attributes[:restore_in_place] = value
     end
 
-    # boolean - If true, we will also restore any Permissions that match the same path prefix from the same dates.
+    # boolean - If true, restore permissions removed as part of deleting the selected users for a user restore, or permissions matching the selected path prefix and deletion dates for a file restore.
     def restore_deleted_permissions
       @attributes[:restore_deleted_permissions]
     end
@@ -239,10 +239,10 @@ module Files
     end
 
     # Parameters:
-    #   earliest_date (required) - string - Restore all files deleted after this date/time. Don't set this earlier than you need. Can not be greater than 365 days prior to the restore request.
-    #   prefix - string - Prefix of the files/folders to restore. To restore a folder, add a trailing slash to the folder name. Do not use a leading slash. To restore all deleted items, specify an empty string (`''`) in the prefix field or omit the field from the request.
-    #   restoration_type - string - Type of restoration to perform. `files` restores deleted filesystem items. `users` restores deleted users and associated access/authentication records.
-    #   restore_deleted_permissions - boolean - If true, we will also restore any Permissions that match the same path prefix from the same dates.
+    #   earliest_date (required) - string - Restore files or users deleted on or after this date/time. Don't set this earlier than you need. Can not be greater than 365 days prior to the restore request.
+    #   prefix - string - Prefix of the files/folders to restore, or a case-insensitive username prefix for a user restore. To restore a folder, add a trailing slash to the folder name. Do not use a leading slash. To restore all deleted items of the selected restoration type, specify an empty string (`''`) in the prefix field or omit the field from the request.
+    #   restoration_type - string - Type of restoration to perform. `files` restores deleted filesystem items. `users` restores deleted users and associated access/authentication records removed as part of deleting those users.
+    #   restore_deleted_permissions - boolean - If true, restore permissions removed as part of deleting the selected users for a user restore, or permissions matching the selected path prefix and deletion dates for a file restore.
     #   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.

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

@@ -864,6 +864,11 @@ module Files
       @attributes[:smtp_port]
     end
 
+    # string - Custom SMTP encryption mode: if_available (default) uses STARTTLS when offered and otherwise sends credentials and messages unencrypted; require requires STARTTLS before authentication; require_implicit uses TLS from connection start; never disables TLS. TLS verifies the server certificate against smtp_address.
+    def smtp_ssl
+      @attributes[:smtp_ssl]
+    end
+
     # string - SMTP server username
     def smtp_username
       @attributes[:smtp_username]
@@ -1163,6 +1168,7 @@ module Files
     #   smtp_from - string - From address to use when mailing through custom SMTP
     #   smtp_username - string - SMTP server username
     #   smtp_port - int64 - SMTP server port
+    #   smtp_ssl - string - Custom SMTP encryption mode: if_available (default) uses STARTTLS when offered and otherwise sends credentials and messages unencrypted; require requires STARTTLS before authentication; require_implicit uses TLS from connection start; never disables TLS. TLS verifies the server certificate against smtp_address.
     #   ldap_enabled - boolean - Main LDAP setting: is LDAP enabled?
     #   ldap_type - string - LDAP type
     #   ldap_host - string - LDAP host
@@ -1260,6 +1266,7 @@ module Files
       raise InvalidParameterError.new("Bad parameter: smtp_from must be an String") if params[:smtp_from] and !params[:smtp_from].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: smtp_username must be an String") if params[:smtp_username] and !params[:smtp_username].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: smtp_port must be an Integer") if params[:smtp_port] and !params[:smtp_port].is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: smtp_ssl must be an String") if params[:smtp_ssl] and !params[:smtp_ssl].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: ldap_type must be an String") if params[:ldap_type] and !params[:ldap_type].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: ldap_host must be an String") if params[:ldap_host] and !params[:ldap_host].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: ldap_host_2 must be an String") if params[:ldap_host_2] and !params[:ldap_host_2].is_a?(String)

data/lib/files.com/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.760
+  version: 1.1.762
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-09-30 00:00:00.000000000 Z
+date: 2026-10-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable