files.com 1.0.124 → 1.0.129

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 92873bcd3bc5aba3dbdddbccbb0773e60e9a591517dcc0e2f7d306444e9ba3fa
-  data.tar.gz: 5d9714166c704bce65ba07c790fed61e0296bce705427ad73f6c4d3dee76cff3
+  metadata.gz: '08efe8dc2b98572f4da5009fcf5978026da9862c5daead1262b1050b3b8dfcae'
+  data.tar.gz: 3355ed5a25ce05f6aef4d9cbbbc36994c4271df7c4926cf3af934615e16b717f
 SHA512:
-  metadata.gz: 2e61dae752728ff89f699fbad98f1aa9a8f70dd8bbe18492c5d60567979cc7ccf3476b27915ea0f6b96820d2b00d77f505186e0ed3ace4847f6d6d51e50faf66
-  data.tar.gz: f4b9cc0cc6b6cb5fd69a8096a65369b8472fce76f371ee7c5398db2ba8ef67bdfefe9183e0241ca9bd6f4c60d1cbcf842f1d7fe51dfbc0ce4f790323f686df23
+  metadata.gz: 66ee153609a3712ae973f6a8c92eb5d18c2a4ffbeaeb4a3d67e9a69c5fff395e3ca288d61d7f2dd66a17b40a934e0ebf0cdbc2395e74ba688c8c3bd355511a0d
+  data.tar.gz: 6aafd77a290862c3b8e374f821858ff101e51e8510ef4ab2ecc8a51dc877b964167ad5903b93a60f770bed84aeb7149fa945656606ed8e03169a9a0fc9a54bd6

data/_VERSION

@@ -1 +1 @@
-1.0.124
+1.0.129

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

@@ -6,22 +6,9 @@
 {
   "id": 1,
   "automation": "create_folder",
-  "source": "",
-  "destination": "",
-  "destination_replace_from": "",
-  "destination_replace_to": "",
+  "trigger": "realtime",
   "interval": "week",
   "next_process_on": "2020-01-01",
-  "path": "",
-  "realtime": true,
-  "user_id": 1,
-  "user_ids": [
-
-  ],
-  "group_ids": [
-
-  ],
-  "trigger": "realtime",
   "schedule": {
     "days_of_week": [
       0,
@@ -33,25 +20,40 @@
       "14:30"
     ],
     "time_zone": "Eastern Time (US & Canada)"
-  }
+  },
+  "source": "",
+  "destination": "",
+  "destination_replace_from": "",
+  "destination_replace_to": "",
+  "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`, `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.
 * `source` (string): Source Path
 * `destination` (string): Destination Path
 * `destination_replace_from` (string): If set, this string in the destination path will be replaced with the value in `destination_replace_to`.
 * `destination_replace_to` (string): If set, this string will replace the value `destination_replace_from` in the destination filename. You can use special patterns here.
-* `interval` (string): 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): Date this automation will next run.
 * `path` (string): Path on which this Automation runs.  Supports globs. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
-* `realtime` (boolean): Does this automation run in real time?  This is a read-only property based on automation type.
 * `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)
-* `trigger` (string): How this automation is triggered to run. One of: `realtime` or `custom_schedule`.
-* `schedule` (object): Custom schedule description for when the automation should be run.
+* `webhook_url` (string): If trigger is `webhook`, this is the URL of the webhook to trigger the Automation.
 
 
 ---
@@ -69,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`.
@@ -102,7 +104,9 @@ Files::Automation.create(
   source: "source", 
   destination: "destination", 
   interval: "year", 
-  schedule: {"days_of_week":[0,1,3],"times_of_day":["7:30","11:30"],"time_zone":"Eastern Time (US & Canada)"}, 
+  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"
 )
 ```
@@ -119,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`.
 
 
 ---
@@ -132,7 +136,9 @@ Files::Automation.update(id,
   source: "source", 
   destination: "destination", 
   interval: "year", 
-  schedule: {"days_of_week":[0,1,3],"times_of_day":["7:30","11:30"],"time_zone":"Eastern Time (US & Canada)"}, 
+  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"
 )
 ```
@@ -150,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`.
 
 
 ---
@@ -178,7 +184,9 @@ automation.update(
   source: "source",
   destination: "destination",
   interval: "year",
-  schedule: {"days_of_week":[0,1,3],"times_of_day":["7:30","11:30"],"time_zone":"Eastern Time (US & Canada)"},
+  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"
 )
 ```
@@ -196,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
@@ -149,7 +179,9 @@ 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.", 
@@ -165,7 +197,9 @@ Files::Bundle.update(id,
 ### Parameters
 
 * `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
@@ -220,7 +254,9 @@ bundle.share(
 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.",
@@ -236,7 +272,9 @@ bundle.update(
 ### Parameters
 
 * `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
+  }
 }
 ```