files.com 1.1.774 → 1.1.775

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c4f2c94de7f8460dbc6ebdc3ebfe0d3acac9e51a73ba8e8bb1b6fdeb4c209cf2
-  data.tar.gz: 021a97a67cc851eda338a4648d23fd98123062630359ffe889c6d5ce4621c624
+  metadata.gz: d4c219d136b284a59d807f0457203b8c9cea7dfc0a2e816df7be244d5a063546
+  data.tar.gz: 92418b15c3786ca448d176d68a3e1d2a9a16e1a9c69a0c8713642e37c87b7f74
 SHA512:
-  metadata.gz: 34e69220a7b56baed94b097b29f252091b878d09bbc8c18d2c48b814d4621242f387a678e556ec2649ea47d5f0afbbc657f18795823bbd0547e78c28d0b43c86
-  data.tar.gz: 0130c0988d60aeee05ea50a51ba9289434e336c6dbbb6a34532462fcc4d52a2a00fd869446428d3bd84b06851436784ed5377de1519bf960045ebcb50930dc9c
+  metadata.gz: aa90b8947359abecb1f93143a999a5816d291bba7d3087966baaaa695acc90f02a4c0d5b73ebbd7a34c93f831d815809995b6f977159ffeb74573169236adeb2
+  data.tar.gz: c160181dd3b0241c69b86a86d11afb2f2a73a83f3c17c8ac913aabea1d9c5307981c267f7f8dd01839924591cdeefde9f522127938d71df3217ba0b6df26c7b2

data/_VERSION

@@ -1 +1 @@
-1.1.774
+1.1.775

data/docs/file.md

@@ -282,6 +282,22 @@ Files::File.zip_list_contents(path)
 * `path` (string): Required - Path to operate on.
 
 
+---
+
+## Delete File/Folder and return its File Action.  A pending or processing deletion continues in the background after this returns; check its File Migration for completion.  Waiting for the File Migration does not cancel the deletion
+
+```
+Files::File.begin_delete(path, 
+  recursive: false
+)
+```
+
+### Parameters
+
+* `path` (string): Required - Path to operate on.
+* `recursive` (boolean): If true, will recursively delete folders.  Otherwise, will error on non-empty folders.
+
+
 ---
 
 ## Copy File/Folder
@@ -548,6 +564,24 @@ file.zip_list_contents
 * `path` (string): Required - Path to operate on.
 
 
+---
+
+## Delete File/Folder and return its File Action.  A pending or processing deletion continues in the background after this returns; check its File Migration for completion.  Waiting for the File Migration does not cancel the deletion
+
+```
+file = Files::File.find(path)
+
+file.begin_delete(
+  recursive: false
+)
+```
+
+### Parameters
+
+* `path` (string): Required - Path to operate on.
+* `recursive` (boolean): If true, will recursively delete folders.  Otherwise, will error on non-empty folders.
+
+
 ---
 
 ## Copy File/Folder

data/docs/file_action.md

@@ -10,4 +10,4 @@
 ```
 
 * `status` (string): Status of file operation.
-* `file_migration_id` (int64): If status is pending, this is the id of the File Migration to check for status updates.
+* `file_migration_id` (int64): If status is pending, this is the id of the File Migration to check for status updates.  Delete actions include it whenever the deletion runs as a File Migration, including while it is processing.

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

@@ -1145,6 +1145,20 @@ module Files
       Api.send_request("/file_actions/zip_list/#{@attributes[:path]}", :get, params, @options)
     end
 
+    # Delete File/Folder and return its File Action.  A pending or processing deletion continues in the background after this returns; check its File Migration for completion.  Waiting for the File Migration does not cancel the deletion
+    #
+    # Parameters:
+    #   recursive - boolean - If true, will recursively delete folders.  Otherwise, will error on non-empty folders.
+    def begin_delete(params = {})
+      params ||= {}
+      params[:path] = @attributes[:path]
+      raise MissingParameterError.new("Current object doesn't have a path") unless @attributes[:path]
+      raise InvalidParameterError.new("Bad parameter: path must be an String") if params[:path] and !params[:path].is_a?(String)
+      raise MissingParameterError.new("Parameter missing: path") unless params[:path]
+
+      Api.send_request("/file_actions/delete/#{@attributes[:path]}", :post, params, @options)
+    end
+
     # Copy File/Folder
     #
     # Parameters:
@@ -1466,6 +1480,25 @@ module Files
       end
     end
 
+    # Delete File/Folder and return its File Action.  A pending or processing deletion continues in the background after this returns; check its File Migration for completion.  Waiting for the File Migration does not cancel the deletion
+    #
+    # Parameters:
+    #   recursive - boolean - If true, will recursively delete folders.  Otherwise, will error on non-empty folders.
+    #
+    # params:: Hash of API operation parameter values.
+    # options:: Hash of optional request configuration passed to Files::Api.send_request.
+    #
+    # Returns a Files::FileAction.
+    def self.begin_delete(path, params = {}, options = {})
+      params ||= {}
+      params[:path] = path
+      raise InvalidParameterError.new("Bad parameter: path must be an String") if params[:path] and !params[:path].is_a?(String)
+      raise MissingParameterError.new("Parameter missing: path") unless params[:path]
+
+      response, options = Api.send_request("/file_actions/delete/#{params[:path]}", :post, params, options) { |reply| reply.require_object("FileAction") }
+      FileAction.new(response.data, options)
+    end
+
     # Copy File/Folder
     #
     # Parameters:

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

@@ -14,7 +14,7 @@ module Files
       @attributes[:status]
     end
 
-    # int64 - If status is pending, this is the id of the File Migration to check for status updates.
+    # int64 - If status is pending, this is the id of the File Migration to check for status updates.  Delete actions include it whenever the deletion runs as a File Migration, including while it is processing.
     def file_migration_id
       @attributes[:file_migration_id]
     end

data/lib/files.com/version.rb

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

metadata

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