Files.com 1.6.523__tar.gz → 1.6.525__tar.gz

{files_com-1.6.523/files_com.egg-info → files_com-1.6.525}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: files_com
-Version: 1.6.523
+Version: 1.6.525
 Summary: Python bindings for the Files.com API
 License: MIT
 Requires-Python: >=3.5

files_com-1.6.525/_VERSION

@@ -0,0 +1 @@
+1.6.525

{files_com-1.6.523 → files_com-1.6.525/files_com.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: files_com
-Version: 1.6.523
+Version: 1.6.525
 Summary: Python bindings for the Files.com API
 License: MIT
 Requires-Python: >=3.5

{files_com-1.6.523 → files_com-1.6.525}/files_sdk/__init__.py

@@ -320,7 +320,7 @@ source_ip = None
 workspace_id = None
 base_url = "https://app.files.com"
 base_path = "api/rest/v1"
-version = "1.6.523"
+version = "1.6.525"
 
 __version__ = version
 

{files_com-1.6.523 → files_com-1.6.525}/files_sdk/models/api_key.py

@@ -22,7 +22,7 @@ class ApiKey:
         "aws_secret_key": None,  # string - AWS Secret Key to use with AWS-compatible endpoints, such as our Inbound S3-compatible endpoint.
         "last_use_at": None,  # date-time - API Key last used - note this value is only updated once per 3 hour period, so the 'actual' time of last use may be up to 3 hours later than this timestamp.
         "name": None,  # string - Internal name for the API Key.  For your use.
-        "permission_set": None,  # string - Permissions for this API Key. Keys with the `desktop_app` permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Keys with the `office_integration` permission set are auto generated, and automatically expire, to allow users to interact with office integration platforms. Keys with the `files_only` permission set can use only the files, folders, and file_actions endpoints, where they perform file operations as a full-access file user in the key's workspace scope, along with `GET /file_migrations/{id}` and `GET /api_key`. On the migration lookup, any key with a `path` can read only migrations it started. Without a `path`, user-owned keys retain user-scoped access; site-wide Workspace-bound keys can read only migrations whose source and destination are both in their Workspace. Every `files_only` key is Workspace-bound, including Workspace `0`, as is a full-access key in a named Workspace. A full-access site-wide key in the default Workspace retains Site-wide migration access. Migrations outside the caller's visibility return `not-found`. Keys with `files_only` cannot use site admin, workspace admin, folder admin, group admin, partner admin, or billing privileges from the owning user, and every other endpoint denies them with `not-authorized/api-key-only-for-file-operations`.
+        "permission_set": None,  # string - Permissions for this API Key. Keys with the `desktop_app` permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Keys with the `office_integration` permission set are auto generated, and automatically expire, to allow users to interact with office integration platforms. Keys with the `files_only` permission set can use only the files, folders, and file_actions endpoints, excluding the GPG Encrypt and GPG Decrypt file actions, where they perform file operations as a full-access file user in the key's workspace scope, along with `GET /file_migrations/{id}` and `GET /api_key`. On the migration lookup, any key with a `path` can read only migrations it started. Without a `path`, user-owned keys retain user-scoped access; site-wide Workspace-bound keys can read only migrations whose source and destination are both in their Workspace. Every `files_only` key is Workspace-bound, including Workspace `0`, as is a full-access key in a named Workspace. A full-access site-wide key in the default Workspace retains Site-wide migration access. Migrations outside the caller's visibility return `not-found`. Keys with `files_only` cannot use site admin, workspace admin, folder admin, group admin, partner admin, or billing privileges from the owning user. Both GPG file actions and every other endpoint deny them with `not-authorized/api-key-only-for-file-operations`. Folder-configured GPG encryption and decryption still apply to files uploaded with a `files_only` key.
         "platform": None,  # string - If this API key represents a Desktop app, what platform was it created on?
         "site_id": None,  # int64 - Site ID
         "site_name": None,  # string - Site Name
@@ -209,7 +209,7 @@ def get(id, params=None, options=None):
 #   name (required) - string - Internal name for the API Key.  For your use.
 #   aws_style_credentials - boolean - If `true`, this API key will be usable with AWS-compatible endpoints, such as our Inbound S3-compatible endpoint.
 #   path - string - Restricts the file and folder operations made with this key, meaning the files, folders, and file_actions endpoints, to the specified folder and its descendants, including copy and move destinations. For `GET /file_migrations/{id}`, a key with a path can read only migrations it started. Other endpoints do not apply the path restriction; use the `files_only` permission set to confine a key to file operations and their supporting lookups. Does not grant access beyond the owning user's permissions. Optional except for `office_integration` keys, which require a path the owning user can read.
-#   permission_set - string - Permissions for this API Key. Keys with the `desktop_app` permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Keys with the `office_integration` permission set are auto generated, and automatically expire, to allow users to interact with office integration platforms. Keys with the `files_only` permission set can use only the files, folders, and file_actions endpoints, where they perform file operations as a full-access file user in the key's workspace scope, along with `GET /file_migrations/{id}` and `GET /api_key`. On the migration lookup, any key with a `path` can read only migrations it started. Without a `path`, user-owned keys retain user-scoped access; site-wide Workspace-bound keys can read only migrations whose source and destination are both in their Workspace. Every `files_only` key is Workspace-bound, including Workspace `0`, as is a full-access key in a named Workspace. A full-access site-wide key in the default Workspace retains Site-wide migration access. Migrations outside the caller's visibility return `not-found`. Keys with `files_only` cannot use site admin, workspace admin, folder admin, group admin, partner admin, or billing privileges from the owning user, and every other endpoint denies them with `not-authorized/api-key-only-for-file-operations`.
+#   permission_set - string - Permissions for this API Key. Keys with the `desktop_app` permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Keys with the `office_integration` permission set are auto generated, and automatically expire, to allow users to interact with office integration platforms. Keys with the `files_only` permission set can use only the files, folders, and file_actions endpoints, excluding the GPG Encrypt and GPG Decrypt file actions, where they perform file operations as a full-access file user in the key's workspace scope, along with `GET /file_migrations/{id}` and `GET /api_key`. On the migration lookup, any key with a `path` can read only migrations it started. Without a `path`, user-owned keys retain user-scoped access; site-wide Workspace-bound keys can read only migrations whose source and destination are both in their Workspace. Every `files_only` key is Workspace-bound, including Workspace `0`, as is a full-access key in a named Workspace. A full-access site-wide key in the default Workspace retains Site-wide migration access. Migrations outside the caller's visibility return `not-found`. Keys with `files_only` cannot use site admin, workspace admin, folder admin, group admin, partner admin, or billing privileges from the owning user. Both GPG file actions and every other endpoint deny them with `not-authorized/api-key-only-for-file-operations`. Folder-configured GPG encryption and decryption still apply to files uploaded with a `files_only` key.
 #   workspace_id - int64 - Workspace ID for this API Key. `0` means the default workspace.
 def create(params=None, options=None):
     if not isinstance(params, dict):
@@ -255,7 +255,7 @@ def create(params=None, options=None):
 # Parameters:
 #   expires_at - string - API Key expiration date
 #   name - string - Internal name for the API Key.  For your use.
-#   permission_set - string - Permissions for this API Key. Keys with the `desktop_app` permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Keys with the `office_integration` permission set are auto generated, and automatically expire, to allow users to interact with office integration platforms. Keys with the `files_only` permission set can use only the files, folders, and file_actions endpoints, where they perform file operations as a full-access file user in the key's workspace scope, along with `GET /file_migrations/{id}` and `GET /api_key`. On the migration lookup, any key with a `path` can read only migrations it started. Without a `path`, user-owned keys retain user-scoped access; site-wide Workspace-bound keys can read only migrations whose source and destination are both in their Workspace. Every `files_only` key is Workspace-bound, including Workspace `0`, as is a full-access key in a named Workspace. A full-access site-wide key in the default Workspace retains Site-wide migration access. Migrations outside the caller's visibility return `not-found`. Keys with `files_only` cannot use site admin, workspace admin, folder admin, group admin, partner admin, or billing privileges from the owning user, and every other endpoint denies them with `not-authorized/api-key-only-for-file-operations`.
+#   permission_set - string - Permissions for this API Key. Keys with the `desktop_app` permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Keys with the `office_integration` permission set are auto generated, and automatically expire, to allow users to interact with office integration platforms. Keys with the `files_only` permission set can use only the files, folders, and file_actions endpoints, excluding the GPG Encrypt and GPG Decrypt file actions, where they perform file operations as a full-access file user in the key's workspace scope, along with `GET /file_migrations/{id}` and `GET /api_key`. On the migration lookup, any key with a `path` can read only migrations it started. Without a `path`, user-owned keys retain user-scoped access; site-wide Workspace-bound keys can read only migrations whose source and destination are both in their Workspace. Every `files_only` key is Workspace-bound, including Workspace `0`, as is a full-access key in a named Workspace. A full-access site-wide key in the default Workspace retains Site-wide migration access. Migrations outside the caller's visibility return `not-found`. Keys with `files_only` cannot use site admin, workspace admin, folder admin, group admin, partner admin, or billing privileges from the owning user. Both GPG file actions and every other endpoint deny them with `not-authorized/api-key-only-for-file-operations`. Folder-configured GPG encryption and decryption still apply to files uploaded with a `files_only` key.
 def update_current(params=None, options=None):
     if not isinstance(params, dict):
         params = {}

{files_com-1.6.523 → files_com-1.6.525}/files_sdk/models/child_site_management_policy.py

@@ -15,7 +15,7 @@ class ChildSiteManagementPolicy:
         "policy_type": None,  # string - Type of policy.  Valid values: `settings`.
         "name": None,  # string - Name for this policy.
         "description": None,  # string - Description for this policy.
-        "value": None,  # object - Policy configuration data. Settings policies accept site settings plus an optional `folder_behaviors` array for parent-managed root behaviors on child sites. For more information, refer to the Value Hash section of the developer documentation.
+        "value": None,  # object - Policy configuration data. On a Child Site, contains only managed setting names with null values. Settings policies accept site settings plus an optional `folder_behaviors` array for parent-managed root behaviors on child sites. For more information, refer to the Value Hash section of the developer documentation.
         "applied_child_site_ids": None,  # array(int64) - IDs of child sites that this policy has been applied to. This field is read-only.
         "skip_child_site_ids": None,  # array(int64) - IDs of child sites excluded from this default policy.
         "child_site_ids": None,  # array(int64) - IDs of child sites explicitly assigned to this non-default policy.

{files_com-1.6.523 → files_com-1.6.525}/files_sdk/models/event_delivery_attempt.py

@@ -15,6 +15,7 @@ class EventDeliveryAttempt:
         "event_record_id": None,  # int64 - Event Record ID
         "event_subscription_id": None,  # int64 - Event Subscription ID
         "event_target_id": None,  # int64 - Event Target ID
+        "activity_notification_batch_id": None,  # int64 - Shared summary ID when this event is delivered in a Slack or Teams subfolder summary. All events in a summary share its delivery outcome.
         "workspace_id": None,  # int64 - Workspace ID. 0 means the default workspace or site-wide.
         "status": None,  # string - Delivery status.
         "attempt_number": None,  # int64 - Number of delivery attempts made.

{files_com-1.6.523 → files_com-1.6.525}/files_sdk/models/event_target.py

@@ -18,7 +18,7 @@ class EventTarget:
         "apply_to_all_workspaces": None,  # boolean - If true, this default-workspace target can receive events from all workspaces.
         "enabled": None,  # boolean - Whether this Event Target can receive events.
         "config": None,  # object - Event Target configuration. Folder targets accept path and format (json or csv).
-        "delivery_policy": None,  # object - Event Target delivery policy. Email and folder targets support batch_interval in seconds, between 600 and 86400.
+        "delivery_policy": None,  # object - Event Target delivery policy. Email and folder targets support batch_interval in seconds, between 600 and 86400. Slack and Teams support delivery_mode (immediate or subfolder_summary), summary_path (empty string means root), and summary_delay (15–300 seconds, default 60). The summary applies to matching file activity under summary_path; other matching events retain immediate delivery.
         "created_at": None,  # date-time - Event Target create date/time.
         "updated_at": None,  # date-time - Event Target update date/time.
     }
@@ -50,7 +50,7 @@ class EventTarget:
     #   apply_to_all_workspaces - boolean - If true, this default-workspace target can receive events from all workspaces.
     #   enabled - boolean - Whether this Event Target can receive events.
     #   config - object - Event Target configuration. Folder targets accept path and format (json or csv).
-    #   delivery_policy - object - Event Target delivery policy. Email and folder targets support batch_interval in seconds, between 600 and 86400.
+    #   delivery_policy - object - Event Target delivery policy. Email and folder targets support batch_interval in seconds, between 600 and 86400. Slack and Teams support delivery_mode (immediate or subfolder_summary), summary_path (empty string means root), and summary_delay (15–300 seconds, default 60). The summary applies to matching file activity under summary_path; other matching events retain immediate delivery.
     def update(self, params=None):
         if not isinstance(params, dict):
             params = {}
@@ -168,7 +168,7 @@ def get(id, params=None, options=None):
 #   apply_to_all_workspaces - boolean - If true, this default-workspace target can receive events from all workspaces.
 #   enabled - boolean - Whether this Event Target can receive events.
 #   config (required) - object - Event Target configuration. Folder targets accept path and format (json or csv).
-#   delivery_policy - object - Event Target delivery policy. Email and folder targets support batch_interval in seconds, between 600 and 86400.
+#   delivery_policy - object - Event Target delivery policy. Email and folder targets support batch_interval in seconds, between 600 and 86400. Slack and Teams support delivery_mode (immediate or subfolder_summary), summary_path (empty string means root), and summary_delay (15–300 seconds, default 60). The summary applies to matching file activity under summary_path; other matching events retain immediate delivery.
 #   target_type (required) - string - Event Target type.
 def create(params=None, options=None):
     if not isinstance(params, dict):
@@ -221,7 +221,7 @@ def create(params=None, options=None):
 #   apply_to_all_workspaces - boolean - If true, this default-workspace target can receive events from all workspaces.
 #   enabled - boolean - Whether this Event Target can receive events.
 #   config - object - Event Target configuration. Folder targets accept path and format (json or csv).
-#   delivery_policy - object - Event Target delivery policy. Email and folder targets support batch_interval in seconds, between 600 and 86400.
+#   delivery_policy - object - Event Target delivery policy. Email and folder targets support batch_interval in seconds, between 600 and 86400. Slack and Teams support delivery_mode (immediate or subfolder_summary), summary_path (empty string means root), and summary_delay (15–300 seconds, default 60). The summary applies to matching file activity under summary_path; other matching events retain immediate delivery.
 def update(id, params=None, options=None):
     if not isinstance(params, dict):
         params = {}

{files_com-1.6.523 → files_com-1.6.525}/files_sdk/models/form_field_set.py

@@ -13,6 +13,7 @@ class FormFieldSet:
     default_attributes = {
         "id": None,  # int64 - Form field set id
         "title": None,  # string - Title to be displayed
+        "require_complete_metadata_capture": None,  # boolean - Reject answers over 1024 characters or more than 32 answered custom fields to ensure complete file metadata capture
         "form_layout": None,  # array(int64) - Layout of the form
         "form_fields": None,  # array(object) - Associated form field definitions; authenticated form field set responses include historical definitions, while form_layout identifies current fields
         "skip_name": None,  # boolean - Any associated InboxRegistrations or BundleRegistrations can be saved without providing name
@@ -49,6 +50,7 @@ class FormFieldSet:
 
     # Parameters:
     #   title - string - Title to be displayed
+    #   require_complete_metadata_capture - boolean - Reject answers over 1024 characters or more than 32 answered custom fields to ensure complete file metadata capture
     #   workspace_id - int64 - Workspace ID
     #   skip_email - boolean - Skip validating form email
     #   skip_name - boolean - Skip validating form name
@@ -175,6 +177,7 @@ def get(id, params=None, options=None):
 # Parameters:
 #   user_id - int64 - User ID.  Provide a value of `0` to operate the current session's user.
 #   title - string - Title to be displayed
+#   require_complete_metadata_capture - boolean - Reject answers over 1024 characters or more than 32 answered custom fields to ensure complete file metadata capture
 #   workspace_id - int64 - Workspace ID
 #   skip_email - boolean - Skip validating form email
 #   skip_name - boolean - Skip validating form name
@@ -189,6 +192,12 @@ def create(params=None, options=None):
         raise InvalidParameterError("Bad parameter: user_id must be an int")
     if "title" in params and not isinstance(params["title"], str):
         raise InvalidParameterError("Bad parameter: title must be an str")
+    if "require_complete_metadata_capture" in params and not isinstance(
+        params["require_complete_metadata_capture"], bool
+    ):
+        raise InvalidParameterError(
+            "Bad parameter: require_complete_metadata_capture must be an bool"
+        )
     if "workspace_id" in params and not isinstance(
         params["workspace_id"], int
     ):
@@ -221,6 +230,7 @@ def create(params=None, options=None):
 
 # Parameters:
 #   title - string - Title to be displayed
+#   require_complete_metadata_capture - boolean - Reject answers over 1024 characters or more than 32 answered custom fields to ensure complete file metadata capture
 #   workspace_id - int64 - Workspace ID
 #   skip_email - boolean - Skip validating form email
 #   skip_name - boolean - Skip validating form name
@@ -236,6 +246,12 @@ def update(id, params=None, options=None):
         raise InvalidParameterError("Bad parameter: id must be an int")
     if "title" in params and not isinstance(params["title"], str):
         raise InvalidParameterError("Bad parameter: title must be an str")
+    if "require_complete_metadata_capture" in params and not isinstance(
+        params["require_complete_metadata_capture"], bool
+    ):
+        raise InvalidParameterError(
+            "Bad parameter: require_complete_metadata_capture must be an bool"
+        )
     if "workspace_id" in params and not isinstance(
         params["workspace_id"], int
     ):

{files_com-1.6.523 → files_com-1.6.525}/files_sdk/models/site.py

@@ -85,6 +85,7 @@ class Site:
         "disable_all_ai_features": None,  # boolean - If true, all AI features are disabled for this site.
         "disable_files_certificate_generation": None,  # boolean - If set, Files.com will not set the CAA records required to generate future SSL certificates for this domain.
         "disable_notifications": None,  # boolean - Are notifications disabled?
+        "file_activity_events_enabled": None,  # boolean - If true, file operations produce file_action.activity.v1 EventChannel events in all workspaces. Defaults to false; subscription filters and workspace access still control delivery.
         "disable_password_reset": None,  # boolean - Is password reset disabled?
         "domain": None,  # string - Custom domain
         "domain_hsts_header": None,  # boolean - Send HSTS (HTTP Strict Transport Security) header when visitors access the site via a custom domain?
@@ -134,7 +135,7 @@ class Site:
         "logo": None,  # Image - Branded logo
         "login_page_background_image": None,  # Image - Branded login page background
         "max_prior_passwords": None,  # int64 - Number of prior passwords to disallow
-        "managed_site_settings": None,  # object - List of site settings managed by the parent site
+        "managed_site_settings": None,  # object - Site settings managed by the parent site. Each key identifies a managed setting, with a null value. Non-secret effective values are returned in their own Site settings fields.
         "motd_text": None,  # string - A message to show users when they connect via FTP or SFTP.
         "motd_use_for_ftp": None,  # boolean - Show message to users connecting via FTP
         "motd_use_for_sftp": None,  # boolean - Show message to users connecting via SFTP
@@ -314,6 +315,7 @@ def get_usage(params=None, options=None):
 #   legacy_checksums_mode - boolean - Use legacy checksums mode?
 #   migrate_remote_server_sync_to_sync - boolean - If true, we will migrate all remote server syncs to the new Sync model.
 #   as2_message_retention_days - int64 - Number of days to retain AS2 messages (incoming and outgoing).
+#   file_activity_events_enabled - boolean - If true, file operations produce file_action.activity.v1 EventChannel events in all workspaces. Defaults to false; subscription filters and workspace access still control delivery.
 #   username_display - string - How usernames are displayed in the web UI. Can be `username_only`, `full_name_only`, `full_name_username`, `full_name_company`, or `full_name_username_company`.
 #   session_expiry_minutes - int64 - Session expiry in minutes
 #   ssl_required - boolean - Is SSL required?  Disabling this is insecure.
@@ -724,6 +726,12 @@ def update(params=None, options=None):
         raise InvalidParameterError(
             "Bad parameter: as2_message_retention_days must be an int"
         )
+    if "file_activity_events_enabled" in params and not isinstance(
+        params["file_activity_events_enabled"], bool
+    ):
+        raise InvalidParameterError(
+            "Bad parameter: file_activity_events_enabled must be an bool"
+        )
     if "username_display" in params and not isinstance(
         params["username_display"], str
     ):

{files_com-1.6.523 → files_com-1.6.525}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "files_com"
-version = "1.6.523"
+version = "1.6.525"
 description = "Python bindings for the Files.com API"
 readme = "README.md"
 license = { text = "MIT" }

files_com-1.6.523/_VERSION

@@ -1 +0,0 @@
-1.6.523