files.com 1.1.609 → 1.1.610

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0141b45b7feb4472e1f7b7452ec2f6db80187cbc7682e200f2f51ea1eb07f597
-  data.tar.gz: 83705f870364c1b6a06ca1ac7c944a25f340d196c9c2c286b3ab24b0f89a360f
+  metadata.gz: 6c0cac3455ea7b93f2d5f3195ee1712d7cf0b89657e3dcffe33ca73ab909d141
+  data.tar.gz: 7d55fc84ec33274ed4a7587a6704608944ac49d4b18e22bf547de96cc330c24c
 SHA512:
-  metadata.gz: 5911fe0749e5015fbba0365a1c6d1bf9d19f6c483941c6e9d2b4d6ed630d4f76c85fa05cae286dfeda0ec9cb4f7416ba4da29759bb3d1a98aa5f7915302d1289
-  data.tar.gz: 522f663240d45389edfa63015967a9e562ce684c48f165e2dd18c1e9ab0f516421d1bfc126634fba62373d7b6172f96ad51a83c3345aa9c8b31c46c29aef2ca9
+  metadata.gz: 1cac31e5c8b29c5f2ce578b75636b770f92b1de29a1ba71ba5823d9714db81b8527c0e2c5d0e945e3941e83df2ed494bc1b18afa5aa00e982858e925866d2499
+  data.tar.gz: 84dfabfed5db8c2fc7b83b868adeca5a8d8e2b5a75b59db551c924edcdc3f15878670672af6daebd76c1f6142c4cb15707ac5d0d3c5c329a9d782aacef98a3e2

data/_VERSION

@@ -1 +1 @@
-1.1.609
+1.1.610

data/docs/behavior.md

@@ -26,7 +26,7 @@
 * `description` (string): Description for this behavior.
 * `value` (object): Settings for this behavior.  See the section above for an example value to provide here.  Formatting is different for each Behavior type.  May be sent as nested JSON or a single JSON-encoded string.  If using XML encoding for the API call, this data must be sent as a JSON-encoded string.
 * `disable_parent_folder_behavior` (boolean): If true, the parent folder's behavior will be disabled for this folder and its children.
-* `recursive` (boolean): Is behavior recursive?
+* `recursive` (boolean): Whether this behavior is recursive for this record. `always` behaviors are always `true`, `never` behaviors are always `false`, and `sometimes` behaviors may be either value.
 * `attachment_file` (file): Certain behaviors may require a file, for instance, the `watermark` behavior requires a watermark image. Attach that file here.
 * `attachment_delete` (boolean): If `true`, delete the file stored in `attachment`.
 
@@ -101,7 +101,7 @@ Files::Behavior.create(
 * `value` (object): This field stores a hash of data specific to the type of behavior. See The Behavior Types section for example values for each type of behavior.
 * `attachment_file` (file): Certain behaviors may require a file, for instance, the `watermark` behavior requires a watermark image. Attach that file here.
 * `disable_parent_folder_behavior` (boolean): If `true`, the parent folder's behavior will be disabled for this folder and its children. This is the main mechanism for canceling out a `recursive` behavior higher in the folder tree.
-* `recursive` (boolean): If `true`, behavior is treated as recursive, meaning that it impacts child folders as well.
+* `recursive` (boolean): Whether the behavior should apply to child folders. This is only configurable for behavior types whose recursion mode is `sometimes`; `always` behaviors stay recursive and `never` behaviors stay non-recursive.
 * `name` (string): Name for this behavior.
 * `description` (string): Description for this behavior.
 * `path` (string): Required - Path where this behavior should apply.
@@ -153,7 +153,7 @@ Files::Behavior.update(id,
 * `value` (object): This field stores a hash of data specific to the type of behavior. See The Behavior Types section for example values for each type of behavior.
 * `attachment_file` (file): Certain behaviors may require a file, for instance, the `watermark` behavior requires a watermark image. Attach that file here.
 * `disable_parent_folder_behavior` (boolean): If `true`, the parent folder's behavior will be disabled for this folder and its children. This is the main mechanism for canceling out a `recursive` behavior higher in the folder tree.
-* `recursive` (boolean): If `true`, behavior is treated as recursive, meaning that it impacts child folders as well.
+* `recursive` (boolean): Whether the behavior should apply to child folders. This is only configurable for behavior types whose recursion mode is `sometimes`; `always` behaviors stay recursive and `never` behaviors stay non-recursive.
 * `name` (string): Name for this behavior.
 * `description` (string): Description for this behavior.
 * `attachment_delete` (boolean): If `true`, delete the file stored in `attachment`.
@@ -195,7 +195,7 @@ behavior.update(
 * `value` (object): This field stores a hash of data specific to the type of behavior. See The Behavior Types section for example values for each type of behavior.
 * `attachment_file` (file): Certain behaviors may require a file, for instance, the `watermark` behavior requires a watermark image. Attach that file here.
 * `disable_parent_folder_behavior` (boolean): If `true`, the parent folder's behavior will be disabled for this folder and its children. This is the main mechanism for canceling out a `recursive` behavior higher in the folder tree.
-* `recursive` (boolean): If `true`, behavior is treated as recursive, meaning that it impacts child folders as well.
+* `recursive` (boolean): Whether the behavior should apply to child folders. This is only configurable for behavior types whose recursion mode is `sometimes`; `always` behaviors stay recursive and `never` behaviors stay non-recursive.
 * `name` (string): Name for this behavior.
 * `description` (string): Description for this behavior.
 * `attachment_delete` (boolean): If `true`, delete the file stored in `attachment`.

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

@@ -81,7 +81,7 @@ module Files
       @attributes[:disable_parent_folder_behavior] = value
     end
 
-    # boolean - Is behavior recursive?
+    # boolean - Whether this behavior is recursive for this record. `always` behaviors are always `true`, `never` behaviors are always `false`, and `sometimes` behaviors may be either value.
     def recursive
       @attributes[:recursive]
     end
@@ -112,7 +112,7 @@ module Files
     #   value - object - This field stores a hash of data specific to the type of behavior. See The Behavior Types section for example values for each type of behavior.
     #   attachment_file - file - Certain behaviors may require a file, for instance, the `watermark` behavior requires a watermark image. Attach that file here.
     #   disable_parent_folder_behavior - boolean - If `true`, the parent folder's behavior will be disabled for this folder and its children. This is the main mechanism for canceling out a `recursive` behavior higher in the folder tree.
-    #   recursive - boolean - If `true`, behavior is treated as recursive, meaning that it impacts child folders as well.
+    #   recursive - boolean - Whether the behavior should apply to child folders. This is only configurable for behavior types whose recursion mode is `sometimes`; `always` behaviors stay recursive and `never` behaviors stay non-recursive.
     #   name - string - Name for this behavior.
     #   description - string - Description for this behavior.
     #   attachment_delete - boolean - If `true`, delete the file stored in `attachment`.
@@ -216,7 +216,7 @@ module Files
     #   value - object - This field stores a hash of data specific to the type of behavior. See The Behavior Types section for example values for each type of behavior.
     #   attachment_file - file - Certain behaviors may require a file, for instance, the `watermark` behavior requires a watermark image. Attach that file here.
     #   disable_parent_folder_behavior - boolean - If `true`, the parent folder's behavior will be disabled for this folder and its children. This is the main mechanism for canceling out a `recursive` behavior higher in the folder tree.
-    #   recursive - boolean - If `true`, behavior is treated as recursive, meaning that it impacts child folders as well.
+    #   recursive - boolean - Whether the behavior should apply to child folders. This is only configurable for behavior types whose recursion mode is `sometimes`; `always` behaviors stay recursive and `never` behaviors stay non-recursive.
     #   name - string - Name for this behavior.
     #   description - string - Description for this behavior.
     #   path (required) - string - Path where this behavior should apply.
@@ -258,7 +258,7 @@ module Files
     #   value - object - This field stores a hash of data specific to the type of behavior. See The Behavior Types section for example values for each type of behavior.
     #   attachment_file - file - Certain behaviors may require a file, for instance, the `watermark` behavior requires a watermark image. Attach that file here.
     #   disable_parent_folder_behavior - boolean - If `true`, the parent folder's behavior will be disabled for this folder and its children. This is the main mechanism for canceling out a `recursive` behavior higher in the folder tree.
-    #   recursive - boolean - If `true`, behavior is treated as recursive, meaning that it impacts child folders as well.
+    #   recursive - boolean - Whether the behavior should apply to child folders. This is only configurable for behavior types whose recursion mode is `sometimes`; `always` behaviors stay recursive and `never` behaviors stay non-recursive.
     #   name - string - Name for this behavior.
     #   description - string - Description for this behavior.
     #   attachment_delete - boolean - If `true`, delete the file stored in `attachment`.

data/lib/files.com/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.609
+  version: 1.1.610
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-04-23 00:00:00.000000000 Z
+date: 2026-04-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable