files.com 1.1.678 → 1.1.680

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4ef7bf9cde3f8d5da53a59f84147b250576de0cd29611b5c879ad1d4f09cf124
-  data.tar.gz: 211ea1233c6828c9db8c2e1ecc71858d992e5c1074218f22e5580eae75a60007
+  metadata.gz: a3ed7783348dc256c9b8494234c6aa30ef8ebb741823ef5b448c73a8914a08a2
+  data.tar.gz: 518d591f6f1058bfaf127a7780d7510a5702019288d9f155ecca8155f4ac9c53
 SHA512:
-  metadata.gz: c7f54f058a1b201d599fc754fe7a0e68e48e15a96c092b8646d6cf8a27108306a1f496ba93c92cfef404e039fab060855b1c5416f7ad4c41e08f6b1b180bc477
-  data.tar.gz: 447a0a28591ab4dcb73261bdbaf5266c8700d02240c2e09f8fd5fd769cc73931fcddc9885a026dcdce81fa006e24f9a0b44280762ea5575a5d17e43ccc07a7da
+  metadata.gz: 100499f45577b4cfa4c24bf8c8624709fe65c96628aeca54026d8b660af6bd776da5978feb054f2825fbb73d1b5b87f85cd06e8269d1eb766dface24d8de774f
+  data.tar.gz: 95413d3720645e247e3f686bf29b28c0e7aaf364d9390eb109fcc40bd1fe4223a1ee08d8902970cf9f13a872ded2ce81073c6181eca0c8279b66edc3cb9ad805

data/_VERSION

@@ -1 +1 @@
-1.1.678
+1.1.680

data/docs/automation.md

@@ -11,6 +11,7 @@
   "automation": "create_folder",
   "deleted": true,
   "description": "example",
+  "definition": "example",
   "destination_replace_from": "example",
   "destination_replace_to": "example",
   "destinations": [
@@ -44,6 +45,7 @@
   "overwrite_files": true,
   "path": "example",
   "path_time_zone": "Eastern Time (US & Canada)",
+  "version": 1,
   "recurring_day": 25,
   "retry_on_failure_interval_in_minutes": 60,
   "retry_on_failure_number_of_attempts": 10,
@@ -103,6 +105,7 @@
 * `automation` (string): Automation type
 * `deleted` (boolean): Indicates if the automation has been deleted.
 * `description` (string): Description for the this Automation.
+* `definition` (object): Automation v2 graph definition.
 * `destination_replace_from` (string): If set, this string in the destination path will be replaced with the value in `destination_replace_to`.
 * `destination_replace_to` (string): If set, this string will replace the value `destination_replace_from` in the destination filename. You can use special patterns here.
 * `destinations` (array(string)): Destination Paths
@@ -119,6 +122,7 @@
 * `overwrite_files` (boolean): If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten on Copy automations if they appear to be the same file size as the newly incoming file.  Use the `always_overwrite_size_matching_files` option in conjunction with `overwrite_files` to override this behavior and overwrite files no matter what.
 * `path` (string): Path on which this Automation runs.  Supports globs, except on remote mounts. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
 * `path_time_zone` (string): Timezone to use when rendering timestamps in paths.
+* `version` (int64): Current Automation v2 definition version.
 * `recurring_day` (int64): If trigger type is `daily`, this specifies a day number to run in one of the supported intervals: `week`, `month`, `quarter`, `year`.
 * `retry_on_failure_interval_in_minutes` (int64): If the Automation fails, retry at this interval (in minutes).  Acceptable values are 5 through 1440 (one day).  Set to null to disable.
 * `retry_on_failure_number_of_attempts` (int64): If the Automation fails, retry at most this many times.  Maximum allowed value: 10.  Set to null to disable.

data/docs/automation_run.md

@@ -6,7 +6,9 @@
 {
   "id": 1,
   "automation_id": 1,
+  "automation_version_id": 1,
   "workspace_id": 1,
+  "cancel_requested_at": "2000-01-01T01:00:00Z",
   "completed_at": "2000-01-01T01:00:00Z",
   "created_at": "2000-01-01T01:00:00Z",
   "retry_at": "2000-01-01T01:00:00Z",
@@ -17,13 +19,18 @@
   "status": "success",
   "successful_operations": 1,
   "failed_operations": 1,
+  "definition": "example",
+  "node_states": "example",
+  "journal_url": "example",
   "status_messages_url": "https://www.example.com/log_file.txt"
 }
 ```
 
 * `id` (int64): ID.
 * `automation_id` (int64): ID of the associated Automation.
+* `automation_version_id` (int64): ID of the immutable Automation version pinned by this run.
 * `workspace_id` (int64): Workspace ID.
+* `cancel_requested_at` (date-time): Date/time at which cancellation was requested.
 * `completed_at` (date-time): Automation run completion/failure date/time.
 * `created_at` (date-time): Automation run start date/time.
 * `retry_at` (date-time): If set, this automation will be retried at this date/time due to `failure` or `partial_failure`.
@@ -31,9 +38,12 @@
 * `retried_in_run_id` (int64): ID of the run that is or will be retrying this run.
 * `retry_of_run_id` (int64): ID of the original run that this run is retrying.
 * `runtime` (double): Automation run runtime.
-* `status` (string): The success status of the AutomationRun. One of `running`, `success`, `partial_failure`, or `failure`.
+* `status` (string): The status of the AutomationRun. One of `queued`, `running`, `success`, `partial_failure`, `failure`, `skipped`, or `canceled`.
 * `successful_operations` (int64): Count of successful operations.
 * `failed_operations` (int64): Count of failed operations.
+* `definition` (object): Automation definition snapshot pinned by this run. For performance reasons, this is not provided when listing Automation runs.
+* `node_states` (object): Status and execution stage for each node in this run. For performance reasons, this is not provided when listing Automation runs.
+* `journal_url` (string): Link to the run journal artifact.
 * `status_messages_url` (string): Link to status messages log file.
 
 
@@ -69,3 +79,31 @@ Files::AutomationRun.find(id)
 ### Parameters
 
 * `id` (int64): Required - Automation Run ID.
+
+
+---
+
+## Cancel Automation Run
+
+```
+Files::AutomationRun.cancel(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Automation Run ID.
+
+
+---
+
+## Cancel Automation Run
+
+```
+automation_run = Files::AutomationRun.find(id)
+
+automation_run.cancel
+```
+
+### Parameters
+
+* `id` (int64): Required - Automation Run ID.

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

@@ -72,6 +72,15 @@ module Files
       @attributes[:description] = value
     end
 
+    # object - Automation v2 graph definition.
+    def definition
+      @attributes[:definition]
+    end
+
+    def definition=(value)
+      @attributes[:definition] = value
+    end
+
     # string - If set, this string in the destination path will be replaced with the value in `destination_replace_to`.
     def destination_replace_from
       @attributes[:destination_replace_from]
@@ -216,6 +225,15 @@ module Files
       @attributes[:path_time_zone] = value
     end
 
+    # int64 - Current Automation v2 definition version.
+    def version
+      @attributes[:version]
+    end
+
+    def version=(value)
+      @attributes[:version] = value
+    end
+
     # int64 - If trigger type is `daily`, this specifies a day number to run in one of the supported intervals: `week`, `month`, `quarter`, `year`.
     def recurring_day
       @attributes[:recurring_day]

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

@@ -19,11 +19,21 @@ module Files
       @attributes[:automation_id]
     end
 
+    # int64 - ID of the immutable Automation version pinned by this run.
+    def automation_version_id
+      @attributes[:automation_version_id]
+    end
+
     # int64 - Workspace ID.
     def workspace_id
       @attributes[:workspace_id]
     end
 
+    # date-time - Date/time at which cancellation was requested.
+    def cancel_requested_at
+      @attributes[:cancel_requested_at]
+    end
+
     # date-time - Automation run completion/failure date/time.
     def completed_at
       @attributes[:completed_at]
@@ -59,7 +69,7 @@ module Files
       @attributes[:runtime]
     end
 
-    # string - The success status of the AutomationRun. One of `running`, `success`, `partial_failure`, or `failure`.
+    # string - The status of the AutomationRun. One of `queued`, `running`, `success`, `partial_failure`, `failure`, `skipped`, or `canceled`.
     def status
       @attributes[:status]
     end
@@ -74,11 +84,37 @@ module Files
       @attributes[:failed_operations]
     end
 
+    # object - Automation definition snapshot pinned by this run. For performance reasons, this is not provided when listing Automation runs.
+    def definition
+      @attributes[:definition]
+    end
+
+    # object - Status and execution stage for each node in this run. For performance reasons, this is not provided when listing Automation runs.
+    def node_states
+      @attributes[:node_states]
+    end
+
+    # string - Link to the run journal artifact.
+    def journal_url
+      @attributes[:journal_url]
+    end
+
     # string - Link to status messages log file.
     def status_messages_url
       @attributes[:status_messages_url]
     end
 
+    # Cancel Automation Run
+    def cancel(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("/automation_runs/#{@attributes[:id]}/cancel", :post, params, @options)
+    end
+
     # Parameters:
     #   user_id - int64 - User ID.  Provide a value of `0` to operate the current session's user.
     #   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
@@ -119,5 +155,16 @@ module Files
     def self.get(id, params = {}, options = {})
       find(id, params, options)
     end
+
+    # Cancel Automation Run
+    def self.cancel(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("/automation_runs/#{params[:id]}/cancel", :post, params, options)
+      AutomationRun.new(response.data, options)
+    end
   end
 end

data/lib/files.com/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.678
+  version: 1.1.680
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-07-12 00:00:00.000000000 Z
+date: 2026-07-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable