files.com 1.0.126 → 1.0.131

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 203e10058f232c82f9aab4122aa5d99e0d984cef6ddce45503703cf35dc3ad72
-  data.tar.gz: 8f84839cd7256c532669e0a2500fb5c7429b754822cab4675113919fdce1cabf
+  metadata.gz: c78e42a73b1edeedd2f0d6a6d6ab6dc992fb333753ac0fac4b8142a8a868b0b6
+  data.tar.gz: 01db679c43f088e2a0849be0a41dd5d87e3a989cf79ddd74c2ed338944bf2146
 SHA512:
-  metadata.gz: 5a3a384c546820836c47b8a58955a08d6c8b7e55a24b39ab083d76deada2c36e4929809dc3783cdac88bec003c77ae757d2c852bc60c6d9f445a617b7459b49d
-  data.tar.gz: 51392695363317328c9416d161412e8dd92eafbd2e149bcdba5eb28ef679a63916bd9c24a520831c2485af7026259a8ddec1fc8ed34fe1375145408a71618976
+  metadata.gz: 325da6833b447354df61e539e1b30f5e23374b266cd8fbe3b1ee70b16d76ab9df77604b5c1f57de602b1ae14784cd23636cc5aff7c37bfdbc1a0904b51a09df0
+  data.tar.gz: a956a0e77ed9e61fc1c42dac1d76286fcde0df6b61fc0efd56d0a80df0dce738ca0e9b7739f579662c15d8bd32f44fb6e42b1f1afbb72dd423eb805ce662d3e6

data/_VERSION

@@ -1 +1 @@
-1.0.126
+1.0.131

data/docs/account_line_item.md

@@ -11,11 +11,27 @@
   "currency": "USD",
   "download_uri": "https://url...",
   "invoice_line_items": [
-
+    {
+      "amount": 1.0,
+      "created_at": "2000-01-01T01:00:00Z",
+      "description": "Service from 2019-01-01 through 2019-12-31",
+      "type": "invoice",
+      "service_end_at": "2000-01-01T01:00:00Z",
+      "service_start_at": "2000-01-01T01:00:00Z",
+      "updated_at": "2000-01-01T01:00:00Z",
+      "plan": "Enterprise",
+      "site": "My site"
+    }
   ],
   "method": "paypal",
   "payment_line_items": [
-
+    {
+      "amount": 1.0,
+      "created_at": "2000-01-01T01:00:00Z",
+      "invoice_id": 1,
+      "payment_id": 1,
+      "updated_at": "2000-01-01T01:00:00Z"
+    }
   ],
   "payment_reversed_at": "2000-01-01T01:00:00Z",
   "payment_type": "",

data/docs/api_key.md

@@ -47,7 +47,7 @@ Files::ApiKey.list(
 * `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
 * `cursor` (string): Used for pagination.  Send a cursor value 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.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
-* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `deleted_at` and `expires_at`.
+* `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 `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`.

data/docs/app.md

@@ -9,7 +9,9 @@
   "documentation_links": "Important Info => http://files.test/learn-more",
   "icon_url": "",
   "logo_url": "",
-  "screenshot_list_urls": "",
+  "screenshot_list_urls": [
+    ""
+  ],
   "logo_thumbnail_url": "",
   "sso_strategy_type": "",
   "remote_server_type": "",

data/docs/automation.md

@@ -28,17 +28,20 @@
   "path": "",
   "user_id": 1,
   "user_ids": [
-
+    1,
+    2
   ],
   "group_ids": [
-
-  ]
+    1,
+    2
+  ],
+  "webhook_url": "https://app.files.com/api/webhooks/abc123"
 }
 ```
 
 * `id` (int64): Automation ID
 * `automation` (string): Automation type
-* `trigger` (string): How this automation is triggered to run. One of: `realtime` or `custom_schedule`.
+* `trigger` (string): How this automation is triggered to run. One of: `realtime`, `daily`, `custom_schedule`, `webhook`, or `email`.
 * `interval` (string): If trigger is `daily`, this specifies how often to run this automation.  One of: `day`, `week`, `week_end`, `month`, `month_end`, `quarter`, `quarter_end`, `year`, `year_end`
 * `next_process_on` (string): If trigger is `daily`, date this automation will next run.
 * `schedule` (object): If trigger is `custom_schedule`, Custom schedule description for when the automation should be run.
@@ -50,6 +53,7 @@
 * `user_id` (int64): User ID of the Automation's creator.
 * `user_ids` (array): IDs of Users for the Automation (i.e. who to Request File from)
 * `group_ids` (array): IDs of Groups for the Automation (i.e. who to Request File from)
+* `webhook_url` (string): If trigger is `webhook`, this is the URL of the webhook to trigger the Automation.
 
 
 ---
@@ -67,7 +71,7 @@ Files::Automation.list(
 
 * `cursor` (string): Used for pagination.  Send a cursor value 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.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
-* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `site_id` and `automation`.
+* `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 `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`.
@@ -100,6 +104,8 @@ Files::Automation.create(
   source: "source", 
   destination: "destination", 
   interval: "year", 
+  user_ids: [1,2], 
+  group_ids: [1,2], 
   schedule: "{\"days_of_week\": [ 0, 1, 3 ], \"times_of_day\": [ \"7:30\", \"11:30\" ], \"time_zone\": \"Eastern Time (US & Canada)\"}", 
   trigger: "realtime"
 )
@@ -117,7 +123,7 @@ Files::Automation.create(
 * `user_ids` (string): A list of user IDs the automation is associated with. If sent as a string, it should be comma-delimited.
 * `group_ids` (string): A list of group IDs the automation is associated with. If sent as a string, it should be comma-delimited.
 * `schedule` (object): Custom schedule for running this automation.
-* `trigger` (string): How this automation is triggered to run. One of: `realtime` or `custom_schedule`.
+* `trigger` (string): How this automation is triggered to run. One of: `realtime`, `daily`, `custom_schedule`, `webhook`, or `email`.
 
 
 ---
@@ -130,6 +136,8 @@ Files::Automation.update(id,
   source: "source", 
   destination: "destination", 
   interval: "year", 
+  user_ids: [1,2], 
+  group_ids: [1,2], 
   schedule: "{\"days_of_week\": [ 0, 1, 3 ], \"times_of_day\": [ \"7:30\", \"11:30\" ], \"time_zone\": \"Eastern Time (US & Canada)\"}", 
   trigger: "realtime"
 )
@@ -148,7 +156,7 @@ Files::Automation.update(id,
 * `user_ids` (string): A list of user IDs the automation is associated with. If sent as a string, it should be comma-delimited.
 * `group_ids` (string): A list of group IDs the automation is associated with. If sent as a string, it should be comma-delimited.
 * `schedule` (object): Custom schedule for running this automation.
-* `trigger` (string): How this automation is triggered to run. One of: `realtime` or `custom_schedule`.
+* `trigger` (string): How this automation is triggered to run. One of: `realtime`, `daily`, `custom_schedule`, `webhook`, or `email`.
 
 
 ---
@@ -176,6 +184,8 @@ automation.update(
   source: "source",
   destination: "destination",
   interval: "year",
+  user_ids: [1,2],
+  group_ids: [1,2],
   schedule: "{\"days_of_week\": [ 0, 1, 3 ], \"times_of_day\": [ \"7:30\", \"11:30\" ], \"time_zone\": \"Eastern Time (US & Canada)\"}",
   trigger: "realtime"
 )
@@ -194,7 +204,7 @@ automation.update(
 * `user_ids` (string): A list of user IDs the automation is associated with. If sent as a string, it should be comma-delimited.
 * `group_ids` (string): A list of group IDs the automation is associated with. If sent as a string, it should be comma-delimited.
 * `schedule` (object): Custom schedule for running this automation.
-* `trigger` (string): How this automation is triggered to run. One of: `realtime` or `custom_schedule`.
+* `trigger` (string): How this automation is triggered to run. One of: `realtime`, `daily`, `custom_schedule`, `webhook`, or `email`.
 
 
 ---

data/docs/bandwidth_snapshot.md

@@ -7,6 +7,8 @@
   "id": 1,
   "bytes_received": 1.0,
   "bytes_sent": 1.0,
+  "sync_bytes_received": 1.0,
+  "sync_bytes_sent": 1.0,
   "requests_get": 1.0,
   "requests_put": 1.0,
   "requests_other": 1.0,
@@ -19,6 +21,8 @@
 * `id` (int64): Site bandwidth ID
 * `bytes_received` (double): Site bandwidth report bytes received
 * `bytes_sent` (double): Site bandwidth report bytes sent
+* `sync_bytes_received` (double): Site sync bandwidth report bytes received
+* `sync_bytes_sent` (double): Site sync bandwidth report bytes sent
 * `requests_get` (double): Site bandwidth report get requests
 * `requests_put` (double): Site bandwidth report put requests
 * `requests_other` (double): Site bandwidth report other requests
@@ -41,7 +45,7 @@ Files::BandwidthSnapshot.list(
 
 * `cursor` (string): Used for pagination.  Send a cursor value 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.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
-* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `site_id` and `logged_at`.
+* `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 `logged_at`.
 * `filter` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `logged_at`.
 * `filter_gt` (object): If set, return records where the specifiied field is greater than the supplied value. Valid fields are `logged_at`.
 * `filter_gteq` (object): If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are `logged_at`.

data/docs/behavior.md

@@ -37,7 +37,7 @@ Files::Behavior.list(
 
 * `cursor` (string): Used for pagination.  Send a cursor value 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.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
-* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `site_id` and `behavior`.
+* `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 `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`.
@@ -75,7 +75,7 @@ Files::Behavior.list_for(path,
 
 * `cursor` (string): Used for pagination.  Send a cursor value 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.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
-* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `site_id` and `behavior`.
+* `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 `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`.

data/docs/bundle.md

@@ -11,6 +11,32 @@
   "require_registration": true,
   "require_share_recipient": true,
   "clickwrap_body": "[Legal text]",
+  "form_field_set": {
+    "id": 1,
+    "title": "Sample Form Title",
+    "form_layout": [
+      1,
+      2,
+      3,
+      4
+    ],
+    "form_fields": [
+      {
+        "id": 1,
+        "label": "Sample Label",
+        "required": true,
+        "help_text": "Help Text",
+        "field_type": "text",
+        "options_for_select": [
+          "red",
+          "green",
+          "blue"
+        ],
+        "default_option": "red",
+        "form_field_set_id": 1
+      }
+    ]
+  },
   "id": 1,
   "created_at": "2000-01-01T01:00:00Z",
   "expires_at": "2000-01-01T01:00:00Z",
@@ -22,7 +48,7 @@
   "inbox_id": 1,
   "has_inbox": true,
   "paths": [
-
+    "file.txt"
   ]
 }
 ```
@@ -34,6 +60,7 @@
 * `require_registration` (boolean): Show a registration page that captures the downloader's name and email address?
 * `require_share_recipient` (boolean): Only allow access to recipients who have explicitly received the share via an email sent through the Files.com UI?
 * `clickwrap_body` (string): Legal text that must be agreed to prior to accessing Bundle.
+* `form_field_set`: Custom Form to use
 * `id` (int64): Bundle ID
 * `created_at` (date-time): Bundle created at date/time
 * `expires_at` (date-time): Bundle expiration date/time
@@ -46,6 +73,7 @@
 * `has_inbox` (boolean): Does this bundle have an associated inbox?
 * `paths` (array): A list of paths in this bundle
 * `password` (string): Password for this bundle.
+* `form_field_set_id` (int64): Id of Form Field Set to use with this bundle
 
 
 ---
@@ -64,7 +92,7 @@ Files::Bundle.list(
 * `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
 * `cursor` (string): Used for pagination.  Send a cursor value 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.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
-* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `site_id`, `created_at` or `code`.
+* `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 `created_at` and `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`.
@@ -95,6 +123,7 @@ Files::Bundle.create(
   user_id: 1, 
   paths: ["file.txt"], 
   password: "Password", 
+  form_field_set_id: 1, 
   expires_at: "2000-01-01T01:00:00Z", 
   max_uses: 1, 
   description: "The public description of the bundle.", 
@@ -112,6 +141,7 @@ Files::Bundle.create(
 * `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
 * `paths` (array(string)): Required - A list of paths to include in this bundle.
 * `password` (string): Password for this bundle.
+* `form_field_set_id` (int64): Id of Form Field Set to use with this bundle
 * `expires_at` (string): Bundle expiration date/time
 * `max_uses` (int64): Maximum number of times bundle can be accessed
 * `description` (string): Public description
@@ -151,6 +181,7 @@ Files::Bundle.share(id,
 Files::Bundle.update(id, 
   paths: ["file.txt"], 
   password: "Password", 
+  form_field_set_id: 1, 
   clickwrap_id: 1, 
   code: "abc123", 
   description: "The public description of the bundle.", 
@@ -168,6 +199,7 @@ Files::Bundle.update(id,
 * `id` (int64): Required - Bundle ID.
 * `paths` (array(string)): A list of paths to include in this bundle.
 * `password` (string): Password for this bundle.
+* `form_field_set_id` (int64): Id of Form Field Set to use with this bundle
 * `clickwrap_id` (int64): ID of the clickwrap to use with this bundle.
 * `code` (string): Bundle code.  This code forms the end part of the Public URL.
 * `description` (string): Public description
@@ -224,6 +256,7 @@ bundle = Files::Bundle.list_for(path).first
 bundle.update(
   paths: ["file.txt"],
   password: "Password",
+  form_field_set_id: 1,
   clickwrap_id: 1,
   code: "abc123",
   description: "The public description of the bundle.",
@@ -241,6 +274,7 @@ bundle.update(
 * `id` (int64): Required - Bundle ID.
 * `paths` (array(string)): A list of paths to include in this bundle.
 * `password` (string): Password for this bundle.
+* `form_field_set_id` (int64): Id of Form Field Set to use with this bundle
 * `clickwrap_id` (int64): ID of the clickwrap to use with this bundle.
 * `code` (string): Bundle code.  This code forms the end part of the Public URL.
 * `description` (string): Public description

data/docs/bundle_download.md

@@ -4,12 +4,14 @@
 
 ```
 {
+  "bundle_registration": "",
   "download_method": "file",
   "path": "a/b/test.txt",
   "created_at": "2020-01-01 00:00:00"
 }
 ```
 
+* `bundle_registration`: 
 * `download_method` (string): Download method (file or full_zip)
 * `path` (string): Download path This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
 * `created_at` (date-time): Download date/time
@@ -22,6 +24,7 @@
 ```
 Files::BundleDownload.list(
   per_page: 1, 
+  bundle_id: 1, 
   bundle_registration_id: 1
 )
 ```
@@ -30,4 +33,5 @@ Files::BundleDownload.list(
 
 * `cursor` (string): Used for pagination.  Send a cursor value 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.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
-* `bundle_registration_id` (int64): Required - BundleRegistration ID
+* `bundle_id` (int64): Bundle ID
+* `bundle_registration_id` (int64): BundleRegistration ID

data/docs/bundle_recipient.md

@@ -36,4 +36,11 @@ Files::BundleRecipient.list(
 * `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
 * `cursor` (string): Used for pagination.  Send a cursor value 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.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
+* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `has_registrations`.
+* `filter` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `has_registrations`.
+* `filter_gt` (object): If set, return records where the specifiied field is greater than the supplied value. Valid fields are `has_registrations`.
+* `filter_gteq` (object): If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are `has_registrations`.
+* `filter_like` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `has_registrations`.
+* `filter_lt` (object): If set, return records where the specifiied field is less than the supplied value. Valid fields are `has_registrations`.
+* `filter_lteq` (object): If set, return records where the specifiied field is less than or equal to the supplied value. Valid fields are `has_registrations`.
 * `bundle_id` (int64): Required - List recipients for the bundle with this ID.

data/docs/bundle_registration.md

@@ -0,0 +1,23 @@
+# BundleRegistration
+
+## Example BundleRegistration Object
+
+```
+{
+  "code": "abc123",
+  "name": "account",
+  "company": "Action Verb",
+  "email": "john.doe@files.com",
+  "inbox_code": "abc123",
+  "form_field_set_id": 1,
+  "form_field_data": ""
+}
+```
+
+* `code` (string): Registration cookie code
+* `name` (string): Registrant name
+* `company` (string): Registrant company name
+* `email` (string): Registrant email address
+* `inbox_code` (string): InboxRegistration cookie code, if there is an associated InboxRegistration
+* `form_field_set_id` (int64): Id of associated form field set
+* `form_field_data` (string): Data for form field set with form field ids as keys and user data as values

data/docs/external_event.md

@@ -31,7 +31,7 @@ Files::ExternalEvent.list(
 
 * `cursor` (string): Used for pagination.  Send a cursor value 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.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
-* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `remote_server_type`, `site_id`, `event_type`, `created_at` or `status`.
+* `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 `remote_server_type`, `event_type`, `created_at` or `status`.
 * `filter` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `created_at`, `event_type`, `remote_server_type` or `status`.
 * `filter_gt` (object): If set, return records where the specifiied field is greater than the supplied value. Valid fields are `created_at`, `event_type`, `remote_server_type` or `status`.
 * `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`, `event_type`, `remote_server_type` or `status`.

data/docs/file.md

@@ -22,7 +22,13 @@ may places where a Ruby File object can be used.
   "download_uri": "https://mysite.files.com/...",
   "priority_color": "red",
   "preview_id": 1,
-  "preview": ""
+  "preview": {
+    "id": 1,
+    "status": "complete",
+    "download_uri": "https://mysite.files.com/...",
+    "type": "complete",
+    "size": 1024
+  }
 }
 ```
 

data/docs/file_action.md

@@ -1,3 +1,16 @@
+# FileAction
+
+## Example FileAction Object
+
+```
+{
+  "status": "enqueued",
+  "file_migration_id": "123"
+}
+```
+
+* `status` (string): Status of file operation. Possible values: completed, enqueued.
+* `file_migration_id` (int64): If status is enqueued, this is the id of the FileMigration to check for status updates.
 
 
 ---

data/docs/file_comment.md

@@ -7,7 +7,10 @@
   "id": 1,
   "body": "What a great file!",
   "reactions": [
-
+    {
+      "id": 1,
+      "emoji": "👍"
+    }
   ]
 }
 ```

data/docs/folder.md

@@ -24,7 +24,13 @@ Files::Dir is an alias of Files::Folder
   "download_uri": "https://mysite.files.com/...",
   "priority_color": "red",
   "preview_id": 1,
-  "preview": ""
+  "preview": {
+    "id": 1,
+    "status": "complete",
+    "download_uri": "https://mysite.files.com/...",
+    "type": "complete",
+    "size": 1024
+  }
 }
 ```
 
@@ -64,7 +70,7 @@ Files::Folder.list_for(path,
 * `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 header.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
 * `path` (string): Required - Path to operate on.
-* `filter` (string): If specified, will to filter folders/files list by this string.  Wildcards of `*` and `?` are acceptable here.
+* `filter` (string): If specified, will filter folders/files list by this string.  Wildcards of `*` and `?` are acceptable here.
 * `preview_size` (string): Request a preview size.  Can be `small` (default), `large`, `xlarge`, or `pdf`.
 * `search` (string): If `search_all` is `true`, provide the search string here.  Otherwise, this parameter acts like an alias of `filter`.
 * `search_all` (boolean): Search entire site?