files.com 1.1.679 → 1.1.681

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8903be135ecc5d24d7ff1d0c05d817b511848118b9f4b348470ad7a5888e3aa
-  data.tar.gz: fcb51efc5e6673d393f2381a9992b75a6b1bc294ea0a1c319375a812caffdaad
+  metadata.gz: c9c833a143a8391a44ebde9b88e149f7d231ecc18fcd2f4a3044b76494e55ff1
+  data.tar.gz: 2e262c76502adb4d6523427d1c7cce881bb5c07775ccbc0e4b44d06b89473d48
 SHA512:
-  metadata.gz: 9350dfdcd0e2c42f37c000c383263da394bb703497e3eeb0e8576376c45e75e523fd80c8f2131d9ad55072004fbbb237367fd0de18e943adb32619dafd8ca8a8
-  data.tar.gz: 8c3793b9c8a6ac6c7937d4ce7c0696eba8c979831895a572533f4362631ab08a51b96dadb0663f9a1526f5aab2f3d3e9f2d69a5479738fe34b4eef5442ba313f
+  metadata.gz: 016bf4fe6fbc5d50b77775ecc437637bb63dbedd13a7412d4b2fc75459b685b91caa624540eb66830b0cf9fb208384e5afbca6e6226f8cb430bc3385d648bdf0
+  data.tar.gz: 2aa8a0bfd3146849efb5fd6269f8fa3711c18ffc39c405b50dd4a6edd7b81d72d3c375cbe985a75df871b37e786542ec2a3eee4eb24786fc917a9a50b7fa8483

data/_VERSION

@@ -1 +1 @@
-1.1.679
+1.1.681

data/docs/automation.md

@@ -176,6 +176,15 @@ Files::Automation.find(id)
 * `id` (int64): Required - Automation ID.
 
 
+---
+
+## Show the Automation v2 authoring schema and active node catalog
+
+```
+Files::Automation.get_authoring_schema
+```
+
+
 ---
 
 ## Create Automation

data/docs/automation_authoring_schema.md

@@ -0,0 +1,15 @@
+# AutomationAuthoringSchema
+
+## Example AutomationAuthoringSchema Object
+
+```
+{
+  "definition_schema": "example",
+  "nodes": [
+    "example"
+  ]
+}
+```
+
+* `definition_schema` (object): JSON Schema for active Automation v2 graph definitions.
+* `nodes` (array(object)): Active Automation v2 node authoring metadata.

data/docs/automation_run.md

@@ -8,6 +8,7 @@
   "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",
@@ -19,6 +20,7 @@
   "successful_operations": 1,
   "failed_operations": 1,
   "definition": "example",
+  "node_states": "example",
   "journal_url": "example",
   "status_messages_url": "https://www.example.com/log_file.txt"
 }
@@ -28,6 +30,7 @@
 * `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`.
@@ -35,10 +38,11 @@
 * `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.
 
@@ -75,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

@@ -546,6 +546,11 @@ module Files
       find(id, params, options)
     end
 
+    def self.get_authoring_schema(params = {}, options = {})
+      response, options = Api.send_request("/automations/authoring_schema", :get, params, options)
+      AutomationAuthoringSchema.new(response.data, options)
+    end
+
     # Parameters:
     #   source - string - Source path/glob.  See Automation docs for exact description, but this is used to filter for files in the `path` to find files to operate on. Supports globs, except on remote mounts.
     #   destinations - array(string) - A list of destination paths. Use a trailing slash for folder destinations and omit it for file destinations.

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

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Files
+  class AutomationAuthoringSchema
+    attr_reader :options, :attributes
+
+    def initialize(attributes = {}, options = {})
+      @attributes = attributes || {}
+      @options = options || {}
+    end
+
+    # object - JSON Schema for active Automation v2 graph definitions.
+    def definition_schema
+      @attributes[:definition_schema]
+    end
+
+    # array(object) - Active Automation v2 node authoring metadata.
+    def nodes
+      @attributes[:nodes]
+    end
+  end
+end

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

@@ -29,6 +29,11 @@ module Files
       @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]
@@ -64,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
@@ -84,6 +89,11 @@ module Files
       @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]
@@ -94,6 +104,17 @@ module Files
       @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.
@@ -134,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.679"
+  VERSION = "1.1.681"
 end

data/lib/files.com.rb

@@ -49,6 +49,7 @@ require "files.com/models/as2_partner"
 require "files.com/models/as2_station"
 require "files.com/models/auto"
 require "files.com/models/automation"
+require "files.com/models/automation_authoring_schema"
 require "files.com/models/automation_log"
 require "files.com/models/automation_run"
 require "files.com/models/bandwidth_snapshot"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.679
+  version: 1.1.681
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-07-13 00:00:00.000000000 Z
+date: 2026-07-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -187,6 +187,7 @@ files:
 - docs/as2_station.md
 - docs/auto.md
 - docs/automation.md
+- docs/automation_authoring_schema.md
 - docs/automation_log.md
 - docs/automation_run.md
 - docs/bandwidth_snapshot.md
@@ -334,6 +335,7 @@ files:
 - lib/files.com/models/as2_station.rb
 - lib/files.com/models/auto.rb
 - lib/files.com/models/automation.rb
+- lib/files.com/models/automation_authoring_schema.rb
 - lib/files.com/models/automation_log.rb
 - lib/files.com/models/automation_run.rb
 - lib/files.com/models/bandwidth_snapshot.rb