files.com 1.1.620 → 1.1.622

data/docs/external_event.md

@@ -9,15 +9,7 @@
   "status": "example",
   "body": "example",
   "created_at": "2000-01-01T01:00:00Z",
-  "body_url": "example",
-  "folder_behavior_id": 1,
-  "siem_http_destination_id": 1,
-  "successful_files": 1,
-  "errored_files": 1,
-  "bytes_synced": 1,
-  "compared_files": 1,
-  "compared_folders": 1,
-  "remote_server_type": "example"
+  "body_url": "example"
 }
 ```
 
@@ -27,14 +19,6 @@
 * `body` (string): Event body
 * `created_at` (date-time): External event create date/time
 * `body_url` (string): Link to log file.
-* `folder_behavior_id` (int64): Folder Behavior ID
-* `siem_http_destination_id` (int64): SIEM HTTP Destination ID.
-* `successful_files` (int64): For sync events, the number of files handled successfully.
-* `errored_files` (int64): For sync events, the number of files that encountered errors.
-* `bytes_synced` (int64): For sync events, the total number of bytes synced.
-* `compared_files` (int64): For sync events, the number of files considered for the sync.
-* `compared_folders` (int64): For sync events, the number of folders listed and considered for the sync.
-* `remote_server_type` (string): Associated Remote Server type, if any
 
 
 ---
@@ -49,8 +33,8 @@ Files::ExternalEvent.list
 
 * `cursor` (string): Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
 * `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
-* `sort_by` (object): If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `siem_http_destination_id`, `created_at`, `event_type`, `status` or `folder_behavior_id`.
-* `filter` (object): If set, return records where the specified field is equal to the supplied value. Valid fields are `created_at`, `event_type`, `remote_server_type`, `status`, `folder_behavior_id` or `siem_http_destination_id`. Valid field combinations are `[ event_type, created_at ]`, `[ remote_server_type, created_at ]`, `[ status, created_at ]`, `[ folder_behavior_id, created_at ]`, `[ event_type, status ]`, `[ remote_server_type, status ]`, `[ folder_behavior_id, status ]`, `[ event_type, status, created_at ]`, `[ remote_server_type, status, created_at ]` or `[ folder_behavior_id, status, created_at ]`.
+* `sort_by` (object): If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `created_at`, `status` or `event_type`.
+* `filter` (object): If set, return records where the specified field is equal to the supplied value. Valid fields are `created_at` and `status`. Valid field combinations are `[ status, created_at ]`.
 * `filter_gt` (object): If set, return records where the specified field is greater than the supplied value. Valid fields are `created_at`.
 * `filter_gteq` (object): If set, return records where the specified field is greater than or equal the supplied value. Valid fields are `created_at`.
 * `filter_lt` (object): If set, return records where the specified field is less than the supplied value. Valid fields are `created_at`.

data/docs/partner.md

@@ -9,6 +9,7 @@
   "allow_credential_changes": true,
   "allow_providing_gpg_keys": true,
   "allow_user_creation": true,
+  "cc_emails_to_responsible_party": true,
   "id": 1,
   "workspace_id": 1,
   "name": "Acme Corp",
@@ -18,6 +19,8 @@
     2,
     3
   ],
+  "responsible_group_id": 1,
+  "responsible_user_id": 1,
   "root_folder": "/AcmeCorp",
   "tags": "example",
   "user_ids": [
@@ -33,11 +36,14 @@
 * `allow_credential_changes` (boolean): Allow Partner Admins to change or reset credentials for users belonging to this Partner.
 * `allow_providing_gpg_keys` (boolean): Allow Partner Admins to provide GPG keys.
 * `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.
 * `id` (int64): The unique ID of the Partner.
 * `workspace_id` (int64): ID of the Workspace associated with this Partner.
 * `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.
+* `responsible_group_id` (int64): ID of the Group responsible for this Partner.
+* `responsible_user_id` (int64): ID of the User responsible for this Partner.
 * `root_folder` (string): The root folder path 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.
 * `user_ids` (array(int64)): Array of User IDs that belong to this Partner.
@@ -83,7 +89,10 @@ Files::Partner.create(
   allow_credential_changes: false, 
   allow_providing_gpg_keys: false, 
   allow_user_creation: false, 
+  cc_emails_to_responsible_party: false, 
   notes: "This is a note about the partner.", 
+  responsible_group_id: 1, 
+  responsible_user_id: 1, 
   tags: "example", 
   name: "Acme Corp", 
   root_folder: "/AcmeCorp", 
@@ -98,7 +107,10 @@ Files::Partner.create(
 * `allow_credential_changes` (boolean): Allow Partner Admins to change or reset credentials for users belonging to this Partner.
 * `allow_providing_gpg_keys` (boolean): Allow Partner Admins to provide GPG keys.
 * `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.
+* `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.
 * `name` (string): Required - The name of the Partner.
 * `root_folder` (string): Required - The root folder path for this Partner.
@@ -116,7 +128,10 @@ Files::Partner.update(id,
   allow_credential_changes: false, 
   allow_providing_gpg_keys: false, 
   allow_user_creation: false, 
+  cc_emails_to_responsible_party: false, 
   notes: "This is a note about the partner.", 
+  responsible_group_id: 1, 
+  responsible_user_id: 1, 
   tags: "example", 
   name: "Acme Corp", 
   root_folder: "/AcmeCorp"
@@ -131,7 +146,10 @@ Files::Partner.update(id,
 * `allow_credential_changes` (boolean): Allow Partner Admins to change or reset credentials for users belonging to this Partner.
 * `allow_providing_gpg_keys` (boolean): Allow Partner Admins to provide GPG keys.
 * `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.
+* `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.
 * `name` (string): The name of the Partner.
 * `root_folder` (string): The root folder path for this Partner.
@@ -163,7 +181,10 @@ partner.update(
   allow_credential_changes: false,
   allow_providing_gpg_keys: false,
   allow_user_creation: false,
+  cc_emails_to_responsible_party: false,
   notes: "This is a note about the partner.",
+  responsible_group_id: 1,
+  responsible_user_id: 1,
   tags: "example",
   name: "Acme Corp",
   root_folder: "/AcmeCorp"
@@ -178,7 +199,10 @@ partner.update(
 * `allow_credential_changes` (boolean): Allow Partner Admins to change or reset credentials for users belonging to this Partner.
 * `allow_providing_gpg_keys` (boolean): Allow Partner Admins to provide GPG keys.
 * `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.
+* `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.
 * `name` (string): The name of the Partner.
 * `root_folder` (string): The root folder path for this Partner.

data/docs/pending_work_event.md

@@ -0,0 +1,60 @@
+# PendingWorkEvent
+
+## Example PendingWorkEvent Object
+
+```
+{
+  "id": 1,
+  "event_type": "example",
+  "status": "example",
+  "body": "example",
+  "event_errors": [
+    "example"
+  ],
+  "created_at": "2000-01-01T01:00:00Z",
+  "body_url": "example",
+  "folder_behavior_id": 1
+}
+```
+
+* `id` (int64): Event ID
+* `event_type` (string): Type of pending work event being recorded.
+* `status` (string): Status of event.
+* `body` (string): Event body.
+* `event_errors` (array(string)): Event errors.
+* `created_at` (date-time): Event create date/time.
+* `body_url` (string): Link to log file.
+* `folder_behavior_id` (int64): Folder Behavior ID.
+
+
+---
+
+## List Pending Work Events
+
+```
+Files::PendingWorkEvent.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: 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. Valid fields are `created_at`, `status` or `folder_behavior_id`.
+* `filter` (object): If set, return records where the specified field is equal to the supplied value. Valid fields are `created_at`, `folder_behavior_id` or `status`. Valid field combinations are `[ folder_behavior_id, created_at ]`, `[ status, created_at ]`, `[ folder_behavior_id, status ]` or `[ folder_behavior_id, status, created_at ]`.
+* `filter_gt` (object): If set, return records where the specified field is greater than the supplied value. Valid fields are `created_at`.
+* `filter_gteq` (object): If set, return records where the specified field is greater than or equal the supplied value. Valid fields are `created_at`.
+* `filter_lt` (object): If set, return records where the specified field is less than the supplied value. Valid fields are `created_at`.
+* `filter_lteq` (object): If set, return records where the specified field is less than or equal the supplied value. Valid fields are `created_at`.
+
+
+---
+
+## Show Pending Work Event
+
+```
+Files::PendingWorkEvent.find(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Pending Work Event ID.

data/docs/siem_http_destination_event.md

@@ -0,0 +1,60 @@
+# SiemHttpDestinationEvent
+
+## Example SiemHttpDestinationEvent Object
+
+```
+{
+  "id": 1,
+  "event_type": "example",
+  "status": "example",
+  "body": "example",
+  "event_errors": [
+    "example"
+  ],
+  "created_at": "2000-01-01T01:00:00Z",
+  "body_url": "example",
+  "siem_http_destination_id": 1
+}
+```
+
+* `id` (int64): Event ID
+* `event_type` (string): Type of SIEM event being recorded.
+* `status` (string): Status of event.
+* `body` (string): Event body.
+* `event_errors` (array(string)): Event errors.
+* `created_at` (date-time): Event create date/time.
+* `body_url` (string): Link to log file.
+* `siem_http_destination_id` (int64): SIEM ID.
+
+
+---
+
+## List SIEM HTTP Destination Events
+
+```
+Files::SiemHttpDestinationEvent.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: 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. Valid fields are `created_at`, `status` or `siem_http_destination_id`.
+* `filter` (object): If set, return records where the specified field is equal to the supplied value. Valid fields are `created_at`, `siem_http_destination_id` or `status`. Valid field combinations are `[ siem_http_destination_id, created_at ]`, `[ status, created_at ]`, `[ siem_http_destination_id, status ]` or `[ siem_http_destination_id, status, created_at ]`.
+* `filter_gt` (object): If set, return records where the specified field is greater than the supplied value. Valid fields are `created_at`.
+* `filter_gteq` (object): If set, return records where the specified field is greater than or equal the supplied value. Valid fields are `created_at`.
+* `filter_lt` (object): If set, return records where the specified field is less than the supplied value. Valid fields are `created_at`.
+* `filter_lteq` (object): If set, return records where the specified field is less than or equal the supplied value. Valid fields are `created_at`.
+
+
+---
+
+## Show SIEM HTTP Destination Event
+
+```
+Files::SiemHttpDestinationEvent.find(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Siem Http Destination Event ID.

data/docs/site.md

@@ -280,6 +280,14 @@
     "primary_group_id": 1,
     "public_keys_count": 1,
     "receive_admin_alerts": true,
+    "notify_on_all_site_warnings": true,
+    "notify_on_all_sso_failures": true,
+    "notify_on_all_user_security_events": true,
+    "notify_on_all_pending_work_failures": true,
+    "notify_on_all_siem_http_destination_failures": true,
+    "notify_on_all_sync_failures": true,
+    "notify_on_all_automation_failures": true,
+    "notify_on_all_expectation_failures": true,
     "require_2fa": "always_require",
     "require_login_by": "2000-01-01T01:00:00Z",
     "active_2fa": true,

data/docs/sso_event.md

@@ -0,0 +1,73 @@
+# SsoEvent
+
+## Example SsoEvent Object
+
+```
+{
+  "id": 1,
+  "event_type": "example",
+  "status": "example",
+  "body": "example",
+  "event_errors": [
+    "example"
+  ],
+  "created_at": "2000-01-01T01:00:00Z",
+  "body_url": "example",
+  "user_id": 1,
+  "username": "example",
+  "idp_uid": "example",
+  "provider": "example",
+  "provider_label": "example",
+  "ip": "example",
+  "region": "example"
+}
+```
+
+* `id` (int64): Event ID
+* `event_type` (string): Type of SSO event being recorded.
+* `status` (string): Status of event.
+* `body` (string): Event body.
+* `event_errors` (array(string)): Event errors.
+* `created_at` (date-time): Event create date/time.
+* `body_url` (string): Link to log file.
+* `user_id` (int64): User ID.
+* `username` (string): Username on Files.com for the SSO login attempt.
+* `idp_uid` (string): Identity Provider UID for the SSO login attempt.
+* `provider` (string): SSO provider for the SSO login attempt.
+* `provider_label` (string): SSO provider label for the SSO login attempt.
+* `ip` (string): IP address for the SSO login attempt.
+* `region` (string): Region for the SSO login attempt.
+
+
+---
+
+## List SSO Events
+
+```
+Files::SsoEvent.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: 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. Valid fields are `created_at`, `event_type`, `status` or `user_id`.
+* `filter` (object): If set, return records where the specified field is equal to the supplied value. Valid fields are `created_at`, `event_type`, `idp_uid`, `ip`, `provider`, `status`, `user_id` or `username`. Valid field combinations are `[ event_type, created_at ]`, `[ idp_uid, created_at ]`, `[ ip, created_at ]`, `[ provider, created_at ]`, `[ status, created_at ]`, `[ user_id, created_at ]`, `[ username, created_at ]`, `[ event_type, status ]`, `[ idp_uid, status ]`, `[ ip, status ]`, `[ provider, status ]`, `[ user_id, status ]`, `[ username, status ]`, `[ event_type, status, created_at ]`, `[ idp_uid, status, created_at ]`, `[ ip, status, created_at ]`, `[ provider, status, created_at ]`, `[ user_id, status, created_at ]` or `[ username, status, created_at ]`.
+* `filter_gt` (object): If set, return records where the specified field is greater than the supplied value. Valid fields are `created_at`.
+* `filter_gteq` (object): If set, return records where the specified field is greater than or equal the supplied value. Valid fields are `created_at`.
+* `filter_prefix` (object): If set, return records where the specified field is prefixed by the supplied value. Valid fields are `idp_uid`, `ip`, `provider` or `username`.
+* `filter_lt` (object): If set, return records where the specified field is less than the supplied value. Valid fields are `created_at`.
+* `filter_lteq` (object): If set, return records where the specified field is less than or equal the supplied value. Valid fields are `created_at`.
+
+
+---
+
+## Show SSO Event
+
+```
+Files::SsoEvent.find(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Sso Event ID.

data/docs/user.md

@@ -55,6 +55,14 @@
   "primary_group_id": 1,
   "public_keys_count": 1,
   "receive_admin_alerts": true,
+  "notify_on_all_site_warnings": true,
+  "notify_on_all_sso_failures": true,
+  "notify_on_all_user_security_events": true,
+  "notify_on_all_pending_work_failures": true,
+  "notify_on_all_siem_http_destination_failures": true,
+  "notify_on_all_sync_failures": true,
+  "notify_on_all_automation_failures": true,
+  "notify_on_all_expectation_failures": true,
   "require_2fa": "always_require",
   "require_login_by": "2000-01-01T01:00:00Z",
   "active_2fa": true,
@@ -132,7 +140,15 @@
 * `password_validity_days` (int64): Number of days to allow user to use the same password
 * `primary_group_id` (int64): Primary group ID for Group Admin scoping
 * `public_keys_count` (int64): Number of public keys associated with this user
-* `receive_admin_alerts` (boolean): Should the user receive admin alerts such a certificate expiration notifications and overages?
+* `receive_admin_alerts` (boolean): Deprecated. Use notify_on_all_site_warnings and granular failure notification preferences instead.
+* `notify_on_all_site_warnings` (boolean): Should the user receive site warnings via email?
+* `notify_on_all_sso_failures` (boolean): Should the user receive sso/scim/ldap configuration/sync failures via email?
+* `notify_on_all_user_security_events` (boolean): Should the user receive user security events via email?
+* `notify_on_all_pending_work_failures` (boolean): Should the user receive pending work failures via email?
+* `notify_on_all_siem_http_destination_failures` (boolean): Should the user receive siem failures via email?
+* `notify_on_all_sync_failures` (boolean): Should the user receive sync failures via email?
+* `notify_on_all_automation_failures` (boolean): Should the user receive automation failures via email?
+* `notify_on_all_expectation_failures` (boolean): Should the user receive expectation failures and misses via email?
 * `require_2fa` (string): 2FA required setting
 * `require_login_by` (date-time): Require user to login by specified date otherwise it will be disabled.
 * `active_2fa` (boolean): Is 2fa active for the user?
@@ -248,6 +264,14 @@ Files::User.create(
   primary_group_id: 1, 
   readonly_site_admin: true, 
   receive_admin_alerts: true, 
+  notify_on_all_site_warnings: true, 
+  notify_on_all_sso_failures: true, 
+  notify_on_all_user_security_events: true, 
+  notify_on_all_pending_work_failures: true, 
+  notify_on_all_siem_http_destination_failures: true, 
+  notify_on_all_sync_failures: true, 
+  notify_on_all_automation_failures: true, 
+  notify_on_all_expectation_failures: true, 
   require_login_by: "2000-01-01T01:00:00Z", 
   require_password_change: true, 
   restapi_permission: true, 
@@ -307,7 +331,15 @@ Files::User.create(
 * `password_validity_days` (int64): Number of days to allow user to use the same password
 * `primary_group_id` (int64): Primary group ID for Group Admin scoping
 * `readonly_site_admin` (boolean): Is the user an allowed to view all (non-billing) site configuration for this site?
-* `receive_admin_alerts` (boolean): Should the user receive admin alerts such a certificate expiration notifications and overages?
+* `receive_admin_alerts` (boolean): Deprecated. Use notify_on_all_site_warnings and granular failure notification preferences instead.
+* `notify_on_all_site_warnings` (boolean): Should the user receive site warnings via email?
+* `notify_on_all_sso_failures` (boolean): Should the user receive sso/scim/ldap configuration/sync failures via email?
+* `notify_on_all_user_security_events` (boolean): Should the user receive user security events via email?
+* `notify_on_all_pending_work_failures` (boolean): Should the user receive pending work failures via email?
+* `notify_on_all_siem_http_destination_failures` (boolean): Should the user receive siem failures via email?
+* `notify_on_all_sync_failures` (boolean): Should the user receive sync failures via email?
+* `notify_on_all_automation_failures` (boolean): Should the user receive automation failures via email?
+* `notify_on_all_expectation_failures` (boolean): Should the user receive expectation failures and misses via email?
 * `require_login_by` (string): Require user to login by specified date otherwise it will be disabled.
 * `require_password_change` (boolean): Is a password change required upon next user login?
 * `restapi_permission` (boolean): Can this user access the Web app, Desktop app, SDKs, or REST API?  (All of these tools use the API internally, so this is one unified permission set.)
@@ -403,6 +435,14 @@ Files::User.update(id,
   primary_group_id: 1, 
   readonly_site_admin: true, 
   receive_admin_alerts: true, 
+  notify_on_all_site_warnings: true, 
+  notify_on_all_sso_failures: true, 
+  notify_on_all_user_security_events: true, 
+  notify_on_all_pending_work_failures: true, 
+  notify_on_all_siem_http_destination_failures: true, 
+  notify_on_all_sync_failures: true, 
+  notify_on_all_automation_failures: true, 
+  notify_on_all_expectation_failures: true, 
   require_login_by: "2000-01-01T01:00:00Z", 
   require_password_change: true, 
   restapi_permission: true, 
@@ -464,7 +504,15 @@ Files::User.update(id,
 * `password_validity_days` (int64): Number of days to allow user to use the same password
 * `primary_group_id` (int64): Primary group ID for Group Admin scoping
 * `readonly_site_admin` (boolean): Is the user an allowed to view all (non-billing) site configuration for this site?
-* `receive_admin_alerts` (boolean): Should the user receive admin alerts such a certificate expiration notifications and overages?
+* `receive_admin_alerts` (boolean): Deprecated. Use notify_on_all_site_warnings and granular failure notification preferences instead.
+* `notify_on_all_site_warnings` (boolean): Should the user receive site warnings via email?
+* `notify_on_all_sso_failures` (boolean): Should the user receive sso/scim/ldap configuration/sync failures via email?
+* `notify_on_all_user_security_events` (boolean): Should the user receive user security events via email?
+* `notify_on_all_pending_work_failures` (boolean): Should the user receive pending work failures via email?
+* `notify_on_all_siem_http_destination_failures` (boolean): Should the user receive siem failures via email?
+* `notify_on_all_sync_failures` (boolean): Should the user receive sync failures via email?
+* `notify_on_all_automation_failures` (boolean): Should the user receive automation failures via email?
+* `notify_on_all_expectation_failures` (boolean): Should the user receive expectation failures and misses via email?
 * `require_login_by` (string): Require user to login by specified date otherwise it will be disabled.
 * `require_password_change` (boolean): Is a password change required upon next user login?
 * `restapi_permission` (boolean): Can this user access the Web app, Desktop app, SDKs, or REST API?  (All of these tools use the API internally, so this is one unified permission set.)
@@ -585,6 +633,14 @@ user.update(
   primary_group_id: 1,
   readonly_site_admin: true,
   receive_admin_alerts: true,
+  notify_on_all_site_warnings: true,
+  notify_on_all_sso_failures: true,
+  notify_on_all_user_security_events: true,
+  notify_on_all_pending_work_failures: true,
+  notify_on_all_siem_http_destination_failures: true,
+  notify_on_all_sync_failures: true,
+  notify_on_all_automation_failures: true,
+  notify_on_all_expectation_failures: true,
   require_login_by: "2000-01-01T01:00:00Z",
   require_password_change: true,
   restapi_permission: true,
@@ -646,7 +702,15 @@ user.update(
 * `password_validity_days` (int64): Number of days to allow user to use the same password
 * `primary_group_id` (int64): Primary group ID for Group Admin scoping
 * `readonly_site_admin` (boolean): Is the user an allowed to view all (non-billing) site configuration for this site?
-* `receive_admin_alerts` (boolean): Should the user receive admin alerts such a certificate expiration notifications and overages?
+* `receive_admin_alerts` (boolean): Deprecated. Use notify_on_all_site_warnings and granular failure notification preferences instead.
+* `notify_on_all_site_warnings` (boolean): Should the user receive site warnings via email?
+* `notify_on_all_sso_failures` (boolean): Should the user receive sso/scim/ldap configuration/sync failures via email?
+* `notify_on_all_user_security_events` (boolean): Should the user receive user security events via email?
+* `notify_on_all_pending_work_failures` (boolean): Should the user receive pending work failures via email?
+* `notify_on_all_siem_http_destination_failures` (boolean): Should the user receive siem failures via email?
+* `notify_on_all_sync_failures` (boolean): Should the user receive sync failures via email?
+* `notify_on_all_automation_failures` (boolean): Should the user receive automation failures via email?
+* `notify_on_all_expectation_failures` (boolean): Should the user receive expectation failures and misses via email?
 * `require_login_by` (string): Require user to login by specified date otherwise it will be disabled.
 * `require_password_change` (boolean): Is a password change required upon next user login?
 * `restapi_permission` (boolean): Can this user access the Web app, Desktop app, SDKs, or REST API?  (All of these tools use the API internally, so this is one unified permission set.)

data/docs/user_lifecycle_rule.md

@@ -17,6 +17,7 @@
   "include_site_admins": true,
   "apply_to_all_workspaces": true,
   "name": "password specific rules",
+  "notify_users": true,
   "partner_tag": "guest",
   "site_id": 1,
   "workspace_id": 12,
@@ -34,6 +35,7 @@
 * `include_site_admins` (boolean): If true, the rule will apply to site admins.
 * `apply_to_all_workspaces` (boolean): If true, a default-workspace rule also applies to users in all workspaces.
 * `name` (string): User Lifecycle Rule name
+* `notify_users` (boolean): If true, users will be emailed before the rule disables or deletes them.
 * `partner_tag` (string): If provided, only users belonging to Partners with this tag at the Partner level will be affected by the rule. Tags must only contain lowercase letters, numbers, and hyphens.
 * `site_id` (int64): Site ID
 * `workspace_id` (int64): Workspace ID. `0` means the default workspace.
@@ -83,6 +85,7 @@ Files::UserLifecycleRule.create(
   include_site_admins: true, 
   include_folder_admins: true, 
   name: "password specific rules", 
+  notify_users: true, 
   partner_tag: "guest", 
   user_state: "inactive", 
   user_tag: "guest", 
@@ -100,6 +103,7 @@ Files::UserLifecycleRule.create(
 * `include_site_admins` (boolean): If true, the rule will apply to site admins.
 * `include_folder_admins` (boolean): If true, the rule will apply to folder admins.
 * `name` (string): User Lifecycle Rule name
+* `notify_users` (boolean): If true, users will be emailed before the rule disables or deletes them.
 * `partner_tag` (string): If provided, only users belonging to Partners with this tag at the Partner level will be affected by the rule. Tags must only contain lowercase letters, numbers, and hyphens.
 * `user_state` (string): State of the users to apply the rule to (inactive or disabled)
 * `user_tag` (string): If provided, only users with this tag will be affected by the rule. Tags must only contain lowercase letters, numbers, and hyphens.
@@ -119,6 +123,7 @@ Files::UserLifecycleRule.update(id,
   include_site_admins: true, 
   include_folder_admins: true, 
   name: "password specific rules", 
+  notify_users: true, 
   partner_tag: "guest", 
   user_state: "inactive", 
   user_tag: "guest", 
@@ -137,6 +142,7 @@ Files::UserLifecycleRule.update(id,
 * `include_site_admins` (boolean): If true, the rule will apply to site admins.
 * `include_folder_admins` (boolean): If true, the rule will apply to folder admins.
 * `name` (string): User Lifecycle Rule name
+* `notify_users` (boolean): If true, users will be emailed before the rule disables or deletes them.
 * `partner_tag` (string): If provided, only users belonging to Partners with this tag at the Partner level will be affected by the rule. Tags must only contain lowercase letters, numbers, and hyphens.
 * `user_state` (string): State of the users to apply the rule to (inactive or disabled)
 * `user_tag` (string): If provided, only users with this tag will be affected by the rule. Tags must only contain lowercase letters, numbers, and hyphens.
@@ -171,6 +177,7 @@ user_lifecycle_rule.update(
   include_site_admins: true,
   include_folder_admins: true,
   name: "password specific rules",
+  notify_users: true,
   partner_tag: "guest",
   user_state: "inactive",
   user_tag: "guest",
@@ -189,6 +196,7 @@ user_lifecycle_rule.update(
 * `include_site_admins` (boolean): If true, the rule will apply to site admins.
 * `include_folder_admins` (boolean): If true, the rule will apply to folder admins.
 * `name` (string): User Lifecycle Rule name
+* `notify_users` (boolean): If true, users will be emailed before the rule disables or deletes them.
 * `partner_tag` (string): If provided, only users belonging to Partners with this tag at the Partner level will be affected by the rule. Tags must only contain lowercase letters, numbers, and hyphens.
 * `user_state` (string): State of the users to apply the rule to (inactive or disabled)
 * `user_tag` (string): If provided, only users with this tag will be affected by the rule. Tags must only contain lowercase letters, numbers, and hyphens.

data/docs/user_security_event.md

@@ -0,0 +1,58 @@
+# UserSecurityEvent
+
+## Example UserSecurityEvent Object
+
+```
+{
+  "id": 1,
+  "event_type": "example",
+  "body": "example",
+  "event_errors": [
+    "example"
+  ],
+  "created_at": "2000-01-01T01:00:00Z",
+  "body_url": "example",
+  "user_id": 1
+}
+```
+
+* `id` (int64): Event ID
+* `event_type` (string): Type of user security event being recorded.
+* `body` (string): Event body.
+* `event_errors` (array(string)): Event errors.
+* `created_at` (date-time): Event create date/time.
+* `body_url` (string): Link to log file.
+* `user_id` (int64): User ID.
+
+
+---
+
+## List User Security Events
+
+```
+Files::UserSecurityEvent.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: 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. Valid fields are `created_at` and `user_id`.
+* `filter` (object): If set, return records where the specified field is equal to the supplied value. Valid fields are `created_at` and `user_id`. Valid field combinations are `[ user_id, created_at ]`.
+* `filter_gt` (object): If set, return records where the specified field is greater than the supplied value. Valid fields are `created_at`.
+* `filter_gteq` (object): If set, return records where the specified field is greater than or equal the supplied value. Valid fields are `created_at`.
+* `filter_lt` (object): If set, return records where the specified field is less than the supplied value. Valid fields are `created_at`.
+* `filter_lteq` (object): If set, return records where the specified field is less than or equal the supplied value. Valid fields are `created_at`.
+
+
+---
+
+## Show User Security Event
+
+```
+Files::UserSecurityEvent.find(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - User Security Event ID.