files.com 1.1.308 → 1.1.310

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d92592a5f32cc6407758f4759c192b59478ca26a2ad2819737d466ed8d13fa8e
-  data.tar.gz: 1e8201a7d236b576dac9f94bd8b34215ccc643f8d49f565ad18a466e98814097
+  metadata.gz: 6ce1185b83e43ac2f0ed150a9a155b9b185a5c507a336662d68ea32474163693
+  data.tar.gz: 1b6381d8c2a4fbbaec22c4a59272028716cfe2a5457126a60d2f86a5ba2e2ac0
 SHA512:
-  metadata.gz: 6e385cbe54e4b721030f670cfcef7ec96067058160420d3ade1531c2ca456361b827460c55913b24f6798c0355eb575ced36075e3c10735c019c219e43798c97
-  data.tar.gz: b81e4580098fe594c507e85585fbda9bf86be0e2ae379b741aa4f8f115ff8b4f4a2a93a7a0b5739c7f2973cefd8a8ee8e7e1dbb1d9bccdfc23b37971524c17a4
+  metadata.gz: 67e3746e74cec4bccfb809c4a266f942ba02ee0182d316913acf9a43b7a77d5afa9eb1de19c40bdbbeab6f5f3fa43117406a82c88f814ad666c55b8b6e64fc9a
+  data.tar.gz: 3dd482ab685b322663c2b28a2ee657c65431537e77dc4d9c0255a1d92fc341cdc7bac6b31e61968eeb9902e8bf0b668921d24b7e0717431206b6fd8cf52e2323

data/README.md

@@ -335,6 +335,61 @@ rescue Files::Error => e
 end
 ```
 
+## Paths
+
+Working with paths in Files.com involves several important considerations. Understanding how path comparisons are applied helps developers ensure consistency and accuracy across all interactions with the platform.
+<div></div>
+
+### Capitalization
+
+Files.com compares paths in a **case-insensitive** manner. This means path segments are treated as equivalent regardless of letter casing.
+
+For example, all of the following resolve to the same internal path:
+
+| Path Variant                          | Interpreted As              |
+|---------------------------------------|------------------------------|
+| `Documents/Reports/Q1.pdf`            | `documents/reports/q1.pdf`  |
+| `documents/reports/q1.PDF`            | `documents/reports/q1.pdf`  |
+| `DOCUMENTS/REPORTS/Q1.PDF`            | `documents/reports/q1.pdf`  |
+
+This behavior applies across:
+- API requests
+- Folder and file lookup operations
+- Automations and workflows
+
+See also: [Case Sensitivity Documentation](https://www.files.com/docs/files-and-folders/case-sensitivity/)
+
+### Slashes
+
+All path parameters in Files.com (API, SDKs, CLI, automations, integrations) must **omit leading and trailing slashes**. Paths are always treated as **absolute and slash-delimited**, so only internal `/` separators are used and never at the start or end of the string.
+
+####  Path Slash Examples
+| Path                              | Valid? | Notes                         |
+|-----------------------------------|--------|-------------------------------|
+| `folder/subfolder/file.txt`       |   ✅   | Correct, internal separators only |
+| `/folder/subfolder/file.txt`      |   ❌   | Leading slash not allowed     |
+| `folder/subfolder/file.txt/`      |   ❌   | Trailing slash not allowed    |
+| `//folder//file.txt`              |   ❌   | Duplicate separators not allowed |
+
+<div></div>
+
+### Unicode Normalization
+
+Files.com normalizes all paths using [Unicode NFC (Normalization Form C)](https://www.unicode.org/reports/tr15/#Norm_Forms) before comparison. This ensures consistency across different representations of the same characters.
+
+For example, the following two paths are treated as equivalent after NFC normalization:
+
+| Input                                  | Normalized Form       |
+|----------------------------------------|------------------------|
+| `uploads/\u0065\u0301.txt`             | `uploads/é.txt`        |
+| `docs/Café/Report.txt`                 | `docs/Café/Report.txt` |
+
+- All input must be UTF‑8 encoded.
+- Precomposed and decomposed characters are unified.
+- This affects search, deduplication, and comparisons across SDKs.
+
+<div></div>
+
 ## Foreign Language Support
 
 The Files.com Ruby SDK supports localized responses by using the `Files.language` configuration attribute.
@@ -609,10 +664,6 @@ rescue Files::Error => e
 end
 ```
 
-## Case Sensitivity
-
-The Files.com API compares files and paths in a case-insensitive manner. For related documentation see [Case Sensitivity Documentation](https://www.files.com/docs/files-and-folders/file-system-semantics/case-sensitivity).
-
 ## Mock Server
 
 Files.com publishes a Files.com API server, which is useful for testing your use of the Files.com

data/_VERSION

@@ -1 +1 @@
-1.1.308
+1.1.310

data/docs/child_site_management_policy.md

@@ -0,0 +1,138 @@
+# ChildSiteManagementPolicy
+
+## Example ChildSiteManagementPolicy Object
+
+```
+{
+  "id": 1,
+  "site_id": 1,
+  "site_setting_name": "color2_left",
+  "managed_value": "#FF0000",
+  "skip_child_site_ids": [
+    1,
+    5
+  ]
+}
+```
+
+* `id` (int64): ChildSiteManagementPolicy ID
+* `site_id` (int64): ID of the Site managing the policy
+* `site_setting_name` (string): The name of the setting that is managed by the policy
+* `managed_value` (string): The value for the setting that will be enforced for all child sites that are not exempt
+* `skip_child_site_ids` (array(int64)): The list of child site IDs that are exempt from this policy
+
+
+---
+
+## List Child Site Management Policies
+
+```
+Files::ChildSiteManagementPolicy.list
+```
+
+### 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: 10,000, 1,000 or less is recommended).
+
+
+---
+
+## Show Child Site Management Policy
+
+```
+Files::ChildSiteManagementPolicy.find(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Child Site Management Policy ID.
+
+
+---
+
+## Create Child Site Management Policy
+
+```
+Files::ChildSiteManagementPolicy.create(
+  site_setting_name: "color2_left", 
+  managed_value: "#FF0000", 
+  skip_child_site_ids: [1,5]
+)
+```
+
+### Parameters
+
+* `site_setting_name` (string): Required - The name of the setting that is managed by the policy
+* `managed_value` (string): Required - The value for the setting that will be enforced for all child sites that are not exempt
+* `skip_child_site_ids` (array(int64)): The list of child site IDs that are exempt from this policy
+
+
+---
+
+## Update Child Site Management Policy
+
+```
+Files::ChildSiteManagementPolicy.update(id, 
+  site_setting_name: "color2_left", 
+  managed_value: "#FF0000", 
+  skip_child_site_ids: [1,5]
+)
+```
+
+### Parameters
+
+* `id` (int64): Required - Child Site Management Policy ID.
+* `site_setting_name` (string): Required - The name of the setting that is managed by the policy
+* `managed_value` (string): Required - The value for the setting that will be enforced for all child sites that are not exempt
+* `skip_child_site_ids` (array(int64)): The list of child site IDs that are exempt from this policy
+
+
+---
+
+## Delete Child Site Management Policy
+
+```
+Files::ChildSiteManagementPolicy.delete(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Child Site Management Policy ID.
+
+
+---
+
+## Update Child Site Management Policy
+
+```
+child_site_management_policy = Files::ChildSiteManagementPolicy.find(id)
+
+child_site_management_policy.update(
+  site_setting_name: "color2_left",
+  managed_value: "#FF0000",
+  skip_child_site_ids: [1,5]
+)
+```
+
+### Parameters
+
+* `id` (int64): Required - Child Site Management Policy ID.
+* `site_setting_name` (string): Required - The name of the setting that is managed by the policy
+* `managed_value` (string): Required - The value for the setting that will be enforced for all child sites that are not exempt
+* `skip_child_site_ids` (array(int64)): The list of child site IDs that are exempt from this policy
+
+
+---
+
+## Delete Child Site Management Policy
+
+```
+child_site_management_policy = Files::ChildSiteManagementPolicy.find(id)
+
+child_site_management_policy.delete
+```
+
+### Parameters
+
+* `id` (int64): Required - Child Site Management Policy ID.

data/docs/remote_server_configuration_file.md

@@ -59,7 +59,7 @@ Examples:
 * 10 requests/minute: '10-M'
 * 1000 requests/hour: '1000-H'
 * 2000 requests/day: '2000-D'
-* `auto_update_policy` (string): Auto update policy ['manual_trigger', 'critical_only', 'always'] (default critical_only)
+* `auto_update_policy` (string): Auto update policy ['manual_trigger', 'critical_only', 'always', 'never'] (default critical_only)
 * `api_token` (string): Files Agent API Token
 * `port` (int64): Incoming port for files agent connections
 * `hostname` (string): 

data/docs/site.md

@@ -300,7 +300,10 @@
   "welcome_email_enabled": true,
   "welcome_screen": "user_controlled",
   "windows_mode_ftp": true,
-  "group_admins_can_set_user_password": true
+  "group_admins_can_set_user_password": true,
+  "managed_site_settings": [
+    "example"
+  ]
 }
 ```
 
@@ -475,6 +478,7 @@
 * `welcome_screen` (string): Does the welcome screen appear?
 * `windows_mode_ftp` (boolean): Does FTP user Windows emulation mode?
 * `group_admins_can_set_user_password` (boolean): Allow group admins set password authentication method
+* `managed_site_settings` (array(string)): List of site settings managed by the parent site
 
 
 ---

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

@@ -0,0 +1,183 @@
+# frozen_string_literal: true
+
+module Files
+  class ChildSiteManagementPolicy
+    attr_reader :options, :attributes
+
+    def initialize(attributes = {}, options = {})
+      @attributes = attributes || {}
+      @options = options || {}
+    end
+
+    # int64 - ChildSiteManagementPolicy ID
+    def id
+      @attributes[:id]
+    end
+
+    def id=(value)
+      @attributes[:id] = value
+    end
+
+    # int64 - ID of the Site managing the policy
+    def site_id
+      @attributes[:site_id]
+    end
+
+    def site_id=(value)
+      @attributes[:site_id] = value
+    end
+
+    # string - The name of the setting that is managed by the policy
+    def site_setting_name
+      @attributes[:site_setting_name]
+    end
+
+    def site_setting_name=(value)
+      @attributes[:site_setting_name] = value
+    end
+
+    # string - The value for the setting that will be enforced for all child sites that are not exempt
+    def managed_value
+      @attributes[:managed_value]
+    end
+
+    def managed_value=(value)
+      @attributes[:managed_value] = value
+    end
+
+    # array(int64) - The list of child site IDs that are exempt from this policy
+    def skip_child_site_ids
+      @attributes[:skip_child_site_ids]
+    end
+
+    def skip_child_site_ids=(value)
+      @attributes[:skip_child_site_ids] = value
+    end
+
+    # Parameters:
+    #   site_setting_name (required) - string - The name of the setting that is managed by the policy
+    #   managed_value (required) - string - The value for the setting that will be enforced for all child sites that are not exempt
+    #   skip_child_site_ids - array(int64) - The list of child site IDs that are exempt from this policy
+    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: site_setting_name must be an String") if params[:site_setting_name] and !params[:site_setting_name].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: managed_value must be an String") if params[:managed_value] and !params[:managed_value].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: skip_child_site_ids must be an Array") if params[:skip_child_site_ids] and !params[:skip_child_site_ids].is_a?(Array)
+      raise MissingParameterError.new("Parameter missing: id") unless params[:id]
+      raise MissingParameterError.new("Parameter missing: site_setting_name") unless params[:site_setting_name]
+      raise MissingParameterError.new("Parameter missing: managed_value") unless params[:managed_value]
+
+      Api.send_request("/child_site_management_policies/#{@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("/child_site_management_policies/#{@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 = ChildSiteManagementPolicy.create(@attributes, @options)
+      end
+
+      @attributes = new_obj.attributes
+      true
+    end
+
+    # Parameters:
+    #   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
+    #   per_page - int64 - Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
+    def self.list(params = {}, options = {})
+      raise InvalidParameterError.new("Bad parameter: cursor must be an String") if params[:cursor] and !params[:cursor].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: per_page must be an Integer") if params[:per_page] and !params[:per_page].is_a?(Integer)
+
+      List.new(ChildSiteManagementPolicy, params) do
+        Api.send_request("/child_site_management_policies", :get, params, options)
+      end
+    end
+
+    def self.all(params = {}, options = {})
+      list(params, options)
+    end
+
+    # Parameters:
+    #   id (required) - int64 - Child Site Management Policy 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("/child_site_management_policies/#{params[:id]}", :get, params, options)
+      ChildSiteManagementPolicy.new(response.data, options)
+    end
+
+    def self.get(id, params = {}, options = {})
+      find(id, params, options)
+    end
+
+    # Parameters:
+    #   site_setting_name (required) - string - The name of the setting that is managed by the policy
+    #   managed_value (required) - string - The value for the setting that will be enforced for all child sites that are not exempt
+    #   skip_child_site_ids - array(int64) - The list of child site IDs that are exempt from this policy
+    def self.create(params = {}, options = {})
+      raise InvalidParameterError.new("Bad parameter: site_setting_name must be an String") if params[:site_setting_name] and !params[:site_setting_name].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: managed_value must be an String") if params[:managed_value] and !params[:managed_value].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: skip_child_site_ids must be an Array") if params[:skip_child_site_ids] and !params[:skip_child_site_ids].is_a?(Array)
+      raise MissingParameterError.new("Parameter missing: site_setting_name") unless params[:site_setting_name]
+      raise MissingParameterError.new("Parameter missing: managed_value") unless params[:managed_value]
+
+      response, options = Api.send_request("/child_site_management_policies", :post, params, options)
+      ChildSiteManagementPolicy.new(response.data, options)
+    end
+
+    # Parameters:
+    #   site_setting_name (required) - string - The name of the setting that is managed by the policy
+    #   managed_value (required) - string - The value for the setting that will be enforced for all child sites that are not exempt
+    #   skip_child_site_ids - array(int64) - The list of child site IDs that are exempt from this policy
+    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: site_setting_name must be an String") if params[:site_setting_name] and !params[:site_setting_name].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: managed_value must be an String") if params[:managed_value] and !params[:managed_value].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: skip_child_site_ids must be an Array") if params[:skip_child_site_ids] and !params[:skip_child_site_ids].is_a?(Array)
+      raise MissingParameterError.new("Parameter missing: id") unless params[:id]
+      raise MissingParameterError.new("Parameter missing: site_setting_name") unless params[:site_setting_name]
+      raise MissingParameterError.new("Parameter missing: managed_value") unless params[:managed_value]
+
+      response, options = Api.send_request("/child_site_management_policies/#{params[:id]}", :patch, params, options)
+      ChildSiteManagementPolicy.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("/child_site_management_policies/#{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/models/remote_server_configuration_file.rb

@@ -104,7 +104,7 @@ module Files
       @attributes[:transfer_rate_limit]
     end
 
-    # string - Auto update policy ['manual_trigger', 'critical_only', 'always'] (default critical_only)
+    # string - Auto update policy ['manual_trigger', 'critical_only', 'always', 'never'] (default critical_only)
     def auto_update_policy
       @attributes[:auto_update_policy]
     end

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

@@ -864,6 +864,11 @@ module Files
       @attributes[:group_admins_can_set_user_password]
     end
 
+    # array(string) - List of site settings managed by the parent site
+    def managed_site_settings
+      @attributes[:managed_site_settings]
+    end
+
     def self.get(params = {}, options = {})
       response, options = Api.send_request("/site", :get, params, options)
       Site.new(response.data, options)

data/lib/files.com/version.rb

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

data/lib/files.com.rb

@@ -56,6 +56,7 @@ require "files.com/models/bundle_notification"
 require "files.com/models/bundle_path"
 require "files.com/models/bundle_recipient"
 require "files.com/models/bundle_registration"
+require "files.com/models/child_site_management_policy"
 require "files.com/models/clickwrap"
 require "files.com/models/dns_record"
 require "files.com/models/email_incoming_message"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.308
+  version: 1.1.310
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-07-25 00:00:00.000000000 Z
+date: 2025-07-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -138,6 +138,7 @@ files:
 - docs/bundle_path.md
 - docs/bundle_recipient.md
 - docs/bundle_registration.md
+- docs/child_site_management_policy.md
 - docs/clickwrap.md
 - docs/dns_record.md
 - docs/email_incoming_message.md
@@ -248,6 +249,7 @@ files:
 - lib/files.com/models/bundle_path.rb
 - lib/files.com/models/bundle_recipient.rb
 - lib/files.com/models/bundle_registration.rb
+- lib/files.com/models/child_site_management_policy.rb
 - lib/files.com/models/clickwrap.rb
 - lib/files.com/models/dir.rb
 - lib/files.com/models/dns_record.rb