Files.com 1.6.405__tar.gz → 1.6.406__tar.gz

{files_com-1.6.405/files_com.egg-info → files_com-1.6.406}/PKG-INFO

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

files_com-1.6.406/_VERSION

@@ -0,0 +1 @@
+1.6.406

{files_com-1.6.405 → files_com-1.6.406/files_com.egg-info}/PKG-INFO

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

{files_com-1.6.405 → files_com-1.6.406}/files_sdk/__init__.py

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

{files_com-1.6.405 → files_com-1.6.406}/files_sdk/models/ai_task.py

@@ -15,6 +15,7 @@ class AiTask:
         "name": None,  # string - AI Task name.
         "description": None,  # string - AI Task description.
         "prompt": None,  # string - Prompt sent when this AI Task is invoked.
+        "permission_set": None,  # string - Permissions used by the internal API key for this AI Task. Valid values are `full` and `files_only`.
         "path": None,  # string - Path scope used for action-triggered AI Tasks. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
         "source": None,  # string - Source glob used with `path` for action-triggered AI Tasks.
         "disabled": None,  # boolean - If true, this AI Task will not run.
@@ -81,6 +82,7 @@ class AiTask:
     #   interval - string - If trigger is `daily`, this specifies how often to run the AI Task.
     #   name - string - AI Task name.
     #   path - string - Path scope used for action-triggered AI Tasks.
+    #   permission_set - string - Permissions used by the internal API key for this AI Task. Valid values are `full` and `files_only`.
     #   prompt - string - Prompt sent when this AI Task is invoked.
     #   recurring_day - int64 - If trigger is `daily`, this selects the day number inside the chosen interval.
     #   schedule_days_of_week - array(int64) - If trigger is `custom_schedule`, the 0-based weekdays used by the schedule.
@@ -122,6 +124,12 @@ class AiTask:
             raise InvalidParameterError("Bad parameter: name must be an str")
         if "path" in params and not isinstance(params["path"], str):
             raise InvalidParameterError("Bad parameter: path must be an str")
+        if "permission_set" in params and not isinstance(
+            params["permission_set"], str
+        ):
+            raise InvalidParameterError(
+                "Bad parameter: permission_set must be an str"
+            )
         if "prompt" in params and not isinstance(params["prompt"], str):
             raise InvalidParameterError("Bad parameter: prompt must be an str")
         if "recurring_day" in params and not isinstance(
@@ -261,6 +269,7 @@ def get(id, params=None, options=None):
 #   interval - string - If trigger is `daily`, this specifies how often to run the AI Task.
 #   name (required) - string - AI Task name.
 #   path - string - Path scope used for action-triggered AI Tasks.
+#   permission_set - string - Permissions used by the internal API key for this AI Task. Valid values are `full` and `files_only`.
 #   prompt (required) - string - Prompt sent when this AI Task is invoked.
 #   recurring_day - int64 - If trigger is `daily`, this selects the day number inside the chosen interval.
 #   schedule_days_of_week - array(int64) - If trigger is `custom_schedule`, the 0-based weekdays used by the schedule.
@@ -293,6 +302,12 @@ def create(params=None, options=None):
         raise InvalidParameterError("Bad parameter: name must be an str")
     if "path" in params and not isinstance(params["path"], str):
         raise InvalidParameterError("Bad parameter: path must be an str")
+    if "permission_set" in params and not isinstance(
+        params["permission_set"], str
+    ):
+        raise InvalidParameterError(
+            "Bad parameter: permission_set must be an str"
+        )
     if "prompt" in params and not isinstance(params["prompt"], str):
         raise InvalidParameterError("Bad parameter: prompt must be an str")
     if "recurring_day" in params and not isinstance(
@@ -369,6 +384,7 @@ def manual_run(id, params=None, options=None):
 #   interval - string - If trigger is `daily`, this specifies how often to run the AI Task.
 #   name - string - AI Task name.
 #   path - string - Path scope used for action-triggered AI Tasks.
+#   permission_set - string - Permissions used by the internal API key for this AI Task. Valid values are `full` and `files_only`.
 #   prompt - string - Prompt sent when this AI Task is invoked.
 #   recurring_day - int64 - If trigger is `daily`, this selects the day number inside the chosen interval.
 #   schedule_days_of_week - array(int64) - If trigger is `custom_schedule`, the 0-based weekdays used by the schedule.
@@ -404,6 +420,12 @@ def update(id, params=None, options=None):
         raise InvalidParameterError("Bad parameter: name must be an str")
     if "path" in params and not isinstance(params["path"], str):
         raise InvalidParameterError("Bad parameter: path must be an str")
+    if "permission_set" in params and not isinstance(
+        params["permission_set"], str
+    ):
+        raise InvalidParameterError(
+            "Bad parameter: permission_set must be an str"
+        )
     if "prompt" in params and not isinstance(params["prompt"], str):
         raise InvalidParameterError("Bad parameter: prompt must be an str")
     if "recurring_day" in params and not isinstance(

{files_com-1.6.405 → files_com-1.6.406}/files_sdk/models/api_key.py

@@ -21,12 +21,13 @@ 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. It must be full for site-wide API Keys.  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. Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges.  If you have ideas for permission sets, please let us know.
+        "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 perform file operations as a full-access file user in the key's workspace scope, but cannot use site admin, workspace admin, folder admin, group admin, partner admin, or billing privileges from the owning user.
         "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
         "url": None,  # string - URL for API host.
         "user_id": None,  # int64 - User ID for the owner of this API Key.  May be blank for Site-wide API Keys.
+        "workspace_id": None,  # int64 - Workspace ID for this API Key. `0` means the default workspace.
         "path": None,  # string - Folder path restriction for `office_integration` permission set API keys.
     }
 
@@ -126,7 +127,7 @@ class ApiKey:
 #   user_id - int64 - User ID.  Provide a value of `0` to operate the current session's user.
 #   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 `site_id`.
+#   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `site_id` and `workspace_id`.
 #   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `aws_style_credentials` and `expires_at`.
 #   filter_gt - object - If set, return records where the specified field is greater than the supplied value. Valid fields are `expires_at`.
 #   filter_gteq - object - If set, return records where the specified field is greater than or equal the supplied value. Valid fields are `expires_at`.
@@ -204,7 +205,8 @@ 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 - Folder path restriction for `office_integration` permission set API keys.
-#   permission_set - string - Permissions for this API Key. It must be full for site-wide API Keys.  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. Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges.  If you have ideas for permission sets, please let us know.
+#   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 perform file operations as a full-access file user in the key's workspace scope, but cannot use site admin, workspace admin, folder admin, group admin, partner admin, or billing privileges from the owning user.
+#   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):
         params = {}
@@ -234,6 +236,12 @@ def create(params=None, options=None):
         raise InvalidParameterError(
             "Bad parameter: permission_set must be an str"
         )
+    if "workspace_id" in params and not isinstance(
+        params["workspace_id"], int
+    ):
+        raise InvalidParameterError(
+            "Bad parameter: workspace_id must be an int"
+        )
     if "name" not in params:
         raise MissingParameterError("Parameter missing: name")
     response, options = Api.send_request("POST", "/api_keys", params, options)
@@ -243,7 +251,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. It must be full for site-wide API Keys.  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. Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges.  If you have ideas for permission sets, please let us know.
+#   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 perform file operations as a full-access file user in the key's workspace scope, but cannot use site admin, workspace admin, folder admin, group admin, partner admin, or billing privileges from the owning user.
 def update_current(params=None, options=None):
     if not isinstance(params, dict):
         params = {}

{files_com-1.6.405 → files_com-1.6.406}/pyproject.toml

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

files_com-1.6.405/_VERSION

@@ -1 +0,0 @@
-1.6.405