files.com 1.0.85 → 1.0.90

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4f256669e61998c0d04e226d0f790790fe0727fff5a0a4ff5d91711e91b207dc
-  data.tar.gz: 13c775f7f838a326c807878ea590e4ebb326177b557ef7ab4934a8e3888e2f0d
+  metadata.gz: ebf4d4605addae148b16bbe121b65c0e49c1d15c6ea46a2b1f056a0bfd3cd8d2
+  data.tar.gz: a8880dab867bbbc0ebb640cc39cf3aa2e7898efa9ac81fd39bcf30a060d898bf
 SHA512:
-  metadata.gz: dc7836b465ba29c3161ef92d853994f4fe186623c58bb3fa9f46e126dcbb6f34aa189a90b21d80c49cb3b8610af3e64a84dde4a017743df29357849bee536222
-  data.tar.gz: 7c09856639a412cfe9e24aad75fdf3bfdca104d7f7077126f3c4c4f9b7b192251a0fd648e11c38e720f45afc78a45bf958a38fe09c33198435c25625c2e8cdc6
+  metadata.gz: f1bf9ea0d78910f4c41926f971113527b199392dfa2739ac1f389f87b5947023906b7a622e9e2961b503c3b95b833435806892d74bab5a023634badd850e6acb
+  data.tar.gz: e6b8a6b3b6e012c9b9d01f70d5835f39622dc3cf9656701f29c54c774af987a7f0605d540aa1c5f20115ecef1cfa65f7f47bbb8e59eb4e67c3d9a32219dee824

data/SECURITY.md

@@ -0,0 +1,24 @@
+# Security Policy
+
+Thank you for your interest in Files.com security.  We recognize that your data is very personal and sensitive and we work hard to keep it protected.
+
+
+## Supported Versions
+
+Only the latest version will be supported with security updates.
+
+
+## Reporting a Vulnerability
+
+Here at Files.com, we celebrate security and we encourage independent security researchers to help us keep our products secure.
+
+We offer a Security Bug Bounty Program to create an incentive and reward structure so that researchers are able to devote resources to working on Files.com.
+
+We offer our Bug Bounty Program on HackerOne at https://hackerone.com/files
+
+We prefer to receive reports of vulnerabilities there.
+
+If you do not wish to use HackerOne, alternate submission instructions are available at:
+https://www.files.com/legal/security-bounty/
+
+Thank you for helping keep the Files.com community secure!

data/_VERSION

@@ -1 +1 @@
-1.0.85
+1.0.90

data/docs/api_key.md

@@ -11,6 +11,7 @@
   "key": "[key]",
   "last_use_at": "2000-01-01T01:00:00Z",
   "name": "My Main API Key",
+  "path": "shared/docs",
   "permission_set": "full",
   "platform": "win32",
   "user_id": 1
@@ -24,6 +25,7 @@
 * `key` (string): API Key actual key string
 * `last_use_at` (date-time): API Key last used - note this value is only updated once per 3 hour period, so the 'actual' time of last use may be up to 3 hours later than this timestamp.
 * `name` (string): Internal name for the API Key.  For your use.
+* `path` (string): Folder path restriction for this api key. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
 * `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.
 * `platform` (string): If this API key represents a Desktop app, what platform was it created on?
 * `user_id` (int64): User ID for the owner of this API Key.  May be blank for Site-wide API Keys.
@@ -47,6 +49,14 @@ Files::ApiKey.list(
 * `page` (int64): Current page number.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `action` (string): Deprecated: If set to `count` returns a count of matching records rather than the records themselves.
+* `cursor` (string): Send cursor to resume an existing list from the point at which you left off.  Get a cursor from an existing list via the X-Files-Cursor-Next header.
+* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `deleted_at` and `expires_at`.
+* `filter` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `expires_at`.
+* `filter_gt` (object): If set, return records where the specifiied field is greater than the supplied value. Valid fields are `expires_at`.
+* `filter_gteq` (object): If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are `expires_at`.
+* `filter_like` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `expires_at`.
+* `filter_lt` (object): If set, return records where the specifiied field is less than the supplied value. Valid fields are `expires_at`.
+* `filter_lteq` (object): If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are `expires_at`.
 
 
 ---
@@ -80,7 +90,8 @@ Files::ApiKey.create(
   user_id: 1, 
   name: "My Main API Key", 
   expires_at: "2000-01-01T01:00:00Z", 
-  permission_set: "full"
+  permission_set: "full", 
+  path: "shared/docs"
 )
 ```
 
@@ -90,6 +101,7 @@ Files::ApiKey.create(
 * `name` (string): Internal name for the API Key.  For your use.
 * `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.
 
 
 ---

data/docs/app.md

@@ -7,6 +7,8 @@
   "name": "",
   "extended_description": "",
   "documentation_links": "Important Info => http://files.test/learn-more",
+  "logo_url": "",
+  "logo_thumbnail_url": "",
   "sso_strategy_type": "",
   "remote_server_type": "",
   "folder_behavior_type": "",
@@ -19,6 +21,8 @@
 * `name` (string): Name of the App
 * `extended_description` (string): Long form description of the App
 * `documentation_links` (string): Collection of named links to documentation
+* `logo_url` (string): Full size logo for the App
+* `logo_thumbnail_url` (string): Logo thumbnail for the App
 * `sso_strategy_type` (string): Associated SSO Strategy type, if any
 * `remote_server_type` (string): Associated Remote Server type, if any
 * `folder_behavior_type` (string): Associated Folder Behavior type, if any
@@ -43,3 +47,11 @@ Files::App.list(
 * `page` (int64): Current page number.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `action` (string): Deprecated: If set to `count` returns a count of matching records rather than the records themselves.
+* `cursor` (string): Send cursor to resume an existing list from the point at which you left off.  Get a cursor from an existing list via the X-Files-Cursor-Next header.
+* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `name` and `app_type`.
+* `filter` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `name` and `app_type`.
+* `filter_gt` (object): If set, return records where the specifiied field is greater than the supplied value. Valid fields are `name` and `app_type`.
+* `filter_gteq` (object): If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are `name` and `app_type`.
+* `filter_like` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `name` and `app_type`.
+* `filter_lt` (object): If set, return records where the specifiied field is less than the supplied value. Valid fields are `name` and `app_type`.
+* `filter_lteq` (object): If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are `name` and `app_type`.

data/docs/automation.md

@@ -56,7 +56,15 @@ Files::Automation.list(
 * `page` (int64): Current page number.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `action` (string): Deprecated: If set to `count` returns a count of matching records rather than the records themselves.
-* `automation` (string): Type of automation to filter by.
+* `cursor` (string): Send cursor to resume an existing list from the point at which you left off.  Get a cursor from an existing list via the X-Files-Cursor-Next header.
+* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `site_id` and `automation`.
+* `filter` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `automation`.
+* `filter_gt` (object): If set, return records where the specifiied field is greater than the supplied value. Valid fields are `automation`.
+* `filter_gteq` (object): If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are `automation`.
+* `filter_like` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `automation`.
+* `filter_lt` (object): If set, return records where the specifiied field is less than the supplied value. Valid fields are `automation`.
+* `filter_lteq` (object): If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are `automation`.
+* `automation` (string): DEPRECATED: Type of automation to filter by. Use `filter[automation]` instead.
 
 
 ---

data/docs/behavior.md

@@ -39,9 +39,30 @@ Files::Behavior.list(
 * `page` (int64): Current page number.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `action` (string): Deprecated: If set to `count` returns a count of matching records rather than the records themselves.
+* `cursor` (string): Send cursor to resume an existing list from the point at which you left off.  Get a cursor from an existing list via the X-Files-Cursor-Next header.
+* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `site_id` and `behavior`.
+* `filter` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `behavior`.
+* `filter_gt` (object): If set, return records where the specifiied field is greater than the supplied value. Valid fields are `behavior`.
+* `filter_gteq` (object): If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are `behavior`.
+* `filter_like` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `behavior`.
+* `filter_lt` (object): If set, return records where the specifiied field is less than the supplied value. Valid fields are `behavior`.
+* `filter_lteq` (object): If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are `behavior`.
 * `behavior` (string): If set, only shows folder behaviors matching this behavior type.
 
 
+---
+
+## Show Behavior
+
+```
+Files::Behavior.find(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Behavior ID.
+
+
 ---
 
 ## List Behaviors by path
@@ -59,22 +80,17 @@ Files::Behavior.list_for(path,
 * `page` (int64): Current page number.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `action` (string): Deprecated: If set to `count` returns a count of matching records rather than the records themselves.
+* `cursor` (string): Send cursor to resume an existing list from the point at which you left off.  Get a cursor from an existing list via the X-Files-Cursor-Next header.
+* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `site_id` and `behavior`.
+* `filter` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `behavior`.
+* `filter_gt` (object): If set, return records where the specifiied field is greater than the supplied value. Valid fields are `behavior`.
+* `filter_gteq` (object): If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are `behavior`.
+* `filter_like` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `behavior`.
+* `filter_lt` (object): If set, return records where the specifiied field is less than the supplied value. Valid fields are `behavior`.
+* `filter_lteq` (object): If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are `behavior`.
 * `path` (string): Required - Path to operate on.
 * `recursive` (string): Show behaviors above this path?
-* `behavior` (string): If set only shows folder behaviors matching this behavior type.
-
-
----
-
-## Show Behavior
-
-```
-Files::Behavior.find(id)
-```
-
-### Parameters
-
-* `id` (int64): Required - Behavior ID.
+* `behavior` (string): DEPRECATED: If set only shows folder behaviors matching this behavior type. Use `filter[behavior]` instead.
 
 
 ---

data/docs/bundle.md

@@ -62,6 +62,14 @@ Files::Bundle.list(
 * `page` (int64): Current page number.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `action` (string): Deprecated: If set to `count` returns a count of matching records rather than the records themselves.
+* `cursor` (string): Send cursor to resume an existing list from the point at which you left off.  Get a cursor from an existing list via the X-Files-Cursor-Next header.
+* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `site_id`, `created_at` or `code`.
+* `filter` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `created_at`.
+* `filter_gt` (object): If set, return records where the specifiied field is greater than the supplied value. Valid fields are `created_at`.
+* `filter_gteq` (object): If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are `created_at`.
+* `filter_like` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `created_at`.
+* `filter_lt` (object): If set, return records where the specifiied field is less than the supplied value. Valid fields are `created_at`.
+* `filter_lteq` (object): If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are `created_at`.
 
 
 ---

data/docs/file.md

@@ -61,7 +61,6 @@ may places where a Ruby File object can be used.
 
 ```
 Files::File.download(path, 
-  id: 1, 
   with_previews: true, 
   with_priority_color: true
 )
@@ -71,7 +70,6 @@ Files::File.download(path,
 
 * `path` (string): Required - Path to operate on.
 * `action` (string): Can be blank, `redirect` or `stat`.  If set to `stat`, we will return file information but without a download URL, and without logging a download.  If set to `redirect` we will serve a 302 redirect directly to the file.  This is used for integrations with Zapier, and is not recommended for most integrations.
-* `id` (int64): If provided, lookup the file by id instead of path.
 * `preview_size` (string): Request a preview size.  Can be `small` (default), `large`, `xlarge`, or `pdf`.
 * `with_previews` (boolean): Include file preview information?
 * `with_priority_color` (boolean): Include file priority color information?
@@ -154,7 +152,6 @@ Files::File.delete(path,
 file = Files::File.list_for(path).first
 
 file.download(
-  id: 1,
   with_previews: true,
   with_priority_color: true
 )
@@ -164,7 +161,6 @@ file.download(
 
 * `path` (string): Required - Path to operate on.
 * `action` (string): Can be blank, `redirect` or `stat`.  If set to `stat`, we will return file information but without a download URL, and without logging a download.  If set to `redirect` we will serve a 302 redirect directly to the file.  This is used for integrations with Zapier, and is not recommended for most integrations.
-* `id` (int64): If provided, lookup the file by id instead of path.
 * `preview_size` (string): Request a preview size.  Can be `small` (default), `large`, `xlarge`, or `pdf`.
 * `with_previews` (boolean): Include file preview information?
 * `with_priority_color` (boolean): Include file priority color information?

data/docs/group.md

@@ -43,6 +43,14 @@ Files::Group.list(
 * `page` (int64): Current page number.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `action` (string): Deprecated: If set to `count` returns a count of matching records rather than the records themselves.
+* `cursor` (string): Send cursor to resume an existing list from the point at which you left off.  Get a cursor from an existing list via the X-Files-Cursor-Next header.
+* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `active`, `deleted_at`, `site_id` or `name`.
+* `filter` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `name`.
+* `filter_gt` (object): If set, return records where the specifiied field is greater than the supplied value. Valid fields are `name`.
+* `filter_gteq` (object): If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are `name`.
+* `filter_like` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `name`.
+* `filter_lt` (object): If set, return records where the specifiied field is less than the supplied value. Valid fields are `name`.
+* `filter_lteq` (object): If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are `name`.
 * `ids` (string): Comma-separated list of group ids to include in results.
 
 

data/docs/history.md

@@ -58,6 +58,8 @@ Files::History.list_for_file(path,
 * `page` (int64): Current page number.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `action` (string): Deprecated: If set to `count` returns a count of matching records rather than the records themselves.
+* `cursor` (string): Send cursor to resume an existing list from the point at which you left off.  Get a cursor from an existing list via the X-Files-Cursor-Next header.
+* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `user_id` and `created_at`.
 * `path` (string): Required - Path to operate on.
 
 
@@ -82,6 +84,8 @@ Files::History.list_for_folder(path,
 * `page` (int64): Current page number.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `action` (string): Deprecated: If set to `count` returns a count of matching records rather than the records themselves.
+* `cursor` (string): Send cursor to resume an existing list from the point at which you left off.  Get a cursor from an existing list via the X-Files-Cursor-Next header.
+* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `user_id` and `created_at`.
 * `path` (string): Required - Path to operate on.
 
 
@@ -106,6 +110,8 @@ Files::History.list_for_user(user_id,
 * `page` (int64): Current page number.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `action` (string): Deprecated: If set to `count` returns a count of matching records rather than the records themselves.
+* `cursor` (string): Send cursor to resume an existing list from the point at which you left off.  Get a cursor from an existing list via the X-Files-Cursor-Next header.
+* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `user_id` and `created_at`.
 * `user_id` (int64): Required - User ID.
 
 
@@ -130,6 +136,8 @@ Files::History.list_logins(
 * `page` (int64): Current page number.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `action` (string): Deprecated: If set to `count` returns a count of matching records rather than the records themselves.
+* `cursor` (string): Send cursor to resume an existing list from the point at which you left off.  Get a cursor from an existing list via the X-Files-Cursor-Next header.
+* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `user_id` and `created_at`.
 
 
 ---
@@ -153,3 +161,11 @@ Files::History.list(
 * `page` (int64): Current page number.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `action` (string): Deprecated: If set to `count` returns a count of matching records rather than the records themselves.
+* `cursor` (string): Send cursor to resume an existing list from the point at which you left off.  Get a cursor from an existing list via the X-Files-Cursor-Next header.
+* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `site_id`, `path`, `created_at`, `folder` or `user_id`.
+* `filter` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `user_id`, `folder` or `path`.
+* `filter_gt` (object): If set, return records where the specifiied field is greater than the supplied value. Valid fields are `user_id`, `folder` or `path`.
+* `filter_gteq` (object): If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are `user_id`, `folder` or `path`.
+* `filter_like` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `user_id`, `folder` or `path`.
+* `filter_lt` (object): If set, return records where the specifiied field is less than the supplied value. Valid fields are `user_id`, `folder` or `path`.
+* `filter_lteq` (object): If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are `user_id`, `folder` or `path`.

data/docs/ip_address.md

@@ -35,3 +35,21 @@ Files::IpAddress.list(
 * `page` (int64): Current page number.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `action` (string): Deprecated: If set to `count` returns a count of matching records rather than the records themselves.
+
+
+---
+
+## List all possible public IP addresses
+
+```
+Files::IpAddress.get_reserved(
+  page: 1, 
+  per_page: 1
+)
+```
+
+### Parameters
+
+* `page` (int64): Current page number.
+* `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
+* `action` (string): Deprecated: If set to `count` returns a count of matching records rather than the records themselves.

data/docs/message.md

@@ -18,7 +18,7 @@
 * `body` (string): Message body.
 * `comments` (array): Comments.
 * `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
-* `project_id` (int64): Project to attach the message to.
+* `project_id` (int64): Project to which the message should be attached.
 
 
 ---
@@ -40,7 +40,7 @@ Files::Message.list(
 * `page` (int64): Current page number.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `action` (string): Deprecated: If set to `count` returns a count of matching records rather than the records themselves.
-* `project_id` (int64): Required - Project to return messages for.
+* `project_id` (int64): Required - Project for which to return messages.
 
 
 ---
@@ -64,15 +64,15 @@ Files::Message.find(id)
 Files::Message.create(
   user_id: 1, 
   project_id: 1, 
-  subject: "subject", 
-  body: "body"
+  subject: "Files.com Account Upgrade", 
+  body: "We should upgrade our Files.com account!"
 )
 ```
 
 ### Parameters
 
 * `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
-* `project_id` (int64): Required - Project to attach the message to.
+* `project_id` (int64): Required - Project to which the message should be attached.
 * `subject` (string): Required - Message subject.
 * `body` (string): Required - Message body.
 
@@ -84,15 +84,15 @@ Files::Message.create(
 ```
 Files::Message.update(id, 
   project_id: 1, 
-  subject: "subject", 
-  body: "body"
+  subject: "Files.com Account Upgrade", 
+  body: "We should upgrade our Files.com account!"
 )
 ```
 
 ### Parameters
 
 * `id` (int64): Required - Message ID.
-* `project_id` (int64): Required - Project to attach the message to.
+* `project_id` (int64): Required - Project to which the message should be attached.
 * `subject` (string): Required - Message subject.
 * `body` (string): Required - Message body.
 
@@ -119,15 +119,15 @@ message = Files::Message.list_for(path).first
 
 message.update(
   project_id: 1,
-  subject: "subject",
-  body: "body"
+  subject: "Files.com Account Upgrade",
+  body: "We should upgrade our Files.com account!"
 )
 ```
 
 ### Parameters
 
 * `id` (int64): Required - Message ID.
-* `project_id` (int64): Required - Project to attach the message to.
+* `project_id` (int64): Required - Project to which the message should be attached.
 * `subject` (string): Required - Message subject.
 * `body` (string): Required - Message body.
 

data/docs/notification.md

@@ -50,11 +50,19 @@ Files::Notification.list(
 
 ### Parameters
 
-* `user_id` (int64): Show notifications for this User ID.
+* `user_id` (int64): DEPRECATED: Show notifications for this User ID. Use `filter[user_id]` instead.
 * `page` (int64): Current page number.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `action` (string): Deprecated: If set to `count` returns a count of matching records rather than the records themselves.
-* `group_id` (int64): Show notifications for this Group ID.
+* `cursor` (string): Send cursor to resume an existing list from the point at which you left off.  Get a cursor from an existing list via the X-Files-Cursor-Next header.
+* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `site_id`, `path`, `user_id` or `group_id`.
+* `filter` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `user_id`, `group_id` or `path`.
+* `filter_gt` (object): If set, return records where the specifiied field is greater than the supplied value. Valid fields are `user_id`, `group_id` or `path`.
+* `filter_gteq` (object): If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are `user_id`, `group_id` or `path`.
+* `filter_like` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `user_id`, `group_id` or `path`.
+* `filter_lt` (object): If set, return records where the specifiied field is less than the supplied value. Valid fields are `user_id`, `group_id` or `path`.
+* `filter_lteq` (object): If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are `user_id`, `group_id` or `path`.
+* `group_id` (int64): DEPRECATED: Show notifications for this Group ID. Use `filter[group_id]` instead.
 * `path` (string): Show notifications for this Path.
 * `include_ancestors` (boolean): If `include_ancestors` is `true` and `path` is specified, include notifications for any parent paths. Ignored if `path` is not specified.
 

data/docs/permission.md

@@ -44,9 +44,17 @@ Files::Permission.list(path,
 * `page` (int64): Current page number.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `action` (string): Deprecated: If set to `count` returns a count of matching records rather than the records themselves.
-* `path` (string): Permission path.  If provided, will scope permissions to this path.
-* `group_id` (string): Group ID.  If provided, will scope permissions to this group.
-* `user_id` (string): User ID.  If provided, will scope permissions to this user.
+* `cursor` (string): Send cursor to resume an existing list from the point at which you left off.  Get a cursor from an existing list via the X-Files-Cursor-Next header.
+* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `deleted_at`, `group_id`, `path`, `user_id` or `permission`.
+* `filter` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `group_id`, `user_id` or `path`.
+* `filter_gt` (object): If set, return records where the specifiied field is greater than the supplied value. Valid fields are `group_id`, `user_id` or `path`.
+* `filter_gteq` (object): If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are `group_id`, `user_id` or `path`.
+* `filter_like` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `group_id`, `user_id` or `path`.
+* `filter_lt` (object): If set, return records where the specifiied field is less than the supplied value. Valid fields are `group_id`, `user_id` or `path`.
+* `filter_lteq` (object): If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are `group_id`, `user_id` or `path`.
+* `path` (string): DEPRECATED: Permission path.  If provided, will scope permissions to this path. Use `filter[path]` instead.
+* `group_id` (string): DEPRECATED: Group ID.  If provided, will scope permissions to this group. Use `filter[group_id]` instead.`
+* `user_id` (string): DEPRECATED: User ID.  If provided, will scope permissions to this user. Use `filter[user_id]` instead.`
 * `include_groups` (boolean): If searching by user or group, also include user's permissions that are inherited from its groups?