files.com 1.1.598 → 1.1.599

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4eb1e3edc5f2b456c8e477c29015566cb158904c76133f95c3b0f47280259c0f
-  data.tar.gz: 5dad72b649848fd879dce367f8d61e95ada837164d1f10791bfc12ceb07699ef
+  metadata.gz: 64cc6a922c509ca8088eebf8f4588afe2ea532620b021d53fb9faa4d49819215
+  data.tar.gz: ff44b071a6ebc13928f00a09a306ac0efa58adec544eef2cc99ce7d824c0c8ea
 SHA512:
-  metadata.gz: 63d82719bd0f2a75d488ab6b56697a704bc9ab808b6720bdb067cafaedac3b3e18f3c0b114d8469f7fc4bc4fbf5ef3a35c959a1d2b106a987f78195779014ea5
-  data.tar.gz: efb2566edb01bc24fde3aae8522670c0ccf271bcf9db4f1869aa7cecdadad4b57364fe683980da8556fc4b1c6c7937517534bbed55555c3b2cd06bb040d1f33e
+  metadata.gz: 84f3e3d529b8e7a654e1cf3809fa1b58ec30e97a62e2987b956d409f7884fb06131b73c48bf72f633b12716fc0dd3144549165e8d449d3bf3ad8c00cad02c955
+  data.tar.gz: b199981cfa1b82388525c337c0421be07caad4cc0d78209f9c99baf88b03416d0dabe809749fadb779b4e6163c1625289af65bf26150381c5aebb3c377d92ce3

data/_VERSION

@@ -1 +1 @@
-1.1.598
+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/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/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Files
-  VERSION = "1.1.598"
+  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"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.598
+  version: 1.1.599
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-04-09 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
@@ -368,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