files.com 1.1.597 → 1.1.599

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 688e7875040976b74cdc2bf245f054fe4e005125685d27af769ad4a7cb9660c1
-  data.tar.gz: 907bfe4f027b890868115ec5adef64664050bbd18b68397fc41d9a730e11ff78
+  metadata.gz: 64cc6a922c509ca8088eebf8f4588afe2ea532620b021d53fb9faa4d49819215
+  data.tar.gz: ff44b071a6ebc13928f00a09a306ac0efa58adec544eef2cc99ce7d824c0c8ea
 SHA512:
-  metadata.gz: 4393537027f1dc7f5fb31e6789a1202b8b80480af9896179ecf9e3433e6385c5e9fd0bcb774e6a293c05b7e07cb670105426df20c253a504bdea68a5d7a644e6
-  data.tar.gz: bf9ccccbb7e6d3d01e3289a2c5afe1ddc355d62c3f8749e535025002b8cc3ae83757268c42f63e992c9175c4ff954c9ea1a1c9bdad071c6a08a72f2af6e52141
+  metadata.gz: 84f3e3d529b8e7a654e1cf3809fa1b58ec30e97a62e2987b956d409f7884fb06131b73c48bf72f633b12716fc0dd3144549165e8d449d3bf3ad8c00cad02c955
+  data.tar.gz: b199981cfa1b82388525c337c0421be07caad4cc0d78209f9c99baf88b03416d0dabe809749fadb779b4e6163c1625289af65bf26150381c5aebb3c377d92ce3

data/_VERSION

@@ -1 +1 @@
-1.1.597
+1.1.599

data/docs/metadata_category.md

@@ -0,0 +1,139 @@
+# MetadataCategory
+
+## Example MetadataCategory Object
+
+```
+{
+  "id": 1,
+  "name": "Approval Workflow",
+  "definitions": {
+    "Approval Status": [
+      "Under Review",
+      "Approved",
+      "Rejected"
+    ],
+    "Reviewer": [
+
+    ]
+  },
+  "default_columns": [
+    "Approval Status"
+  ]
+}
+```
+
+* `id` (int64): Metadata Category ID
+* `name` (string): Name of the metadata category.
+* `definitions` (hash(string,array(string))): Map of key names to arrays of allowed values. An empty array means free-form text.
+* `default_columns` (array(string)): Metadata keys that should appear as columns in the UI by default.
+
+
+---
+
+## List Metadata Categories
+
+```
+Files::MetadataCategory.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).
+* `sort_by` (object): If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are .
+
+
+---
+
+## Show Metadata Category
+
+```
+Files::MetadataCategory.find(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Metadata Category ID.
+
+
+---
+
+## Create Metadata Category
+
+```
+Files::MetadataCategory.create(
+  name: "Approval Workflow", 
+  default_columns: ["Approval Status"]
+)
+```
+
+### Parameters
+
+* `name` (string): Required - Name of the metadata category.
+* `default_columns` (array(string)): Metadata keys that should appear as columns in the UI by default.
+
+
+---
+
+## Update Metadata Category
+
+```
+Files::MetadataCategory.update(id, 
+  name: "Approval Workflow", 
+  default_columns: ["Approval Status"]
+)
+```
+
+### Parameters
+
+* `id` (int64): Required - Metadata Category ID.
+* `name` (string): Name of the metadata category.
+* `default_columns` (array(string)): Metadata keys that should appear as columns in the UI by default.
+
+
+---
+
+## Delete Metadata Category
+
+```
+Files::MetadataCategory.delete(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Metadata Category ID.
+
+
+---
+
+## Update Metadata Category
+
+```
+metadata_category = Files::MetadataCategory.find(id)
+
+metadata_category.update(
+  name: "Approval Workflow",
+  default_columns: ["Approval Status"]
+)
+```
+
+### Parameters
+
+* `id` (int64): Required - Metadata Category ID.
+* `name` (string): Name of the metadata category.
+* `default_columns` (array(string)): Metadata keys that should appear as columns in the UI by default.
+
+
+---
+
+## Delete Metadata Category
+
+```
+metadata_category = Files::MetadataCategory.find(id)
+
+metadata_category.delete
+```
+
+### Parameters
+
+* `id` (int64): Required - Metadata Category ID.

data/docs/notification.md

@@ -8,6 +8,12 @@
   "path": "",
   "group_id": 1,
   "group_name": "example",
+  "group_ids": [
+    1
+  ],
+  "group_names": [
+    "example"
+  ],
   "triggering_group_ids": [
     1
   ],
@@ -40,6 +46,8 @@
 * `path` (string): Folder path to notify on. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
 * `group_id` (int64): ID of Group to receive notifications
 * `group_name` (string): Group name, if a Group ID is set
+* `group_ids` (array(int64)): Group IDs when the notification requires multiple groups
+* `group_names` (array(string)): Group names when the notification requires multiple groups
 * `triggering_group_ids` (array(int64)): If set, will only notify on actions made by a member of one of the specified groups
 * `triggering_user_ids` (array(int64)): If set, will only notify on actions made one of the specified users
 * `trigger_by_share_recipients` (boolean): Notify when actions are performed by a share recipient?
@@ -117,6 +125,7 @@ Files::Notification.create(
   triggering_user_ids: [1], 
   trigger_by_share_recipients: true, 
   group_id: 1, 
+  group_ids: [1], 
   username: "User"
 )
 ```
@@ -138,6 +147,7 @@ Files::Notification.create(
 * `triggering_user_ids` (array(int64)): If set, will only notify on actions made one of the specified users
 * `trigger_by_share_recipients` (boolean): Notify when actions are performed by a share recipient?
 * `group_id` (int64): The ID of the group to notify.  Provide `user_id`, `username` or `group_id`.
+* `group_ids` (string): Group IDs when the notification requires multiple groups. If sent as a string, it should be comma-delimited.
 * `path` (string): Path
 * `username` (string): The username of the user to notify.  Provide `user_id`, `username` or `group_id`.
 

data/docs/sync.md

@@ -68,7 +68,18 @@
     "successful_files": 1,
     "sync_id": 1,
     "sync_name": "Azure to SharePoint Sync",
-    "updated_at": "2000-01-01T01:00:00Z"
+    "updated_at": "2000-01-01T01:00:00Z",
+    "live_transfers": [
+      {
+        "path": "example",
+        "status": "example",
+        "bytes_copied": 1,
+        "bytes_total": 1,
+        "percentage": 1.0,
+        "eta": "example",
+        "started_at": "example"
+      }
+    ]
   }
 }
 ```

data/docs/sync_run.md

@@ -27,7 +27,18 @@
   "successful_files": 1,
   "sync_id": 1,
   "sync_name": "Azure to SharePoint Sync",
-  "updated_at": "2000-01-01T01:00:00Z"
+  "updated_at": "2000-01-01T01:00:00Z",
+  "live_transfers": [
+    {
+      "path": "example",
+      "status": "example",
+      "bytes_copied": 1,
+      "bytes_total": 1,
+      "percentage": 1.0,
+      "eta": "example",
+      "started_at": "example"
+    }
+  ]
 }
 ```
 
@@ -53,6 +64,7 @@
 * `sync_id` (int64): ID of the Sync this run belongs to
 * `sync_name` (string): Name of the Sync this run belongs to
 * `updated_at` (date-time): When this run was last updated
+* `live_transfers` (array(object)): Array of in-progress file transfers with progress data. Only present when the sync run status is in_progress.
 
 
 ---

data/docs/sync_run_live_transfer.md

@@ -0,0 +1,23 @@
+# SyncRunLiveTransfer
+
+## Example SyncRunLiveTransfer Object
+
+```
+{
+  "path": "example",
+  "status": "example",
+  "bytes_copied": 1,
+  "bytes_total": 1,
+  "percentage": 1.0,
+  "eta": "example",
+  "started_at": "example"
+}
+```
+
+* `path` (string): The file path being transferred. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
+* `status` (string): Status of this individual transfer
+* `bytes_copied` (int64): Bytes transferred so far
+* `bytes_total` (int64): Total bytes of the file being transferred
+* `percentage` (double): Transfer progress from 0.0 to 1.0
+* `eta` (string): Estimated time remaining (human-readable)
+* `started_at` (string): When this individual transfer started

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

@@ -0,0 +1,165 @@
+# frozen_string_literal: true
+
+module Files
+  class MetadataCategory
+    attr_reader :options, :attributes
+
+    def initialize(attributes = {}, options = {})
+      @attributes = attributes || {}
+      @options = options || {}
+    end
+
+    # int64 - Metadata Category ID
+    def id
+      @attributes[:id]
+    end
+
+    def id=(value)
+      @attributes[:id] = value
+    end
+
+    # string - Name of the metadata category.
+    def name
+      @attributes[:name]
+    end
+
+    def name=(value)
+      @attributes[:name] = value
+    end
+
+    # hash(string,array(string)) - Map of key names to arrays of allowed values. An empty array means free-form text.
+    def definitions
+      @attributes[:definitions]
+    end
+
+    def definitions=(value)
+      @attributes[:definitions] = value
+    end
+
+    # array(string) - Metadata keys that should appear as columns in the UI by default.
+    def default_columns
+      @attributes[:default_columns]
+    end
+
+    def default_columns=(value)
+      @attributes[:default_columns] = value
+    end
+
+    # Parameters:
+    #   name - string - Name of the metadata category.
+    #   default_columns - array(string) - Metadata keys that should appear as columns in the UI by default.
+    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: name must be an String") if params[:name] and !params[:name].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: default_columns must be an Array") if params[:default_columns] and !params[:default_columns].is_a?(Array)
+      raise MissingParameterError.new("Parameter missing: id") unless params[:id]
+
+      Api.send_request("/metadata_categories/#{@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("/metadata_categories/#{@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 = MetadataCategory.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).
+    #   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are .
+    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)
+      raise InvalidParameterError.new("Bad parameter: sort_by must be an Hash") if params[:sort_by] and !params[:sort_by].is_a?(Hash)
+
+      List.new(MetadataCategory, params) do
+        Api.send_request("/metadata_categories", :get, params, options)
+      end
+    end
+
+    def self.all(params = {}, options = {})
+      list(params, options)
+    end
+
+    # Parameters:
+    #   id (required) - int64 - Metadata Category 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("/metadata_categories/#{params[:id]}", :get, params, options)
+      MetadataCategory.new(response.data, options)
+    end
+
+    def self.get(id, params = {}, options = {})
+      find(id, params, options)
+    end
+
+    # Parameters:
+    #   name (required) - string - Name of the metadata category.
+    #   default_columns - array(string) - Metadata keys that should appear as columns in the UI by default.
+    def self.create(params = {}, options = {})
+      raise InvalidParameterError.new("Bad parameter: name must be an String") if params[:name] and !params[:name].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: default_columns must be an Array") if params[:default_columns] and !params[:default_columns].is_a?(Array)
+      raise MissingParameterError.new("Parameter missing: name") unless params[:name]
+
+      response, options = Api.send_request("/metadata_categories", :post, params, options)
+      MetadataCategory.new(response.data, options)
+    end
+
+    # Parameters:
+    #   name - string - Name of the metadata category.
+    #   default_columns - array(string) - Metadata keys that should appear as columns in the UI by default.
+    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: name must be an String") if params[:name] and !params[:name].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: default_columns must be an Array") if params[:default_columns] and !params[:default_columns].is_a?(Array)
+      raise MissingParameterError.new("Parameter missing: id") unless params[:id]
+
+      response, options = Api.send_request("/metadata_categories/#{params[:id]}", :patch, params, options)
+      MetadataCategory.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("/metadata_categories/#{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/notification.rb

@@ -45,6 +45,24 @@ module Files
       @attributes[:group_name] = value
     end
 
+    # array(int64) - Group IDs when the notification requires multiple groups
+    def group_ids
+      @attributes[:group_ids]
+    end
+
+    def group_ids=(value)
+      @attributes[:group_ids] = value
+    end
+
+    # array(string) - Group names when the notification requires multiple groups
+    def group_names
+      @attributes[:group_names]
+    end
+
+    def group_names=(value)
+      @attributes[:group_names] = value
+    end
+
     # array(int64) - If set, will only notify on actions made by a member of one of the specified groups
     def triggering_group_ids
       @attributes[:triggering_group_ids]
@@ -321,6 +339,7 @@ module Files
     #   triggering_user_ids - array(int64) - If set, will only notify on actions made one of the specified users
     #   trigger_by_share_recipients - boolean - Notify when actions are performed by a share recipient?
     #   group_id - int64 - The ID of the group to notify.  Provide `user_id`, `username` or `group_id`.
+    #   group_ids - string - Group IDs when the notification requires multiple groups. If sent as a string, it should be comma-delimited.
     #   path - string - Path
     #   username - string - The username of the user to notify.  Provide `user_id`, `username` or `group_id`.
     def self.create(params = {}, options = {})
@@ -331,6 +350,7 @@ module Files
       raise InvalidParameterError.new("Bad parameter: triggering_group_ids must be an Array") if params[:triggering_group_ids] and !params[:triggering_group_ids].is_a?(Array)
       raise InvalidParameterError.new("Bad parameter: triggering_user_ids must be an Array") if params[:triggering_user_ids] and !params[:triggering_user_ids].is_a?(Array)
       raise InvalidParameterError.new("Bad parameter: group_id must be an Integer") if params[:group_id] and !params[:group_id].is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: group_ids must be an String") if params[:group_ids] and !params[:group_ids].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: path must be an String") if params[:path] and !params[:path].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: username must be an String") if params[:username] and !params[:username].is_a?(String)
 

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

@@ -119,6 +119,11 @@ module Files
       @attributes[:updated_at]
     end
 
+    # array(object) - Array of in-progress file transfers with progress data. Only present when the sync run status is in_progress.
+    def live_transfers
+      @attributes[:live_transfers]
+    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.

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

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Files
+  class SyncRunLiveTransfer
+    attr_reader :options, :attributes
+
+    def initialize(attributes = {}, options = {})
+      @attributes = attributes || {}
+      @options = options || {}
+    end
+
+    # string - The file path being transferred. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
+    def path
+      @attributes[:path]
+    end
+
+    # string - Status of this individual transfer
+    def status
+      @attributes[:status]
+    end
+
+    # int64 - Bytes transferred so far
+    def bytes_copied
+      @attributes[:bytes_copied]
+    end
+
+    # int64 - Total bytes of the file being transferred
+    def bytes_total
+      @attributes[:bytes_total]
+    end
+
+    # double - Transfer progress from 0.0 to 1.0
+    def percentage
+      @attributes[:percentage]
+    end
+
+    # string - Estimated time remaining (human-readable)
+    def eta
+      @attributes[:eta]
+    end
+
+    # string - When this individual transfer started
+    def started_at
+      @attributes[:started_at]
+    end
+  end
+end

data/lib/files.com/version.rb

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

data/lib/files.com.rb

@@ -102,6 +102,7 @@ require "files.com/models/message"
 require "files.com/models/message_comment"
 require "files.com/models/message_comment_reaction"
 require "files.com/models/message_reaction"
+require "files.com/models/metadata_category"
 require "files.com/models/notification"
 require "files.com/models/outbound_connection_log"
 require "files.com/models/partner"
@@ -138,6 +139,7 @@ require "files.com/models/style"
 require "files.com/models/sync"
 require "files.com/models/sync_log"
 require "files.com/models/sync_run"
+require "files.com/models/sync_run_live_transfer"
 require "files.com/models/usage_by_top_level_dir"
 require "files.com/models/usage_daily_snapshot"
 require "files.com/models/usage_snapshot"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.597
+  version: 1.1.599
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-04-06 00:00:00.000000000 Z
+date: 2026-04-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -241,6 +241,7 @@ files:
 - docs/message_comment.md
 - docs/message_comment_reaction.md
 - docs/message_reaction.md
+- docs/metadata_category.md
 - docs/notification.md
 - docs/outbound_connection_log.md
 - docs/partner.md
@@ -277,6 +278,7 @@ files:
 - docs/sync.md
 - docs/sync_log.md
 - docs/sync_run.md
+- docs/sync_run_live_transfer.md
 - docs/usage_by_top_level_dir.md
 - docs/usage_daily_snapshot.md
 - docs/usage_snapshot.md
@@ -367,6 +369,7 @@ files:
 - lib/files.com/models/message_comment.rb
 - lib/files.com/models/message_comment_reaction.rb
 - lib/files.com/models/message_reaction.rb
+- lib/files.com/models/metadata_category.rb
 - lib/files.com/models/notification.rb
 - lib/files.com/models/outbound_connection_log.rb
 - lib/files.com/models/partner.rb
@@ -403,6 +406,7 @@ files:
 - lib/files.com/models/sync.rb
 - lib/files.com/models/sync_log.rb
 - lib/files.com/models/sync_run.rb
+- lib/files.com/models/sync_run_live_transfer.rb
 - lib/files.com/models/usage_by_top_level_dir.rb
 - lib/files.com/models/usage_daily_snapshot.rb
 - lib/files.com/models/usage_snapshot.rb