files.com 1.1.673 → 1.1.675

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2c0f447b5e7b8543176cf0015a4faeb255fa1dcbcbc851c99c315ae8790ec10c
-  data.tar.gz: 84cbfcdb04f041ee2f8066c5ae5ce20f0976cfd50ef025541a0601d083b87dac
+  metadata.gz: 61bae143d47da4121c87b0a26109d6ca0d747ba679eb22a941a02dc6b776efb0
+  data.tar.gz: bf235a9b659b1552ade1f53f776853836f4e0760a4f0eee71c828de012fa92a1
 SHA512:
-  metadata.gz: a13395a04d8e6610d4270134ef6dfd441f60e4649f276781593b41048b61b3ebd6fda4f1ca7cca53be0f03851ffcc70c1b40ff5b3139cb546a56baca2b22a002
-  data.tar.gz: 000737fb292996b739973ede951603d43b19548f80c4bbca286c8ee12f2730341c298f3532624c3f782f33e683000748178ba31dd8239f215ce025eb65033de6
+  metadata.gz: 72e0b58348864db656c3426cee0f5150147ddb51bca9f60b852695f646dafd7776e1290374960e37debb66d034763fea10efebf236e2299ec9a666b6813e4879
+  data.tar.gz: 58a619c509ed8698b00142e7a6e53dec4f2c10f893f0138d99a962790c0e9912f7df765725879c60fbb16b21e05e5d8358d3312d872a5b070b4dfd3281bc0782

data/_VERSION

@@ -1 +1 @@
-1.1.673
+1.1.675

data/docs/behavior.md

@@ -13,6 +13,7 @@
   "value": {
     "method": "GET"
   },
+  "public_hosting_url": "example",
   "disable_parent_folder_behavior": true,
   "recursive": true
 }
@@ -25,6 +26,7 @@
 * `name` (string): Name for this behavior.
 * `description` (string): Description for this behavior.
 * `value` (object): Settings for this behavior.  See the section above for an example value to provide here.  Formatting is different for each Behavior type.  May be sent as nested JSON or a single JSON-encoded string.  If using XML encoding for the API call, this data must be sent as a JSON-encoded string.
+* `public_hosting_url` (string): Public URL for this publicly hosted folder when the `Serve Publicly` behavior has a key configured.  When a Custom Domain with `public_hosting` destination is attached to this behavior, the URL uses that domain.  Otherwise it uses the site's `subdomain.hosted-by-files.com` host.
 * `disable_parent_folder_behavior` (boolean): If true, the parent folder's behavior will be disabled for this folder and its children.
 * `recursive` (boolean): Whether this behavior is recursive for this record. `always` behaviors are always `true`, `never` behaviors are always `false`, and `sometimes` behaviors may be either value.
 * `attachment_file` (file): Certain behaviors may require a file, for instance, the `watermark` behavior requires a watermark image. Attach that file here.

data/docs/custom_domain.md

@@ -18,11 +18,11 @@
 
 * `id` (int64): Custom Domain ID.
 * `domain` (string): Customer-owned domain name.
-* `destination` (string): Where this custom domain routes. Can be `site_alias`, `public_hosting`, or `s3_endpoint`.
+* `destination` (string): Where this custom domain routes. Can be `site_alias`, `public_hosting`, `s3_endpoint`, or `unassigned` (not routing traffic). Set to `unassigned` automatically when a bound `public_hosting` folder behavior is deleted, and can be set manually via the API for any reason.
 * `dns_status` (string): Current DNS verification status.
 * `ssl_certificate_id` (int64): Current SSL certificate ID.
 * `brick_managed` (boolean): Is this domain's SSL certificate automatically managed and renewed by Files.com?
-* `folder_behavior_id` (int64): Public Hosting behavior ID when this domain routes to a specific Public Hosting behavior.
+* `folder_behavior_id` (int64): Public Hosting behavior ID when this domain routes to a specific Public Hosting behavior.  Preserved as historical context when `destination` becomes `unassigned`.
 * `created_at` (date-time): When this Custom Domain was created.
 * `updated_at` (date-time): When this Custom Domain was last updated.
 
@@ -70,8 +70,8 @@ Files::CustomDomain.create(
 
 ### Parameters
 
-* `destination` (string): Where this custom domain routes. Can be `site_alias`, `public_hosting`, or `s3_endpoint`.
-* `folder_behavior_id` (int64): Public Hosting behavior ID when this domain routes to a specific Public Hosting behavior.
+* `destination` (string): Where this custom domain routes. Can be `site_alias`, `public_hosting`, `s3_endpoint`, or `unassigned` (not routing traffic). Set to `unassigned` automatically when a bound `public_hosting` folder behavior is deleted, and can be set manually via the API for any reason.
+* `folder_behavior_id` (int64): Public Hosting behavior ID when this domain routes to a specific Public Hosting behavior.  Preserved as historical context when `destination` becomes `unassigned`.
 * `ssl_certificate_id` (int64): Current SSL certificate ID.
 * `domain` (string): Required - Customer-owned domain name.
 
@@ -92,8 +92,8 @@ Files::CustomDomain.update(id,
 ### Parameters
 
 * `id` (int64): Required - Custom Domain ID.
-* `destination` (string): Where this custom domain routes. Can be `site_alias`, `public_hosting`, or `s3_endpoint`.
-* `folder_behavior_id` (int64): Public Hosting behavior ID when this domain routes to a specific Public Hosting behavior.
+* `destination` (string): Where this custom domain routes. Can be `site_alias`, `public_hosting`, `s3_endpoint`, or `unassigned` (not routing traffic). Set to `unassigned` automatically when a bound `public_hosting` folder behavior is deleted, and can be set manually via the API for any reason.
+* `folder_behavior_id` (int64): Public Hosting behavior ID when this domain routes to a specific Public Hosting behavior.  Preserved as historical context when `destination` becomes `unassigned`.
 * `ssl_certificate_id` (int64): Current SSL certificate ID.
 * `domain` (string): Customer-owned domain name.
 
@@ -129,8 +129,8 @@ custom_domain.update(
 ### Parameters
 
 * `id` (int64): Required - Custom Domain ID.
-* `destination` (string): Where this custom domain routes. Can be `site_alias`, `public_hosting`, or `s3_endpoint`.
-* `folder_behavior_id` (int64): Public Hosting behavior ID when this domain routes to a specific Public Hosting behavior.
+* `destination` (string): Where this custom domain routes. Can be `site_alias`, `public_hosting`, `s3_endpoint`, or `unassigned` (not routing traffic). Set to `unassigned` automatically when a bound `public_hosting` folder behavior is deleted, and can be set manually via the API for any reason.
+* `folder_behavior_id` (int64): Public Hosting behavior ID when this domain routes to a specific Public Hosting behavior.  Preserved as historical context when `destination` becomes `unassigned`.
 * `ssl_certificate_id` (int64): Current SSL certificate ID.
 * `domain` (string): Customer-owned domain name.
 

data/docs/partner.md

@@ -20,6 +20,7 @@
     2,
     3
   ],
+  "partner_channel_template_id": 1,
   "partnership_role": "host",
   "responsible_group_id": 1,
   "responsible_user_id": 1,
@@ -45,6 +46,7 @@
 * `name` (string): The name of the Partner.
 * `notes` (string): Notes about this Partner.
 * `partner_admin_ids` (array(int64)): Array of User IDs that are Partner Admins for this Partner.
+* `partner_channel_template_id` (int64): ID of the Partner Channel Template assigned to this Partner.
 * `partnership_role` (string): This site's role in Partner Site relationships for this Partner. Can be `host`, `guest`, `host_and_guest`, or null.
 * `responsible_group_id` (int64): ID of the Group responsible for this Partner.
 * `responsible_user_id` (int64): ID of the User responsible for this Partner.
@@ -96,6 +98,7 @@ Files::Partner.create(
   allow_user_creation: false, 
   cc_emails_to_responsible_party: false, 
   notes: "This is a note about the partner.", 
+  partner_channel_template_id: 1, 
   responsible_group_id: 1, 
   responsible_user_id: 1, 
   tags: "example", 
@@ -115,6 +118,7 @@ Files::Partner.create(
 * `allow_user_creation` (boolean): Allow Partner Admins to create users.
 * `cc_emails_to_responsible_party` (boolean): When `true`, emails sent to Partner users are copied to the responsible User or Group.
 * `notes` (string): Notes about this Partner.
+* `partner_channel_template_id` (int64): ID of the Partner Channel Template assigned to this Partner.
 * `responsible_group_id` (int64): ID of the Group responsible for this Partner.
 * `responsible_user_id` (int64): ID of the User responsible for this Partner.
 * `tags` (string): Comma-separated list of Tags for this Partner. Tags are used for other features, such as UserLifecycleRules, which can target specific tags.  Tags must only contain lowercase letters, numbers, and hyphens.
@@ -137,6 +141,7 @@ Files::Partner.update(id,
   allow_user_creation: false, 
   cc_emails_to_responsible_party: false, 
   notes: "This is a note about the partner.", 
+  partner_channel_template_id: 1, 
   responsible_group_id: 1, 
   responsible_user_id: 1, 
   tags: "example", 
@@ -156,6 +161,7 @@ Files::Partner.update(id,
 * `allow_user_creation` (boolean): Allow Partner Admins to create users.
 * `cc_emails_to_responsible_party` (boolean): When `true`, emails sent to Partner users are copied to the responsible User or Group.
 * `notes` (string): Notes about this Partner.
+* `partner_channel_template_id` (int64): ID of the Partner Channel Template assigned to this Partner.
 * `responsible_group_id` (int64): ID of the Group responsible for this Partner.
 * `responsible_user_id` (int64): ID of the User responsible for this Partner.
 * `tags` (string): Comma-separated list of Tags for this Partner. Tags are used for other features, such as UserLifecycleRules, which can target specific tags.  Tags must only contain lowercase letters, numbers, and hyphens.
@@ -192,6 +198,7 @@ partner.update(
   allow_user_creation: false,
   cc_emails_to_responsible_party: false,
   notes: "This is a note about the partner.",
+  partner_channel_template_id: 1,
   responsible_group_id: 1,
   responsible_user_id: 1,
   tags: "example",
@@ -211,6 +218,7 @@ partner.update(
 * `allow_user_creation` (boolean): Allow Partner Admins to create users.
 * `cc_emails_to_responsible_party` (boolean): When `true`, emails sent to Partner users are copied to the responsible User or Group.
 * `notes` (string): Notes about this Partner.
+* `partner_channel_template_id` (int64): ID of the Partner Channel Template assigned to this Partner.
 * `responsible_group_id` (int64): ID of the Group responsible for this Partner.
 * `responsible_user_id` (int64): ID of the User responsible for this Partner.
 * `tags` (string): Comma-separated list of Tags for this Partner. Tags are used for other features, such as UserLifecycleRules, which can target specific tags.  Tags must only contain lowercase letters, numbers, and hyphens.

data/docs/partner_channel.md

@@ -7,11 +7,18 @@
   "id": 1,
   "workspace_id": 1,
   "partner_id": 1,
+  "partner_channel_template_id": 1,
   "path": "claims/medical",
   "to_partner_folder_name": "outgoing",
   "from_partner_folder_name": "incoming",
   "from_partner_route_path": "processing/from-partner",
   "to_partner_route_path": "delivery/to-partner",
+  "to_partner_managed_folder_paths": [
+    "reports/monthly"
+  ],
+  "from_partner_managed_folder_paths": [
+    "claims/received"
+  ],
   "effective_to_partner_folder_name": "outgoing",
   "effective_from_partner_folder_name": "incoming",
   "channel_path": "partners/acme/claims/medical",
@@ -23,11 +30,14 @@
 * `id` (int64): The unique ID of the Partner Channel.
 * `workspace_id` (int64): ID of the Workspace associated with this Partner Channel.
 * `partner_id` (int64): ID of the Partner this Channel belongs to.
+* `partner_channel_template_id` (int64): ID of the Partner Channel Template that manages this Channel, if any.
 * `path` (string): Channel path relative to the Partner root folder. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
 * `to_partner_folder_name` (string): Optional Channel-level to-Partner folder name override.
 * `from_partner_folder_name` (string): Optional Channel-level from-Partner folder name override.
 * `from_partner_route_path` (string): Optional route path for files uploaded by the Partner.
 * `to_partner_route_path` (string): Optional route path for files delivered to the Partner.
+* `to_partner_managed_folder_paths` (array(string)): Managed folder paths inside the to-Partner folder.
+* `from_partner_managed_folder_paths` (array(string)): Managed folder paths inside the from-Partner folder.
 * `effective_to_partner_folder_name` (string): Resolved to-Partner folder name after Channel override and default.
 * `effective_from_partner_folder_name` (string): Resolved from-Partner folder name after Channel override and default.
 * `channel_path` (string): Resolved Channel folder path.
@@ -71,8 +81,10 @@ Files::PartnerChannel.find(id)
 ```
 Files::PartnerChannel.create(
   from_partner_folder_name: "incoming", 
+  from_partner_managed_folder_paths: ["claims/received"], 
   from_partner_route_path: "processing/from-partner", 
   to_partner_folder_name: "outgoing", 
+  to_partner_managed_folder_paths: ["reports/monthly"], 
   to_partner_route_path: "delivery/to-partner", 
   partner_id: 1, 
   path: "claims/medical", 
@@ -83,8 +95,10 @@ Files::PartnerChannel.create(
 ### Parameters
 
 * `from_partner_folder_name` (string): Optional Channel-level from-Partner folder name override.
+* `from_partner_managed_folder_paths` (array(string)): Managed folder paths inside the from-Partner folder.
 * `from_partner_route_path` (string): Optional route path for files uploaded by the Partner.
 * `to_partner_folder_name` (string): Optional Channel-level to-Partner folder name override.
+* `to_partner_managed_folder_paths` (array(string)): Managed folder paths inside the to-Partner folder.
 * `to_partner_route_path` (string): Optional route path for files delivered to the Partner.
 * `partner_id` (int64): Required - ID of the Partner this Channel belongs to.
 * `path` (string): Required - Channel path relative to the Partner root folder.
@@ -98,8 +112,10 @@ Files::PartnerChannel.create(
 ```
 Files::PartnerChannel.update(id, 
   from_partner_folder_name: "incoming", 
+  from_partner_managed_folder_paths: ["claims/received"], 
   from_partner_route_path: "processing/from-partner", 
   to_partner_folder_name: "outgoing", 
+  to_partner_managed_folder_paths: ["reports/monthly"], 
   to_partner_route_path: "delivery/to-partner", 
   path: "claims/medical"
 )
@@ -109,8 +125,10 @@ Files::PartnerChannel.update(id,
 
 * `id` (int64): Required - Partner Channel ID.
 * `from_partner_folder_name` (string): Optional Channel-level from-Partner folder name override.
+* `from_partner_managed_folder_paths` (array(string)): Managed folder paths inside the from-Partner folder.
 * `from_partner_route_path` (string): Optional route path for files uploaded by the Partner.
 * `to_partner_folder_name` (string): Optional Channel-level to-Partner folder name override.
+* `to_partner_managed_folder_paths` (array(string)): Managed folder paths inside the to-Partner folder.
 * `to_partner_route_path` (string): Optional route path for files delivered to the Partner.
 * `path` (string): Channel path relative to the Partner root folder.
 
@@ -137,8 +155,10 @@ partner_channel = Files::PartnerChannel.find(id)
 
 partner_channel.update(
   from_partner_folder_name: "incoming",
+  from_partner_managed_folder_paths: ["claims/received"],
   from_partner_route_path: "processing/from-partner",
   to_partner_folder_name: "outgoing",
+  to_partner_managed_folder_paths: ["reports/monthly"],
   to_partner_route_path: "delivery/to-partner",
   path: "claims/medical"
 )
@@ -148,8 +168,10 @@ partner_channel.update(
 
 * `id` (int64): Required - Partner Channel ID.
 * `from_partner_folder_name` (string): Optional Channel-level from-Partner folder name override.
+* `from_partner_managed_folder_paths` (array(string)): Managed folder paths inside the from-Partner folder.
 * `from_partner_route_path` (string): Optional route path for files uploaded by the Partner.
 * `to_partner_folder_name` (string): Optional Channel-level to-Partner folder name override.
+* `to_partner_managed_folder_paths` (array(string)): Managed folder paths inside the to-Partner folder.
 * `to_partner_route_path` (string): Optional route path for files delivered to the Partner.
 * `path` (string): Channel path relative to the Partner root folder.
 

data/docs/partner_channel_template.md

@@ -0,0 +1,187 @@
+# PartnerChannelTemplate
+
+## Example PartnerChannelTemplate Object
+
+```
+{
+  "id": 1,
+  "workspace_id": 1,
+  "name": "Claims Template",
+  "path": "claims/medical",
+  "to_partner_folder_name": "outgoing",
+  "from_partner_folder_name": "incoming",
+  "from_partner_route_path": "processing/from-partner",
+  "to_partner_route_path": "delivery/to-partner",
+  "to_partner_managed_folder_paths": [
+    "reports/monthly"
+  ],
+  "from_partner_managed_folder_paths": [
+    "claims/received"
+  ],
+  "effective_to_partner_folder_name": "outgoing",
+  "effective_from_partner_folder_name": "incoming"
+}
+```
+
+* `id` (int64): The unique ID of the Partner Channel Template.
+* `workspace_id` (int64): ID of the Workspace associated with this Partner Channel Template.
+* `name` (string): The name of the Partner Channel Template.
+* `path` (string): Channel path relative to the Partner root folder. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
+* `to_partner_folder_name` (string): Optional Channel-level to-Partner folder name override.
+* `from_partner_folder_name` (string): Optional Channel-level from-Partner folder name override.
+* `from_partner_route_path` (string): Optional route path for files uploaded by the Partner.
+* `to_partner_route_path` (string): Optional route path for files delivered to the Partner.
+* `to_partner_managed_folder_paths` (array(string)): Managed folder paths inside the to-Partner folder.
+* `from_partner_managed_folder_paths` (array(string)): Managed folder paths inside the from-Partner folder.
+* `effective_to_partner_folder_name` (string): Resolved to-Partner folder name after Template override and default.
+* `effective_from_partner_folder_name` (string): Resolved from-Partner folder name after Template override and default.
+
+
+---
+
+## List Partner Channel Templates
+
+```
+Files::PartnerChannelTemplate.list
+```
+
+### 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: 10000, 1,000 or less is recommended).
+* `sort_by` (object): If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `workspace_id` and `name`.
+* `filter` (object): If set, return records where the specified field is equal to the supplied value. Valid fields are `workspace_id`.
+
+
+---
+
+## Show Partner Channel Template
+
+```
+Files::PartnerChannelTemplate.find(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Partner Channel Template ID.
+
+
+---
+
+## Create Partner Channel Template
+
+```
+Files::PartnerChannelTemplate.create(
+  from_partner_folder_name: "incoming", 
+  from_partner_managed_folder_paths: ["claims/received"], 
+  from_partner_route_path: "processing/from-partner", 
+  to_partner_folder_name: "outgoing", 
+  to_partner_managed_folder_paths: ["reports/monthly"], 
+  to_partner_route_path: "delivery/to-partner", 
+  name: "Claims Template", 
+  path: "claims/medical", 
+  workspace_id: 0
+)
+```
+
+### Parameters
+
+* `from_partner_folder_name` (string): Optional Channel-level from-Partner folder name override.
+* `from_partner_managed_folder_paths` (array(string)): Managed folder paths inside the from-Partner folder.
+* `from_partner_route_path` (string): Optional route path for files uploaded by the Partner.
+* `to_partner_folder_name` (string): Optional Channel-level to-Partner folder name override.
+* `to_partner_managed_folder_paths` (array(string)): Managed folder paths inside the to-Partner folder.
+* `to_partner_route_path` (string): Optional route path for files delivered to the Partner.
+* `name` (string): Required - The name of the Partner Channel Template.
+* `path` (string): Required - Channel path relative to the Partner root folder.
+* `workspace_id` (int64): ID of the Workspace associated with this Partner Channel Template.
+
+
+---
+
+## Update Partner Channel Template
+
+```
+Files::PartnerChannelTemplate.update(id, 
+  from_partner_folder_name: "incoming", 
+  from_partner_managed_folder_paths: ["claims/received"], 
+  from_partner_route_path: "processing/from-partner", 
+  to_partner_folder_name: "outgoing", 
+  to_partner_managed_folder_paths: ["reports/monthly"], 
+  to_partner_route_path: "delivery/to-partner", 
+  name: "Claims Template", 
+  path: "claims/medical"
+)
+```
+
+### Parameters
+
+* `id` (int64): Required - Partner Channel Template ID.
+* `from_partner_folder_name` (string): Optional Channel-level from-Partner folder name override.
+* `from_partner_managed_folder_paths` (array(string)): Managed folder paths inside the from-Partner folder.
+* `from_partner_route_path` (string): Optional route path for files uploaded by the Partner.
+* `to_partner_folder_name` (string): Optional Channel-level to-Partner folder name override.
+* `to_partner_managed_folder_paths` (array(string)): Managed folder paths inside the to-Partner folder.
+* `to_partner_route_path` (string): Optional route path for files delivered to the Partner.
+* `name` (string): The name of the Partner Channel Template.
+* `path` (string): Channel path relative to the Partner root folder.
+
+
+---
+
+## Delete Partner Channel Template
+
+```
+Files::PartnerChannelTemplate.delete(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Partner Channel Template ID.
+
+
+---
+
+## Update Partner Channel Template
+
+```
+partner_channel_template = Files::PartnerChannelTemplate.find(id)
+
+partner_channel_template.update(
+  from_partner_folder_name: "incoming",
+  from_partner_managed_folder_paths: ["claims/received"],
+  from_partner_route_path: "processing/from-partner",
+  to_partner_folder_name: "outgoing",
+  to_partner_managed_folder_paths: ["reports/monthly"],
+  to_partner_route_path: "delivery/to-partner",
+  name: "Claims Template",
+  path: "claims/medical"
+)
+```
+
+### Parameters
+
+* `id` (int64): Required - Partner Channel Template ID.
+* `from_partner_folder_name` (string): Optional Channel-level from-Partner folder name override.
+* `from_partner_managed_folder_paths` (array(string)): Managed folder paths inside the from-Partner folder.
+* `from_partner_route_path` (string): Optional route path for files uploaded by the Partner.
+* `to_partner_folder_name` (string): Optional Channel-level to-Partner folder name override.
+* `to_partner_managed_folder_paths` (array(string)): Managed folder paths inside the to-Partner folder.
+* `to_partner_route_path` (string): Optional route path for files delivered to the Partner.
+* `name` (string): The name of the Partner Channel Template.
+* `path` (string): Channel path relative to the Partner root folder.
+
+
+---
+
+## Delete Partner Channel Template
+
+```
+partner_channel_template = Files::PartnerChannelTemplate.find(id)
+
+partner_channel_template.delete
+```
+
+### Parameters
+
+* `id` (int64): Required - Partner Channel Template ID.

data/docs/secret.md

@@ -0,0 +1,158 @@
+# Secret
+
+## Example Secret Object
+
+```
+{
+  "id": 1,
+  "workspace_id": 1,
+  "name": "Production API token",
+  "description": "Used by production API integrations.",
+  "secret_type": "token",
+  "metadata": {
+    "key": "example value"
+  },
+  "value_field_names": [
+    "example"
+  ],
+  "created_at": "2000-01-01T01:00:00Z",
+  "updated_at": "2000-01-01T01:00:00Z"
+}
+```
+
+* `id` (int64): Secret ID.
+* `workspace_id` (int64): Workspace ID. 0 means the default workspace.
+* `name` (string): Secret name.
+* `description` (string): Internal description for your reference.
+* `secret_type` (string): Secret type.
+* `metadata` (object): Non-secret metadata for the Secret type.
+* `value_field_names` (array(string)): Names of configured secret value fields. Secret values are never returned.
+* `created_at` (date-time): Secret create date/time.
+* `updated_at` (date-time): Secret update date/time.
+
+
+---
+
+## List Secrets
+
+```
+Files::Secret.list
+```
+
+### 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: 10000, 1,000 or less is recommended).
+* `sort_by` (object): If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `workspace_id`, `name` or `secret_type`.
+* `filter` (object): If set, return records where the specified field is equal to the supplied value. Valid fields are `workspace_id`, `name` or `secret_type`. Valid field combinations are `[ workspace_id, name ]`, `[ workspace_id, secret_type ]`, `[ secret_type, name ]` or `[ workspace_id, secret_type, name ]`.
+* `filter_prefix` (object): If set, return records where the specified field is prefixed by the supplied value. Valid fields are `name`.
+
+
+---
+
+## Show Secret
+
+```
+Files::Secret.find(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Secret ID.
+
+
+---
+
+## Create Secret
+
+```
+Files::Secret.create(
+  name: "Production API token", 
+  description: "Used by production API integrations.", 
+  secret_type: "token", 
+  metadata: {"key":"example value"}, 
+  workspace_id: 0
+)
+```
+
+### Parameters
+
+* `name` (string): Required - Secret name.
+* `description` (string): Internal description for your reference.
+* `secret_type` (string): Required - Secret type.
+* `metadata` (object): Non-secret metadata for the Secret type.
+* `workspace_id` (int64): Workspace ID. 0 means the default workspace.
+
+
+---
+
+## Update Secret
+
+```
+Files::Secret.update(id, 
+  name: "Production API token", 
+  description: "Used by production API integrations.", 
+  secret_type: "token", 
+  metadata: {"key":"example value"}
+)
+```
+
+### Parameters
+
+* `id` (int64): Required - Secret ID.
+* `name` (string): Secret name.
+* `description` (string): Internal description for your reference.
+* `secret_type` (string): Secret type.
+* `metadata` (object): Non-secret metadata for the Secret type.
+
+
+---
+
+## Delete Secret
+
+```
+Files::Secret.delete(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Secret ID.
+
+
+---
+
+## Update Secret
+
+```
+secret = Files::Secret.find(id)
+
+secret.update(
+  name: "Production API token",
+  description: "Used by production API integrations.",
+  secret_type: "token",
+  metadata: {"key":"example value"}
+)
+```
+
+### Parameters
+
+* `id` (int64): Required - Secret ID.
+* `name` (string): Secret name.
+* `description` (string): Internal description for your reference.
+* `secret_type` (string): Secret type.
+* `metadata` (object): Non-secret metadata for the Secret type.
+
+
+---
+
+## Delete Secret
+
+```
+secret = Files::Secret.find(id)
+
+secret.delete
+```
+
+### Parameters
+
+* `id` (int64): Required - Secret ID.

data/lib/files.com/models/behavior.rb

@@ -72,6 +72,15 @@ module Files
       @attributes[:value] = value
     end
 
+    # string - Public URL for this publicly hosted folder when the `Serve Publicly` behavior has a key configured.  When a Custom Domain with `public_hosting` destination is attached to this behavior, the URL uses that domain.  Otherwise it uses the site's `subdomain.hosted-by-files.com` host.
+    def public_hosting_url
+      @attributes[:public_hosting_url]
+    end
+
+    def public_hosting_url=(value)
+      @attributes[:public_hosting_url] = value
+    end
+
     # boolean - If true, the parent folder's behavior will be disabled for this folder and its children.
     def disable_parent_folder_behavior
       @attributes[:disable_parent_folder_behavior]

data/lib/files.com/models/custom_domain.rb

@@ -27,7 +27,7 @@ module Files
       @attributes[:domain] = value
     end
 
-    # string - Where this custom domain routes. Can be `site_alias`, `public_hosting`, or `s3_endpoint`.
+    # string - Where this custom domain routes. Can be `site_alias`, `public_hosting`, `s3_endpoint`, or `unassigned` (not routing traffic). Set to `unassigned` automatically when a bound `public_hosting` folder behavior is deleted, and can be set manually via the API for any reason.
     def destination
       @attributes[:destination]
     end
@@ -63,7 +63,7 @@ module Files
       @attributes[:brick_managed] = value
     end
 
-    # int64 - Public Hosting behavior ID when this domain routes to a specific Public Hosting behavior.
+    # int64 - Public Hosting behavior ID when this domain routes to a specific Public Hosting behavior.  Preserved as historical context when `destination` becomes `unassigned`.
     def folder_behavior_id
       @attributes[:folder_behavior_id]
     end
@@ -83,8 +83,8 @@ module Files
     end
 
     # Parameters:
-    #   destination - string - Where this custom domain routes. Can be `site_alias`, `public_hosting`, or `s3_endpoint`.
-    #   folder_behavior_id - int64 - Public Hosting behavior ID when this domain routes to a specific Public Hosting behavior.
+    #   destination - string - Where this custom domain routes. Can be `site_alias`, `public_hosting`, `s3_endpoint`, or `unassigned` (not routing traffic). Set to `unassigned` automatically when a bound `public_hosting` folder behavior is deleted, and can be set manually via the API for any reason.
+    #   folder_behavior_id - int64 - Public Hosting behavior ID when this domain routes to a specific Public Hosting behavior.  Preserved as historical context when `destination` becomes `unassigned`.
     #   ssl_certificate_id - int64 - Current SSL certificate ID.
     #   domain - string - Customer-owned domain name.
     def update(params = {})
@@ -162,8 +162,8 @@ module Files
     end
 
     # Parameters:
-    #   destination - string - Where this custom domain routes. Can be `site_alias`, `public_hosting`, or `s3_endpoint`.
-    #   folder_behavior_id - int64 - Public Hosting behavior ID when this domain routes to a specific Public Hosting behavior.
+    #   destination - string - Where this custom domain routes. Can be `site_alias`, `public_hosting`, `s3_endpoint`, or `unassigned` (not routing traffic). Set to `unassigned` automatically when a bound `public_hosting` folder behavior is deleted, and can be set manually via the API for any reason.
+    #   folder_behavior_id - int64 - Public Hosting behavior ID when this domain routes to a specific Public Hosting behavior.  Preserved as historical context when `destination` becomes `unassigned`.
     #   ssl_certificate_id - int64 - Current SSL certificate ID.
     #   domain (required) - string - Customer-owned domain name.
     def self.create(params = {}, options = {})
@@ -178,8 +178,8 @@ module Files
     end
 
     # Parameters:
-    #   destination - string - Where this custom domain routes. Can be `site_alias`, `public_hosting`, or `s3_endpoint`.
-    #   folder_behavior_id - int64 - Public Hosting behavior ID when this domain routes to a specific Public Hosting behavior.
+    #   destination - string - Where this custom domain routes. Can be `site_alias`, `public_hosting`, `s3_endpoint`, or `unassigned` (not routing traffic). Set to `unassigned` automatically when a bound `public_hosting` folder behavior is deleted, and can be set manually via the API for any reason.
+    #   folder_behavior_id - int64 - Public Hosting behavior ID when this domain routes to a specific Public Hosting behavior.  Preserved as historical context when `destination` becomes `unassigned`.
     #   ssl_certificate_id - int64 - Current SSL certificate ID.
     #   domain - string - Customer-owned domain name.
     def self.update(id, params = {}, options = {})