files.com 1.0.294 → 1.0.295

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cdaf110d3bd4999c4190b8ce6994037a0f12d7591b50f611b2059962f8591b04
-  data.tar.gz: 19bd25c8c5693b35ea942252128e1badb0f2bd9ce47265d6ff129e88213c38eb
+  metadata.gz: 82443d7ca9d90f9c75a2ffbec984dc28f875d9b2017d1ef4678da0bb53b31dfc
+  data.tar.gz: fcff7ee54c6248b30113e496d7a3d0216b39172d7d6b54bfcc1f5ce54d388e3b
 SHA512:
-  metadata.gz: 220ecfe32113cb98ff6f74a9a6953585da1e90434b79396bc071f970a48b56f3ae344dcc1570bc9aeef3dd2cdd917b834c912310b078633af397c76c50eec39d
-  data.tar.gz: e6597bb77b9b7894f101e92074d1f38900706637c73a0b90d78af9252ce2efb4a4160746585a0bfafa6d1212a6fd8ba35de5025ffccd63141200a2c94932c362
+  metadata.gz: 914a9e15f726f4459e6ed2c353cdad5ce893aa4ad689d6d4fa303bf0e9cd7c00e43222f13d11540de3542a848193e208e85c2d4810c8f3eb81fc3f367b7d147b
+  data.tar.gz: 345a767395649169913f54f6cab4ada5e0118c085da8986181dba594c28e12f18f0fc97f3a4dd14f4ccb89190d5241399b3a633746919ede7ae283e8fbdfa973

data/_VERSION

@@ -1 +1 @@
-1.0.294
+1.0.295

data/docs/api_key.md

@@ -6,6 +6,7 @@
 {
   "id": 1,
   "descriptive_label": "Site-wide API key for https://site.files.com/ (key ID #1)",
+  "description": "",
   "created_at": "2000-01-01T01:00:00Z",
   "expires_at": "2000-01-01T01:00:00Z",
   "key": "[key]",
@@ -20,6 +21,7 @@
 
 * `id` (int64): API Key ID
 * `descriptive_label` (string): Unique label that describes this API key.  Useful for external systems where you may have API keys from multiple accounts and want a human-readable label for each key.
+* `description` (string): User-supplied description of API key.
 * `created_at` (date-time): Time which API Key was created
 * `expires_at` (date-time): API Key expiration date
 * `key` (string): API Key actual key string
@@ -96,6 +98,7 @@ Files::ApiKey.create(
 
 * `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
 * `name` (string): Internal name for the API Key.  For your use.
+* `description` (string): User-supplied description of API key.
 * `expires_at` (string): API Key expiration date
 * `permission_set` (string): Permissions for this API Key.  Keys with the `desktop_app` permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations).  Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges.  If you have ideas for permission sets, please let us know.
 * `path` (string): Folder path restriction for this api key.
@@ -136,6 +139,7 @@ Files::ApiKey.update(id,
 
 * `id` (int64): Required - Api Key ID.
 * `name` (string): Internal name for the API Key.  For your use.
+* `description` (string): User-supplied description of API key.
 * `expires_at` (string): API Key expiration date
 * `permission_set` (string): Permissions for this API Key.  Keys with the `desktop_app` permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations).  Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges.  If you have ideas for permission sets, please let us know.
 
@@ -180,6 +184,7 @@ api_key.update(
 
 * `id` (int64): Required - Api Key ID.
 * `name` (string): Internal name for the API Key.  For your use.
+* `description` (string): User-supplied description of API key.
 * `expires_at` (string): API Key expiration date
 * `permission_set` (string): Permissions for this API Key.  Keys with the `desktop_app` permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations).  Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges.  If you have ideas for permission sets, please let us know.
 

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

@@ -27,6 +27,15 @@ module Files
       @attributes[:descriptive_label] = value
     end
 
+    # string - User-supplied description of API key.
+    def description
+      @attributes[:description]
+    end
+
+    def description=(value)
+      @attributes[:description] = value
+    end
+
     # date-time - Time which API Key was created
     def created_at
       @attributes[:created_at]
@@ -106,6 +115,7 @@ module Files
 
     # Parameters:
     #   name - string - Internal name for the API Key.  For your use.
+    #   description - string - User-supplied description of API key.
     #   expires_at - string - API Key expiration date
     #   permission_set - string - Permissions for this API Key.  Keys with the `desktop_app` permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations).  Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges.  If you have ideas for permission sets, please let us know.
     def update(params = {})
@@ -114,6 +124,7 @@ module Files
       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: description must be an String") if params[:description] and !params[:description].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: expires_at must be an String") if params[:expires_at] and !params[:expires_at].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: permission_set must be an String") if params[:permission_set] and !params[:permission_set].is_a?(String)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
@@ -200,12 +211,14 @@ module Files
     # Parameters:
     #   user_id - int64 - User ID.  Provide a value of `0` to operate the current session's user.
     #   name - string - Internal name for the API Key.  For your use.
+    #   description - string - User-supplied description of API key.
     #   expires_at - string - API Key expiration date
     #   permission_set - string - Permissions for this API Key.  Keys with the `desktop_app` permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations).  Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges.  If you have ideas for permission sets, please let us know.
     #   path - string - Folder path restriction for this api key.
     def self.create(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: user_id must be an Integer") if params[:user_id] and !params[:user_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: description must be an String") if params[:description] and !params[:description].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: expires_at must be an String") if params[:expires_at] and !params[:expires_at].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: permission_set must be an String") if params[:permission_set] and !params[:permission_set].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: path must be an String") if params[:path] and !params[:path].is_a?(String)
@@ -229,6 +242,7 @@ module Files
 
     # Parameters:
     #   name - string - Internal name for the API Key.  For your use.
+    #   description - string - User-supplied description of API key.
     #   expires_at - string - API Key expiration date
     #   permission_set - string - Permissions for this API Key.  Keys with the `desktop_app` permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations).  Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges.  If you have ideas for permission sets, please let us know.
     def self.update(id, params = {}, options = {})
@@ -236,6 +250,7 @@ module Files
       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: description must be an String") if params[:description] and !params[:description].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: expires_at must be an String") if params[:expires_at] and !params[:expires_at].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: permission_set must be an String") if params[:permission_set] and !params[:permission_set].is_a?(String)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.0.294
+  version: 1.0.295
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-09-21 00:00:00.000000000 Z
+date: 2022-09-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable