files.com 1.0.127 → 1.0.128

data/docs/form_field_set.md

@@ -0,0 +1,154 @@
+# FormFieldSet
+
+## Example FormFieldSet Object
+
+```
+{
+  "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` (int64): Form field set id
+* `title` (string): Title to be displayed
+* `form_layout` (int64): Layout of the form
+* `form_fields` (array): Associated form fields
+* `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
+
+
+---
+
+## List Form Field Sets
+
+```
+Files::FormFieldSet.list(
+  user_id: 1, 
+  per_page: 1
+)
+```
+
+### Parameters
+
+* `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).
+
+
+---
+
+## Show Form Field Set
+
+```
+Files::FormFieldSet.find(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Form Field Set ID.
+
+
+---
+
+## Create Form Field Set
+
+```
+Files::FormFieldSet.create(
+  user_id: 1, 
+  title: "Sample Form Title", 
+  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}]
+)
+```
+
+### Parameters
+
+* `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
+* `title` (string): Title to be displayed
+* `form_fields` (array(object)): 
+
+
+---
+
+## Update Form Field Set
+
+```
+Files::FormFieldSet.update(id, 
+  title: "Sample Form Title", 
+  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}]
+)
+```
+
+### Parameters
+
+* `id` (int64): Required - Form Field Set ID.
+* `title` (string): Title to be displayed
+* `form_fields` (array(object)): 
+
+
+---
+
+## Delete Form Field Set
+
+```
+Files::FormFieldSet.delete(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Form Field Set ID.
+
+
+---
+
+## Update Form Field Set
+
+```
+form_field_set = Files::FormFieldSet.list_for(path).first
+
+form_field_set.update(
+  title: "Sample Form Title",
+  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}]
+)
+```
+
+### Parameters
+
+* `id` (int64): Required - Form Field Set ID.
+* `title` (string): Title to be displayed
+* `form_fields` (array(object)): 
+
+
+---
+
+## Delete Form Field Set
+
+```
+form_field_set = Files::FormFieldSet.list_for(path).first
+
+form_field_set.delete
+```
+
+### Parameters
+
+* `id` (int64): Required - Form Field Set ID.

data/docs/group.md

@@ -7,14 +7,14 @@
   "id": 1,
   "name": "owners",
   "admin_ids": [
-
+    1
   ],
   "notes": "",
   "user_ids": [
-
+    1
   ],
   "usernames": [
-
+    "user"
   ]
 }
 ```
@@ -41,7 +41,7 @@ Files::Group.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 `active`, `site_id` or `name`.
+* `sort_by` (object): If set, sort records by the specified field in either 'asc' or 'desc' direction (e.g. sort_by[last_login_at]=desc). Valid fields are `name`.
 * `filter` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `name`.
 * `filter_gt` (object): If set, return records where the specifiied field is greater than the supplied value. Valid fields are `name`.
 * `filter_gteq` (object): If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are `name`.
@@ -70,7 +70,9 @@ Files::Group.find(id)
 
 ```
 Files::Group.create(
-  name: "owners"
+  name: "owners", 
+  user_ids: [1], 
+  admin_ids: [1]
 )
 ```
 
@@ -88,7 +90,9 @@ Files::Group.create(
 
 ```
 Files::Group.update(id, 
-  name: "owners"
+  name: "owners", 
+  user_ids: [1], 
+  admin_ids: [1]
 )
 ```
 
@@ -122,7 +126,9 @@ Files::Group.delete(id)
 group = Files::Group.list_for(path).first
 
 group.update(
-  name: "owners"
+  name: "owners",
+  user_ids: [1],
+  admin_ids: [1]
 )
 ```
 

data/docs/group_user.md

@@ -9,7 +9,7 @@
   "user_id": 1,
   "admin": true,
   "usernames": [
-
+    "user"
   ]
 }
 ```

data/docs/history.md

@@ -142,7 +142,7 @@ Files::History.list(
 * `display` (string): Display format. Leave blank or set to `full` or `parent`.
 * `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`, `path`, `created_at`, `folder` or `user_id`.
+* `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 `path`, `folder`, `user_id` or `created_at`.
 * `filter` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `user_id`, `folder` or `path`.
 * `filter_gt` (object): If set, return records where the specifiied field is greater than the supplied value. Valid fields are `user_id`, `folder` or `path`.
 * `filter_gteq` (object): If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are `user_id`, `folder` or `path`.

data/docs/inbox_registration.md

@@ -0,0 +1,21 @@
+# InboxRegistration
+
+## Example InboxRegistration Object
+
+```
+{
+  "code": "abc123",
+  "name": "account",
+  "company": "Action Verb",
+  "email": "john.doe@files.com",
+  "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
+* `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/inbox_upload.md

@@ -0,0 +1,35 @@
+# InboxUpload
+
+## Example InboxUpload Object
+
+```
+{
+  "inbox_registration": "",
+  "path": "a/b/test.txt",
+  "created_at": "2020-01-01 00:00:00"
+}
+```
+
+* `inbox_registration`: 
+* `path` (string): Upload path This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
+* `created_at` (date-time): Upload date/time
+
+
+---
+
+## List Inbox Uploads
+
+```
+Files::InboxUpload.list(
+  per_page: 1, 
+  inbox_registration_id: 1, 
+  inbox_id: 1
+)
+```
+
+### Parameters
+
+* `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).
+* `inbox_registration_id` (int64): InboxRegistration ID
+* `inbox_id` (int64): Inbox ID

data/docs/invoice.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/ip_address.md

@@ -8,7 +8,7 @@
   "associated_with": "Site",
   "group_id": 1,
   "ip_addresses": [
-
+    "127.0.0.1"
   ]
 }
 ```

data/docs/message.md

@@ -8,7 +8,16 @@
   "subject": "Files.com Account Upgrade",
   "body": "We should upgrade our Files.com account!",
   "comments": [
-
+    {
+      "id": 1,
+      "body": "What a great idea, thank you!",
+      "reactions": [
+        {
+          "id": 1,
+          "emoji": "👍"
+        }
+      ]
+    }
   ]
 }
 ```

data/docs/message_comment.md

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

data/docs/notification.md

@@ -53,7 +53,7 @@ Files::Notification.list(
 * `user_id` (int64): DEPRECATED: Show notifications for this User ID. Use `filter[user_id]` instead.
 * `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`, `path`, `user_id` or `group_id`.
+* `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 `path`, `user_id` or `group_id`.
 * `filter` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `user_id`, `group_id` or `path`.
 * `filter_gt` (object): If set, return records where the specifiied field is greater than the supplied value. Valid fields are `user_id`, `group_id` or `path`.
 * `filter_gteq` (object): If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are `user_id`, `group_id` or `path`.

data/docs/payment.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/permission.md

@@ -42,7 +42,7 @@ Files::Permission.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 `deleted_at`, `group_id`, `path`, `user_id` or `permission`.
+* `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 `group_id`, `path`, `user_id` or `permission`.
 * `filter` (object): If set, return records where the specifiied field is equal to the supplied value. Valid fields are `group_id`, `user_id` or `path`.
 * `filter_gt` (object): If set, return records where the specifiied field is greater than the supplied value. Valid fields are `group_id`, `user_id` or `path`.
 * `filter_gteq` (object): If set, return records where the specifiied field is greater than or equal to the supplied value. Valid fields are `group_id`, `user_id` or `path`.

data/docs/remote_server.md

@@ -107,61 +107,6 @@ Files::RemoteServer.find(id)
 * `id` (int64): Required - Remote Server ID.
 
 
----
-
-## list_for_testing Remote Server
-
-```
-Files::RemoteServer.list_for_testing(
-  remote_server_id: 1, 
-  reset_authentication: true, 
-  max_connections: 1, 
-  port: 1
-)
-```
-
-### Parameters
-
-* `remote_server_id` (int64): RemoteServer ID
-* `root` (string): Remote path to list
-* `aws_access_key` (string): AWS Access Key.
-* `aws_secret_key` (string): AWS secret key.
-* `password` (string): Password if needed.
-* `private_key` (string): Private key if needed.
-* `ssl_certificate` (string): SSL client certificate.
-* `google_cloud_storage_credentials_json` (string): A JSON file that contains the private key. To generate see https://cloud.google.com/storage/docs/json_api/v1/how-tos/authorizing#APIKey
-* `wasabi_access_key` (string): Wasabi access key.
-* `wasabi_secret_key` (string): Wasabi secret key.
-* `backblaze_b2_key_id` (string): Backblaze B2 Cloud Storage keyID.
-* `backblaze_b2_application_key` (string): Backblaze B2 Cloud Storage applicationKey.
-* `rackspace_api_key` (string): Rackspace API key from the Rackspace Cloud Control Panel.
-* `reset_authentication` (boolean): Reset authenticated account
-* `azure_blob_storage_access_key` (string): Azure Blob Storage secret key.
-* `hostname` (string): 
-* `name` (string): 
-* `max_connections` (int64): 
-* `port` (int64): 
-* `s3_bucket` (string): 
-* `s3_region` (string): 
-* `server_certificate` (string): 
-* `server_host_key` (string): 
-* `server_type` (string): 
-* `ssl` (string): 
-* `username` (string): 
-* `google_cloud_storage_bucket` (string): 
-* `google_cloud_storage_project_id` (string): 
-* `backblaze_b2_bucket` (string): 
-* `backblaze_b2_s3_endpoint` (string): 
-* `wasabi_bucket` (string): 
-* `wasabi_region` (string): 
-* `rackspace_username` (string): 
-* `rackspace_region` (string): 
-* `rackspace_container` (string): 
-* `one_drive_account_type` (string): 
-* `azure_blob_storage_account` (string): 
-* `azure_blob_storage_container` (string): 
-
-
 ---
 
 ## Create Remote Server