files.com 1.2.221 → 1.2.223

package/_VERSION

@@ -1 +1 @@
-1.2.221
+1.2.223

package/docs/models/ActionNotificationExport.md

@@ -5,7 +5,7 @@
 ```
 {
   "id": 1,
-  "export_version": "example",
+  "export_version": "20201213.2",
   "start_at": "2000-01-01T01:00:00Z",
   "end_at": "2000-01-01T01:00:00Z",
   "status": "ready",

package/docs/models/Automation.md

@@ -45,7 +45,18 @@
   "recurring_day": 25,
   "retry_on_failure_interval_in_minutes": 60,
   "retry_on_failure_number_of_attempts": 10,
-  "schedule": "example",
+  "schedule": {
+    "days_of_week": [
+      0,
+      2,
+      4
+    ],
+    "times_of_day": [
+      "06:30",
+      "14:30"
+    ],
+    "time_zone": "Eastern Time (US & Canada)"
+  },
   "human_readable_schedule": "Triggered every Monday, Wednesday at 6:30 AM,\n  2:30 PM Eastern Time (US & Canada) TZ",
   "schedule_days_of_week": [
     0,
@@ -79,7 +90,7 @@
 ```
 
 * `id` (int64): Automation ID
-* `always_overwrite_size_matching_files` (boolean): Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.
+* `always_overwrite_size_matching_files` (boolean): Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.  This setting has no effect unless `overwrite_files` is also set to `true`.
 * `automation` (string): Automation type
 * `deleted` (boolean): Indicates if the automation has been deleted.
 * `description` (string): Description for the this Automation.
@@ -96,7 +107,7 @@
 * `last_modified_at` (date-time): Time when automation was last modified. Does not change for name or description updates.
 * `legacy_folder_matching` (boolean): If `true`, use the legacy behavior for this automation, where it can operate on folders in addition to just files.  This behavior no longer works and should not be used.
 * `name` (string): Name for this automation.
-* `overwrite_files` (boolean): If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `:always_overwrite_size_matching_files` option to override this.
+* `overwrite_files` (boolean): If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `always_overwrite_size_matching_files` option in conjunction with `overwrite_files` to override this behavior and overwrite files no matter what.
 * `path` (string): Path on which this Automation runs.  Supports globs, except on remote mounts. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
 * `path_time_zone` (string): Timezone to use when rendering timestamps in paths.
 * `recurring_day` (int64): If trigger type is `daily`, this specifies a day number to run in one of the supported intervals: `week`, `month`, `quarter`, `year`.
@@ -203,7 +214,7 @@ await Automation.create({
 * `schedule_days_of_week` (array(int64)): If trigger is `custom_schedule`. A list of days of the week to run this automation. 0 is Sunday, 1 is Monday, etc.
 * `schedule_times_of_day` (array(string)): If trigger is `custom_schedule`. A list of times of day to run this automation. 24-hour time format.
 * `schedule_time_zone` (string): If trigger is `custom_schedule`. Time zone for the schedule.
-* `always_overwrite_size_matching_files` (boolean): Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.
+* `always_overwrite_size_matching_files` (boolean): Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.  This setting has no effect unless `overwrite_files` is also set to `true`.
 * `description` (string): Description for the this Automation.
 * `disabled` (boolean): If true, this automation will not run.
 * `exclude_pattern` (string): If set, this glob pattern will exclude files from the automation. Supports globs, except on remote mounts.
@@ -212,7 +223,7 @@ await Automation.create({
 * `ignore_locked_folders` (boolean): If true, the Lock Folders behavior will be disregarded for automated actions.
 * `legacy_folder_matching` (boolean): DEPRECATED: If `true`, use the legacy behavior for this automation, where it can operate on folders in addition to just files.  This behavior no longer works and should not be used.
 * `name` (string): Name for this automation.
-* `overwrite_files` (boolean): If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `:always_overwrite_size_matching_files` option to override this.
+* `overwrite_files` (boolean): If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `always_overwrite_size_matching_files` option in conjunction with `overwrite_files` to override this behavior and overwrite files no matter what.
 * `path_time_zone` (string): Timezone to use when rendering timestamps in paths.
 * `retry_on_failure_interval_in_minutes` (int64): If the Automation fails, retry at this interval (in minutes).  Acceptable values are 5 through 1440 (one day).  Set to null to disable.
 * `retry_on_failure_number_of_attempts` (int64): If the Automation fails, retry at most this many times.  Maximum allowed value: 10.  Set to null to disable.
@@ -293,7 +304,7 @@ await automation.update({
 * `schedule_days_of_week` (array(int64)): If trigger is `custom_schedule`. A list of days of the week to run this automation. 0 is Sunday, 1 is Monday, etc.
 * `schedule_times_of_day` (array(string)): If trigger is `custom_schedule`. A list of times of day to run this automation. 24-hour time format.
 * `schedule_time_zone` (string): If trigger is `custom_schedule`. Time zone for the schedule.
-* `always_overwrite_size_matching_files` (boolean): Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.
+* `always_overwrite_size_matching_files` (boolean): Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.  This setting has no effect unless `overwrite_files` is also set to `true`.
 * `description` (string): Description for the this Automation.
 * `disabled` (boolean): If true, this automation will not run.
 * `exclude_pattern` (string): If set, this glob pattern will exclude files from the automation. Supports globs, except on remote mounts.
@@ -302,7 +313,7 @@ await automation.update({
 * `ignore_locked_folders` (boolean): If true, the Lock Folders behavior will be disregarded for automated actions.
 * `legacy_folder_matching` (boolean): DEPRECATED: If `true`, use the legacy behavior for this automation, where it can operate on folders in addition to just files.  This behavior no longer works and should not be used.
 * `name` (string): Name for this automation.
-* `overwrite_files` (boolean): If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `:always_overwrite_size_matching_files` option to override this.
+* `overwrite_files` (boolean): If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `always_overwrite_size_matching_files` option in conjunction with `overwrite_files` to override this behavior and overwrite files no matter what.
 * `path_time_zone` (string): Timezone to use when rendering timestamps in paths.
 * `retry_on_failure_interval_in_minutes` (int64): If the Automation fails, retry at this interval (in minutes).  Acceptable values are 5 through 1440 (one day).  Set to null to disable.
 * `retry_on_failure_number_of_attempts` (int64): If the Automation fails, retry at most this many times.  Maximum allowed value: 10.  Set to null to disable.
@@ -357,7 +368,18 @@ await automation.update({
   "recurring_day": 25,
   "retry_on_failure_interval_in_minutes": 60,
   "retry_on_failure_number_of_attempts": 10,
-  "schedule": "example",
+  "schedule": {
+    "days_of_week": [
+      0,
+      2,
+      4
+    ],
+    "times_of_day": [
+      "06:30",
+      "14:30"
+    ],
+    "time_zone": "Eastern Time (US & Canada)"
+  },
   "human_readable_schedule": "Triggered every Monday, Wednesday at 6:30 AM,\n  2:30 PM Eastern Time (US & Canada) TZ",
   "schedule_days_of_week": [
     0,

package/docs/models/AutomationRun.md

@@ -8,7 +8,7 @@
   "automation_id": 1,
   "completed_at": "2000-01-01T01:00:00Z",
   "created_at": "2000-01-01T01:00:00Z",
-  "retry_at": "example",
+  "retry_at": "2000-01-01T01:00:00Z",
   "retried_at": "2000-01-01T01:00:00Z",
   "retried_in_run_id": 1,
   "retry_of_run_id": 1,
@@ -24,7 +24,7 @@
 * `automation_id` (int64): ID of the associated Automation.
 * `completed_at` (date-time): Automation run completion/failure date/time.
 * `created_at` (date-time): Automation run start date/time.
-* `retry_at` (string): If set, this automation will be retried at this date/time due to `failure` or `partial_failure`.
+* `retry_at` (date-time): If set, this automation will be retried at this date/time due to `failure` or `partial_failure`.
 * `retried_at` (date-time): If set, this Automation run was retried due to `failure` or `partial_failure`.
 * `retried_in_run_id` (int64): ID of the run that is or will be retrying this run.
 * `retry_of_run_id` (int64): ID of the original run that this run is retrying.

package/docs/models/Behavior.md

@@ -11,7 +11,7 @@
   "name": "example",
   "description": "example",
   "value": {
-    "key": "example value"
+    "method": "GET"
   },
   "disable_parent_folder_behavior": true,
   "recursive": true
@@ -172,7 +172,7 @@ await behavior.update({
   "name": "example",
   "description": "example",
   "value": {
-    "key": "example value"
+    "method": "GET"
   },
   "disable_parent_folder_behavior": true,
   "recursive": true

package/docs/models/DnsRecord.md

@@ -4,7 +4,7 @@
 
 ```
 {
-  "id": "example",
+  "id": "customdomain.com-CNAME-site.files.com",
   "domain": "my-custom-domain.com",
   "rrtype": "CNAME",
   "value": "mysite.files.com"

package/docs/models/Group.md

@@ -10,7 +10,7 @@
   "admin_ids": "1",
   "notes": "example",
   "user_ids": "1",
-  "usernames": "example",
+  "usernames": "user",
   "ftp_permission": true,
   "sftp_permission": true,
   "dav_permission": true,
@@ -140,7 +140,7 @@ await group.update({
   "admin_ids": "1",
   "notes": "example",
   "user_ids": "1",
-  "usernames": "example",
+  "usernames": "user",
   "ftp_permission": true,
   "sftp_permission": true,
   "dav_permission": true,

package/docs/models/GroupUser.md

@@ -4,7 +4,7 @@
 
 ```
 {
-  "group_name": "example",
+  "group_name": "My Group",
   "group_id": 1,
   "user_id": 1,
   "admin": true,
@@ -82,7 +82,7 @@ await group_user.update({
 
 ```json
 {
-  "group_name": "example",
+  "group_name": "My Group",
   "group_id": 1,
   "user_id": 1,
   "admin": true,

package/docs/models/HistoryExport.md

@@ -5,7 +5,7 @@
 ```
 {
   "id": 1,
-  "history_version": "example",
+  "history_version": "20201213.2",
   "start_at": "2000-01-01T01:00:00Z",
   "end_at": "2000-01-01T01:00:00Z",
   "status": "ready",

package/docs/models/InboxUpload.md

@@ -4,7 +4,22 @@
 
 ```
 {
-  "inbox_registration": "example",
+  "inbox_registration": {
+    "code": "abc123",
+    "name": "account",
+    "company": "Action Verb",
+    "email": "john.doe@files.com",
+    "ip": "10.1.1.1",
+    "clickwrap_body": "example",
+    "form_field_set_id": 1,
+    "form_field_data": {
+      "key": "example value"
+    },
+    "inbox_id": 1,
+    "inbox_recipient_id": 1,
+    "inbox_title": "example",
+    "created_at": "2000-01-01T01:00:00Z"
+  },
   "path": "a/b/test.txt",
   "created_at": "2000-01-01T01:00:00Z"
 }

package/docs/models/Request.md

@@ -8,7 +8,7 @@
   "path": "example",
   "source": "example",
   "destination": "example",
-  "automation_id": "example",
+  "automation_id": 1,
   "user_display_name": "example"
 }
 ```
@@ -17,7 +17,7 @@
 * `path` (string): Folder path. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
 * `source` (string): Source filename, if applicable
 * `destination` (string): Destination filename
-* `automation_id` (string): ID of automation that created request
+* `automation_id` (int64): ID of automation that created request
 * `user_display_name` (string): User making the request (if applicable)
 * `user_ids` (string): A list of user IDs to request the file from. If sent as a string, it should be comma-delimited.
 * `group_ids` (string): A list of group IDs to request the file from. If sent as a string, it should be comma-delimited.

package/docs/models/SftpHostKey.md

@@ -5,9 +5,9 @@
 ```
 {
   "id": 1,
-  "name": "example",
-  "fingerprint_md5": "example",
-  "fingerprint_sha256": "example"
+  "name": "My Key",
+  "fingerprint_md5": "12:7e:f8:61:78:a4:b2:c2:ee:12:51:92:25:a7:42:cc",
+  "fingerprint_sha256": "SHA256:5ANRkDpXWA+PgOquzZAG9RtQ1Bt8KXYAH2hecr7LQk8"
 }
 ```
 
@@ -50,7 +50,7 @@ await SftpHostKey.find(id)
 
 ```
 await SftpHostKey.create({
-  'name': "example",
+  'name': "My Key",
 })
 ```
 
@@ -68,7 +68,7 @@ await SftpHostKey.create({
 const sftp_host_key = await SftpHostKey.find(id)
 
 await sftp_host_key.update({
-  'name': "example",
+  'name': "My Key",
 })
 ```
 
@@ -83,9 +83,9 @@ await sftp_host_key.update({
 ```json
 {
   "id": 1,
-  "name": "example",
-  "fingerprint_md5": "example",
-  "fingerprint_sha256": "example"
+  "name": "My Key",
+  "fingerprint_md5": "12:7e:f8:61:78:a4:b2:c2:ee:12:51:92:25:a7:42:cc",
+  "fingerprint_sha256": "SHA256:5ANRkDpXWA+PgOquzZAG9RtQ1Bt8KXYAH2hecr7LQk8"
 }
 ```
 

package/docs/models/Site.md

@@ -78,9 +78,9 @@
   "domain": "my-custom-domain.com",
   "domain_hsts_header": true,
   "domain_letsencrypt_chain": "example",
-  "email": "example",
+  "email": "john.doe@files.com",
   "ftp_enabled": true,
-  "reply_to_email": "example",
+  "reply_to_email": "jane.doe@files.com",
   "non_sso_groups_allowed": true,
   "non_sso_users_allowed": true,
   "folder_permissions_groups_only": true,
@@ -231,7 +231,7 @@
     "dav_permission": true,
     "disabled": true,
     "disabled_expired_or_inactive": true,
-    "email": "example",
+    "email": "john.doe@files.com",
     "first_login_at": "2000-01-01T01:00:00Z",
     "ftp_permission": true,
     "group_ids": "example",
@@ -500,8 +500,8 @@ await Site.update({
   'domain': "my-custom-domain.com",
   'domain_hsts_header': false,
   'domain_letsencrypt_chain': "example",
-  'email': "example",
-  'reply_to_email': "example",
+  'email': "john.doe@files.com",
+  'reply_to_email': "jane.doe@files.com",
   'allow_bundle_names': false,
   'bundle_expiration': 1,
   'welcome_email_enabled': false,

package/docs/models/Style.md

@@ -7,7 +7,10 @@
   "id": 1,
   "path": "example",
   "logo": "https://mysite.files.com/...",
-  "thumbnail": "example"
+  "thumbnail": {
+    "name": "My logo",
+    "uri": "https://mysite.files.com/.../my_image.png"
+  }
 }
 ```
 
@@ -54,7 +57,10 @@ await style.update({
   "id": 1,
   "path": "example",
   "logo": "https://mysite.files.com/...",
-  "thumbnail": "example"
+  "thumbnail": {
+    "name": "My logo",
+    "uri": "https://mysite.files.com/.../my_image.png"
+  }
 }
 ```
 

package/docs/models/UsageByTopLevelDir.md

@@ -0,0 +1,15 @@
+# UsageByTopLevelDir
+
+## Example UsageByTopLevelDir Object
+
+```
+{
+  "dir": "",
+  "size": 1,
+  "count": 1
+}
+```
+
+* `dir` (string): Directory name
+* `size` (int64): Usage
+* `count` (int64): File count

package/docs/models/UsageDailySnapshot.md

@@ -10,13 +10,17 @@
   "read_api_usage": 1,
   "write_api_usage": 1,
   "user_count": 1,
-  "current_storage": 1,
-  "deleted_files_storage": 1,
-  "deleted_files_counted_in_minimum": 1,
-  "root_storage": 1,
-  "usage_by_top_level_dir": {
-    "key": "example value"
-  }
+  "current_storage": 1.0,
+  "deleted_files_storage": 1.0,
+  "deleted_files_counted_in_minimum": 1.0,
+  "root_storage": 1.0,
+  "usage_by_top_level_dir": [
+    {
+      "dir": "dir",
+      "size": 100,
+      "count": 10
+    }
+  ]
 }
 ```
 
@@ -26,11 +30,11 @@
 * `read_api_usage` (int64): Read API Calls used on this day. Note: only updated for days before the current day.
 * `write_api_usage` (int64): Write API Calls used on this day. Note: only updated for days before the current day.
 * `user_count` (int64): Number of billable users as of this day.
-* `current_storage` (int64): GB of Files Native Storage used on this day.
-* `deleted_files_storage` (int64): GB of Files Native Storage used on this day for files that have been deleted and are stored as backups.
-* `deleted_files_counted_in_minimum` (int64): GB of Files Native Storage used on this day for files that have been permanently deleted but were uploaded less than 30 days ago, and are still billable.
-* `root_storage` (int64): GB of Files Native Storage used for the root folder.  Included here because this value will not be part of `usage_by_top_level_dir`
-* `usage_by_top_level_dir` (object): Usage broken down by each top-level folder
+* `current_storage` (double): GB of Files Native Storage used on this day.
+* `deleted_files_storage` (double): GB of Files Native Storage used on this day for files that have been deleted and are stored as backups.
+* `deleted_files_counted_in_minimum` (double): GB of Files Native Storage used on this day for files that have been permanently deleted but were uploaded less than 30 days ago, and are still billable.
+* `root_storage` (double): GB of Files Native Storage used for the root folder.  Included here because this value will not be part of `usage_by_top_level_dir`
+* `usage_by_top_level_dir` (array(object)): Usage broken down by each top-level folder
 
 ---
 

package/docs/models/UsageSnapshot.md

@@ -7,12 +7,9 @@
   "id": 1,
   "start_at": "2000-01-01T01:00:00Z",
   "end_at": "2000-01-01T01:00:00Z",
-  "high_water_user_count": 1.0,
+  "high_water_user_count": 1,
   "current_storage": 1.0,
   "high_water_storage": 1.0,
-  "usage_by_top_level_dir": {
-    "key": "example value"
-  },
   "root_storage": 1.0,
   "deleted_files_counted_in_minimum": 1.0,
   "deleted_files_storage": 1.0,
@@ -20,17 +17,23 @@
   "total_billable_transfer_usage": 1.0,
   "bytes_sent": 1.0,
   "sync_bytes_received": 1.0,
-  "sync_bytes_sent": 1.0
+  "sync_bytes_sent": 1.0,
+  "usage_by_top_level_dir": [
+    {
+      "dir": "dir",
+      "size": 100,
+      "count": 10
+    }
+  ]
 }
 ```
 
 * `id` (int64): Usage snapshot ID
 * `start_at` (date-time): Usage snapshot start date/time
 * `end_at` (date-time): Usage snapshot end date/time
-* `high_water_user_count` (double): Highest user count number in time period
+* `high_water_user_count` (int64): Highest user count number in time period
 * `current_storage` (double): Current total Storage Usage GB as of end date (not necessarily high water mark, which is used for billing)
 * `high_water_storage` (double): Highest Storage Usage GB recorded in time period (used for billing)
-* `usage_by_top_level_dir` (object): Storage Usage - map of root folders to their usage as of end date (not necessarily high water mark, which is used for billing)
 * `root_storage` (double): Storage Usage for root folder as of end date (not necessarily high water mark, which is used for billing)
 * `deleted_files_counted_in_minimum` (double): Storage Usage for files that are deleted but uploaded within last 30 days as of end date (not necessarily high water mark, which is used for billing)
 * `deleted_files_storage` (double): Storage Usage for files that are deleted but retained as backups as of end date (not necessarily high water mark, which is used for billing)
@@ -39,6 +42,7 @@
 * `bytes_sent` (double): Transfer Usage for period - Outbound GB from Files Native Storage
 * `sync_bytes_received` (double): Transfer Usage for period - Inbound GB to Remote Servers (Sync/Mount)
 * `sync_bytes_sent` (double): Transfer Usage for period - Outbound GB from Remote Servers (Sync/Mount)
+* `usage_by_top_level_dir` (array(object)): Storage Usage - map of root folders to their usage as of end date (not necessarily high water mark, which is used for billing)
 
 ---
 

package/docs/models/User.md

@@ -23,7 +23,7 @@
   "dav_permission": true,
   "disabled": true,
   "disabled_expired_or_inactive": true,
-  "email": "example",
+  "email": "john.doe@files.com",
   "first_login_at": "2000-01-01T01:00:00Z",
   "ftp_permission": true,
   "group_ids": "example",
@@ -198,7 +198,7 @@ await User.find(id)
 ```
 await User.create({
   'avatar_delete': false,
-  'email': "example",
+  'email': "john.doe@files.com",
   'group_id': 1,
   'group_ids': "example",
   'announcements_read': false,
@@ -345,7 +345,7 @@ const user = await User.find(id)
 
 await user.update({
   'avatar_delete': false,
-  'email': "example",
+  'email': "john.doe@files.com",
   'group_id': 1,
   'group_ids': "example",
   'announcements_read': false,
@@ -461,7 +461,7 @@ await user.update({
   "dav_permission": true,
   "disabled": true,
   "disabled_expired_or_inactive": true,
-  "email": "example",
+  "email": "john.doe@files.com",
   "first_login_at": "2000-01-01T01:00:00Z",
   "ftp_permission": true,
   "group_ids": "example",

package/docs/models/UserRequest.md

@@ -6,7 +6,7 @@
 {
   "id": 1,
   "name": "John Doe",
-  "email": "example",
+  "email": "john.doe@files.com",
   "details": "Changed Departments",
   "company": "Acme Inc."
 }

package/lib/Files.js

@@ -11,7 +11,7 @@ var endpointPrefix = '/api/rest/v1';
 var apiKey;
 var baseUrl = 'https://app.files.com';
 var sessionId = null;
-var version = '1.2.221';
+var version = '1.2.223';
 var userAgent = "Files.com JavaScript SDK v".concat(version);
 var logLevel = _Logger.LogLevel.INFO;
 var debugRequest = false;

package/lib/models/Automation.js

@@ -40,7 +40,7 @@ var Automation = /*#__PURE__*/(0, _createClass2.default)(function Automation() {
   (0, _defineProperty2.default)(this, "setId", function (value) {
     _this.attributes.id = value;
   });
-  // boolean # Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.
+  // boolean # Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.  This setting has no effect unless `overwrite_files` is also set to `true`.
   (0, _defineProperty2.default)(this, "getAlwaysOverwriteSizeMatchingFiles", function () {
     return _this.attributes.always_overwrite_size_matching_files;
   });
@@ -159,7 +159,7 @@ var Automation = /*#__PURE__*/(0, _createClass2.default)(function Automation() {
   (0, _defineProperty2.default)(this, "setName", function (value) {
     _this.attributes.name = value;
   });
-  // boolean # If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `:always_overwrite_size_matching_files` option to override this.
+  // boolean # If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `always_overwrite_size_matching_files` option in conjunction with `overwrite_files` to override this behavior and overwrite files no matter what.
   (0, _defineProperty2.default)(this, "getOverwriteFiles", function () {
     return _this.attributes.overwrite_files;
   });
@@ -354,7 +354,7 @@ var Automation = /*#__PURE__*/(0, _createClass2.default)(function Automation() {
   //   schedule_days_of_week - array(int64) - If trigger is `custom_schedule`. A list of days of the week to run this automation. 0 is Sunday, 1 is Monday, etc.
   //   schedule_times_of_day - array(string) - If trigger is `custom_schedule`. A list of times of day to run this automation. 24-hour time format.
   //   schedule_time_zone - string - If trigger is `custom_schedule`. Time zone for the schedule.
-  //   always_overwrite_size_matching_files - boolean - Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.
+  //   always_overwrite_size_matching_files - boolean - Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.  This setting has no effect unless `overwrite_files` is also set to `true`.
   //   description - string - Description for the this Automation.
   //   disabled - boolean - If true, this automation will not run.
   //   exclude_pattern - string - If set, this glob pattern will exclude files from the automation. Supports globs, except on remote mounts.
@@ -363,7 +363,7 @@ var Automation = /*#__PURE__*/(0, _createClass2.default)(function Automation() {
   //   ignore_locked_folders - boolean - If true, the Lock Folders behavior will be disregarded for automated actions.
   //   legacy_folder_matching - boolean - DEPRECATED: If `true`, use the legacy behavior for this automation, where it can operate on folders in addition to just files.  This behavior no longer works and should not be used.
   //   name - string - Name for this automation.
-  //   overwrite_files - boolean - If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `:always_overwrite_size_matching_files` option to override this.
+  //   overwrite_files - boolean - If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `always_overwrite_size_matching_files` option in conjunction with `overwrite_files` to override this behavior and overwrite files no matter what.
   //   path_time_zone - string - Timezone to use when rendering timestamps in paths.
   //   retry_on_failure_interval_in_minutes - int64 - If the Automation fails, retry at this interval (in minutes).  Acceptable values are 5 through 1440 (one day).  Set to null to disable.
   //   retry_on_failure_number_of_attempts - int64 - If the Automation fails, retry at most this many times.  Maximum allowed value: 10.  Set to null to disable.
@@ -771,7 +771,7 @@ _Automation = Automation;
 //   schedule_days_of_week - array(int64) - If trigger is `custom_schedule`. A list of days of the week to run this automation. 0 is Sunday, 1 is Monday, etc.
 //   schedule_times_of_day - array(string) - If trigger is `custom_schedule`. A list of times of day to run this automation. 24-hour time format.
 //   schedule_time_zone - string - If trigger is `custom_schedule`. Time zone for the schedule.
-//   always_overwrite_size_matching_files - boolean - Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.
+//   always_overwrite_size_matching_files - boolean - Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.  This setting has no effect unless `overwrite_files` is also set to `true`.
 //   description - string - Description for the this Automation.
 //   disabled - boolean - If true, this automation will not run.
 //   exclude_pattern - string - If set, this glob pattern will exclude files from the automation. Supports globs, except on remote mounts.
@@ -780,7 +780,7 @@ _Automation = Automation;
 //   ignore_locked_folders - boolean - If true, the Lock Folders behavior will be disregarded for automated actions.
 //   legacy_folder_matching - boolean - DEPRECATED: If `true`, use the legacy behavior for this automation, where it can operate on folders in addition to just files.  This behavior no longer works and should not be used.
 //   name - string - Name for this automation.
-//   overwrite_files - boolean - If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `:always_overwrite_size_matching_files` option to override this.
+//   overwrite_files - boolean - If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `always_overwrite_size_matching_files` option in conjunction with `overwrite_files` to override this behavior and overwrite files no matter what.
 //   path_time_zone - string - Timezone to use when rendering timestamps in paths.
 //   retry_on_failure_interval_in_minutes - int64 - If the Automation fails, retry at this interval (in minutes).  Acceptable values are 5 through 1440 (one day).  Set to null to disable.
 //   retry_on_failure_number_of_attempts - int64 - If the Automation fails, retry at most this many times.  Maximum allowed value: 10.  Set to null to disable.

package/lib/models/AutomationRun.js

@@ -49,7 +49,7 @@ var AutomationRun = /*#__PURE__*/(0, _createClass2.default)(function AutomationR
   (0, _defineProperty2.default)(this, "getCreatedAt", function () {
     return _this.attributes.created_at;
   });
-  // string # If set, this automation will be retried at this date/time due to `failure` or `partial_failure`.
+  // date-time # If set, this automation will be retried at this date/time due to `failure` or `partial_failure`.
   (0, _defineProperty2.default)(this, "getRetryAt", function () {
     return _this.attributes.retry_at;
   });

package/lib/models/Request.js

@@ -61,7 +61,7 @@ var Request = /*#__PURE__*/(0, _createClass2.default)(function Request() {
   (0, _defineProperty2.default)(this, "setDestination", function (value) {
     _this.attributes.destination = value;
   });
-  // string # ID of automation that created request
+  // int64 # ID of automation that created request
   (0, _defineProperty2.default)(this, "getAutomationId", function () {
     return _this.attributes.automation_id;
   });

package/lib/models/UsageByTopLevelDir.js

@@ -0,0 +1,59 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _typeof = require("@babel/runtime/helpers/typeof");
+exports.__esModule = true;
+exports.default = void 0;
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
+var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _Api = _interopRequireDefault(require("../Api"));
+var errors = _interopRequireWildcard(require("../Errors"));
+var _utils = require("../utils");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; } /* eslint-disable no-unused-vars */
+/* eslint-enable no-unused-vars */
+/**
+ * Class UsageByTopLevelDir
+ */
+var UsageByTopLevelDir = /*#__PURE__*/(0, _createClass2.default)(function UsageByTopLevelDir() {
+  var _this = this;
+  var attributes = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  (0, _classCallCheck2.default)(this, UsageByTopLevelDir);
+  (0, _defineProperty2.default)(this, "attributes", {});
+  (0, _defineProperty2.default)(this, "options", {});
+  (0, _defineProperty2.default)(this, "isLoaded", function () {
+    return !!_this.attributes.id;
+  });
+  // string # Directory name
+  (0, _defineProperty2.default)(this, "getDir", function () {
+    return _this.attributes.dir;
+  });
+  // int64 # Usage
+  (0, _defineProperty2.default)(this, "getSize", function () {
+    return _this.attributes.size;
+  });
+  // int64 # File count
+  (0, _defineProperty2.default)(this, "getCount", function () {
+    return _this.attributes.count;
+  });
+  Object.entries(attributes).forEach(function (_ref) {
+    var _ref2 = (0, _slicedToArray2.default)(_ref, 2),
+      key = _ref2[0],
+      value = _ref2[1];
+    var normalizedKey = key.replace('?', '');
+    _this.attributes[normalizedKey] = value;
+    Object.defineProperty(_this, normalizedKey, {
+      value: value,
+      writable: false
+    });
+  });
+  this.options = _objectSpread({}, options);
+});
+var _default = exports.default = UsageByTopLevelDir;
+module.exports = UsageByTopLevelDir;
+module.exports.default = UsageByTopLevelDir;

package/lib/models/UsageDailySnapshot.js

@@ -57,23 +57,23 @@ var UsageDailySnapshot = /*#__PURE__*/(0, _createClass2.default)(function UsageD
   (0, _defineProperty2.default)(this, "getUserCount", function () {
     return _this.attributes.user_count;
   });
-  // int64 # GB of Files Native Storage used on this day.
+  // double # GB of Files Native Storage used on this day.
   (0, _defineProperty2.default)(this, "getCurrentStorage", function () {
     return _this.attributes.current_storage;
   });
-  // int64 # GB of Files Native Storage used on this day for files that have been deleted and are stored as backups.
+  // double # GB of Files Native Storage used on this day for files that have been deleted and are stored as backups.
   (0, _defineProperty2.default)(this, "getDeletedFilesStorage", function () {
     return _this.attributes.deleted_files_storage;
   });
-  // int64 # GB of Files Native Storage used on this day for files that have been permanently deleted but were uploaded less than 30 days ago, and are still billable.
+  // double # GB of Files Native Storage used on this day for files that have been permanently deleted but were uploaded less than 30 days ago, and are still billable.
   (0, _defineProperty2.default)(this, "getDeletedFilesCountedInMinimum", function () {
     return _this.attributes.deleted_files_counted_in_minimum;
   });
-  // int64 # GB of Files Native Storage used for the root folder.  Included here because this value will not be part of `usage_by_top_level_dir`
+  // double # GB of Files Native Storage used for the root folder.  Included here because this value will not be part of `usage_by_top_level_dir`
   (0, _defineProperty2.default)(this, "getRootStorage", function () {
     return _this.attributes.root_storage;
   });
-  // object # Usage broken down by each top-level folder
+  // array(object) # Usage broken down by each top-level folder
   (0, _defineProperty2.default)(this, "getUsageByTopLevelDir", function () {
     return _this.attributes.usage_by_top_level_dir;
   });

package/lib/models/UsageSnapshot.js

@@ -45,7 +45,7 @@ var UsageSnapshot = /*#__PURE__*/(0, _createClass2.default)(function UsageSnapsh
   (0, _defineProperty2.default)(this, "getEndAt", function () {
     return _this.attributes.end_at;
   });
-  // double # Highest user count number in time period
+  // int64 # Highest user count number in time period
   (0, _defineProperty2.default)(this, "getHighWaterUserCount", function () {
     return _this.attributes.high_water_user_count;
   });
@@ -57,10 +57,6 @@ var UsageSnapshot = /*#__PURE__*/(0, _createClass2.default)(function UsageSnapsh
   (0, _defineProperty2.default)(this, "getHighWaterStorage", function () {
     return _this.attributes.high_water_storage;
   });
-  // object # Storage Usage - map of root folders to their usage as of end date (not necessarily high water mark, which is used for billing)
-  (0, _defineProperty2.default)(this, "getUsageByTopLevelDir", function () {
-    return _this.attributes.usage_by_top_level_dir;
-  });
   // double # Storage Usage for root folder as of end date (not necessarily high water mark, which is used for billing)
   (0, _defineProperty2.default)(this, "getRootStorage", function () {
     return _this.attributes.root_storage;
@@ -93,6 +89,10 @@ var UsageSnapshot = /*#__PURE__*/(0, _createClass2.default)(function UsageSnapsh
   (0, _defineProperty2.default)(this, "getSyncBytesSent", function () {
     return _this.attributes.sync_bytes_sent;
   });
+  // array(object) # Storage Usage - map of root folders to their usage as of end date (not necessarily high water mark, which is used for billing)
+  (0, _defineProperty2.default)(this, "getUsageByTopLevelDir", function () {
+    return _this.attributes.usage_by_top_level_dir;
+  });
   Object.entries(attributes).forEach(function (_ref) {
     var _ref2 = (0, _slicedToArray2.default)(_ref, 2),
       key = _ref2[0],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "files.com",
-  "version": "1.2.221",
+  "version": "1.2.223",
   "description": "Files.com SDK for JavaScript",
   "keywords": [
     "files.com",

package/src/Files.js

@@ -5,7 +5,7 @@ const endpointPrefix = '/api/rest/v1'
 let apiKey
 let baseUrl = 'https://app.files.com'
 let sessionId = null
-const version = '1.2.221'
+const version = '1.2.223'
 let userAgent = `Files.com JavaScript SDK v${version}`
 
 let logLevel = LogLevel.INFO

package/src/models/Automation.js

@@ -35,7 +35,7 @@ class Automation {
     this.attributes.id = value
   }
 
-  // boolean # Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.
+  // boolean # Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.  This setting has no effect unless `overwrite_files` is also set to `true`.
   getAlwaysOverwriteSizeMatchingFiles = () => this.attributes.always_overwrite_size_matching_files
 
   setAlwaysOverwriteSizeMatchingFiles = value => {
@@ -154,7 +154,7 @@ class Automation {
     this.attributes.name = value
   }
 
-  // boolean # If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `:always_overwrite_size_matching_files` option to override this.
+  // boolean # If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `always_overwrite_size_matching_files` option in conjunction with `overwrite_files` to override this behavior and overwrite files no matter what.
   getOverwriteFiles = () => this.attributes.overwrite_files
 
   setOverwriteFiles = value => {
@@ -326,7 +326,7 @@ class Automation {
   //   schedule_days_of_week - array(int64) - If trigger is `custom_schedule`. A list of days of the week to run this automation. 0 is Sunday, 1 is Monday, etc.
   //   schedule_times_of_day - array(string) - If trigger is `custom_schedule`. A list of times of day to run this automation. 24-hour time format.
   //   schedule_time_zone - string - If trigger is `custom_schedule`. Time zone for the schedule.
-  //   always_overwrite_size_matching_files - boolean - Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.
+  //   always_overwrite_size_matching_files - boolean - Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.  This setting has no effect unless `overwrite_files` is also set to `true`.
   //   description - string - Description for the this Automation.
   //   disabled - boolean - If true, this automation will not run.
   //   exclude_pattern - string - If set, this glob pattern will exclude files from the automation. Supports globs, except on remote mounts.
@@ -335,7 +335,7 @@ class Automation {
   //   ignore_locked_folders - boolean - If true, the Lock Folders behavior will be disregarded for automated actions.
   //   legacy_folder_matching - boolean - DEPRECATED: If `true`, use the legacy behavior for this automation, where it can operate on folders in addition to just files.  This behavior no longer works and should not be used.
   //   name - string - Name for this automation.
-  //   overwrite_files - boolean - If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `:always_overwrite_size_matching_files` option to override this.
+  //   overwrite_files - boolean - If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `always_overwrite_size_matching_files` option in conjunction with `overwrite_files` to override this behavior and overwrite files no matter what.
   //   path_time_zone - string - Timezone to use when rendering timestamps in paths.
   //   retry_on_failure_interval_in_minutes - int64 - If the Automation fails, retry at this interval (in minutes).  Acceptable values are 5 through 1440 (one day).  Set to null to disable.
   //   retry_on_failure_number_of_attempts - int64 - If the Automation fails, retry at most this many times.  Maximum allowed value: 10.  Set to null to disable.
@@ -567,7 +567,7 @@ class Automation {
   //   schedule_days_of_week - array(int64) - If trigger is `custom_schedule`. A list of days of the week to run this automation. 0 is Sunday, 1 is Monday, etc.
   //   schedule_times_of_day - array(string) - If trigger is `custom_schedule`. A list of times of day to run this automation. 24-hour time format.
   //   schedule_time_zone - string - If trigger is `custom_schedule`. Time zone for the schedule.
-  //   always_overwrite_size_matching_files - boolean - Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.
+  //   always_overwrite_size_matching_files - boolean - Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.  This setting has no effect unless `overwrite_files` is also set to `true`.
   //   description - string - Description for the this Automation.
   //   disabled - boolean - If true, this automation will not run.
   //   exclude_pattern - string - If set, this glob pattern will exclude files from the automation. Supports globs, except on remote mounts.
@@ -576,7 +576,7 @@ class Automation {
   //   ignore_locked_folders - boolean - If true, the Lock Folders behavior will be disregarded for automated actions.
   //   legacy_folder_matching - boolean - DEPRECATED: If `true`, use the legacy behavior for this automation, where it can operate on folders in addition to just files.  This behavior no longer works and should not be used.
   //   name - string - Name for this automation.
-  //   overwrite_files - boolean - If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `:always_overwrite_size_matching_files` option to override this.
+  //   overwrite_files - boolean - If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `always_overwrite_size_matching_files` option in conjunction with `overwrite_files` to override this behavior and overwrite files no matter what.
   //   path_time_zone - string - Timezone to use when rendering timestamps in paths.
   //   retry_on_failure_interval_in_minutes - int64 - If the Automation fails, retry at this interval (in minutes).  Acceptable values are 5 through 1440 (one day).  Set to null to disable.
   //   retry_on_failure_number_of_attempts - int64 - If the Automation fails, retry at most this many times.  Maximum allowed value: 10.  Set to null to disable.

package/src/models/AutomationRun.js

@@ -40,7 +40,7 @@ class AutomationRun {
   // date-time # Automation run start date/time.
   getCreatedAt = () => this.attributes.created_at
 
-  // string # If set, this automation will be retried at this date/time due to `failure` or `partial_failure`.
+  // date-time # If set, this automation will be retried at this date/time due to `failure` or `partial_failure`.
   getRetryAt = () => this.attributes.retry_at
 
   // date-time # If set, this Automation run was retried due to `failure` or `partial_failure`.

package/src/models/Request.js

@@ -56,7 +56,7 @@ class Request {
     this.attributes.destination = value
   }
 
-  // string # ID of automation that created request
+  // int64 # ID of automation that created request
   getAutomationId = () => this.attributes.automation_id
 
   setAutomationId = value => {

package/src/models/UsageByTopLevelDir.js

@@ -0,0 +1,44 @@
+/* eslint-disable no-unused-vars */
+import Api from '../Api'
+import * as errors from '../Errors'
+import {
+  getType, isArray, isInt, isObject, isString,
+} from '../utils'
+/* eslint-enable no-unused-vars */
+
+/**
+ * Class UsageByTopLevelDir
+ */
+class UsageByTopLevelDir {
+  attributes = {}
+
+  options = {}
+
+  constructor(attributes = {}, options = {}) {
+    Object.entries(attributes).forEach(([key, value]) => {
+      const normalizedKey = key.replace('?', '')
+
+      this.attributes[normalizedKey] = value
+
+      Object.defineProperty(this, normalizedKey, { value, writable: false })
+    })
+
+    this.options = { ...options }
+  }
+
+  isLoaded = () => !!this.attributes.id
+
+  // string # Directory name
+  getDir = () => this.attributes.dir
+
+  // int64 # Usage
+  getSize = () => this.attributes.size
+
+  // int64 # File count
+  getCount = () => this.attributes.count
+}
+
+export default UsageByTopLevelDir
+
+module.exports = UsageByTopLevelDir
+module.exports.default = UsageByTopLevelDir

package/src/models/UsageDailySnapshot.js

@@ -46,19 +46,19 @@ class UsageDailySnapshot {
   // int64 # Number of billable users as of this day.
   getUserCount = () => this.attributes.user_count
 
-  // int64 # GB of Files Native Storage used on this day.
+  // double # GB of Files Native Storage used on this day.
   getCurrentStorage = () => this.attributes.current_storage
 
-  // int64 # GB of Files Native Storage used on this day for files that have been deleted and are stored as backups.
+  // double # GB of Files Native Storage used on this day for files that have been deleted and are stored as backups.
   getDeletedFilesStorage = () => this.attributes.deleted_files_storage
 
-  // int64 # GB of Files Native Storage used on this day for files that have been permanently deleted but were uploaded less than 30 days ago, and are still billable.
+  // double # GB of Files Native Storage used on this day for files that have been permanently deleted but were uploaded less than 30 days ago, and are still billable.
   getDeletedFilesCountedInMinimum = () => this.attributes.deleted_files_counted_in_minimum
 
-  // int64 # GB of Files Native Storage used for the root folder.  Included here because this value will not be part of `usage_by_top_level_dir`
+  // double # GB of Files Native Storage used for the root folder.  Included here because this value will not be part of `usage_by_top_level_dir`
   getRootStorage = () => this.attributes.root_storage
 
-  // object # Usage broken down by each top-level folder
+  // array(object) # Usage broken down by each top-level folder
   getUsageByTopLevelDir = () => this.attributes.usage_by_top_level_dir
 
   // Parameters:

package/src/models/UsageSnapshot.js

@@ -37,7 +37,7 @@ class UsageSnapshot {
   // date-time # Usage snapshot end date/time
   getEndAt = () => this.attributes.end_at
 
-  // double # Highest user count number in time period
+  // int64 # Highest user count number in time period
   getHighWaterUserCount = () => this.attributes.high_water_user_count
 
   // double # Current total Storage Usage GB as of end date (not necessarily high water mark, which is used for billing)
@@ -46,9 +46,6 @@ class UsageSnapshot {
   // double # Highest Storage Usage GB recorded in time period (used for billing)
   getHighWaterStorage = () => this.attributes.high_water_storage
 
-  // object # Storage Usage - map of root folders to their usage as of end date (not necessarily high water mark, which is used for billing)
-  getUsageByTopLevelDir = () => this.attributes.usage_by_top_level_dir
-
   // double # Storage Usage for root folder as of end date (not necessarily high water mark, which is used for billing)
   getRootStorage = () => this.attributes.root_storage
 
@@ -73,6 +70,9 @@ class UsageSnapshot {
   // double # Transfer Usage for period - Outbound GB from Remote Servers (Sync/Mount)
   getSyncBytesSent = () => this.attributes.sync_bytes_sent
 
+  // array(object) # Storage Usage - map of root folders to their usage as of end date (not necessarily high water mark, which is used for billing)
+  getUsageByTopLevelDir = () => this.attributes.usage_by_top_level_dir
+
   // 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).