unique_sdk 0.9.33__tar.gz → 0.9.35__tar.gz

{unique_sdk-0.9.33 → unique_sdk-0.9.35}/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), 
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.9.35] - 2025-06-18
+- Allow scope access updates (add/remove) on folder based on scope id or path.
+
+## [0.9.34] - 2025-06-17
+- Allow ingestion config updates on folder based on scope id or path.
+
 ## [0.9.33] - 2025-06-11
 - Add function to get a folder by id or by path.
 

{unique_sdk-0.9.33 → unique_sdk-0.9.35}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: unique_sdk
-Version: 0.9.33
+Version: 0.9.35
 Summary: 
 License: MIT
 Author: Martin Fadler
@@ -508,18 +508,35 @@ unique_sdk.Folder.create_paths(
 
 #### `unique_sdk.Folder.update_ingestion_config`
 
-Allows you to update the ingestion config of a folder and whether to apply to the subscopes or not: `
+Allows you to update the ingestion config of a folder and choose whether to apply to the subscopes or not: `
 
 - `ingestionConfig`
 - `applyToSubScopes`
 
-Example of updating the ingestion config of a folder and its subfolders.
+The update can be done by referencing the folder by id or by path. If none of them are provided. the API will return an error. If both of them are provided, the scope id will take precedence.
+
+Example of updating the ingestion config of a folder and its subfolders using the id.
+
+```python
+unique_sdk.Folder.update_ingestion_config(
+    user_id=user_id,
+    company_id=company_id,
+    scopeId="scope_qbnkde820dbmuw2900,
+    ingestionConfig={
+        "chunkStrategy": "default",
+        "uniqueIngestionMode": "standard",
+    },
+    applyToSubScopes=True
+)
+```
+
+Example of updating the ingestion config of a folder and its subfolders using the path.
 
 ```python
 unique_sdk.Folder.update_ingestion_config(
     user_id=user_id,
     company_id=company_id,
-    scope_id=scope_id,
+    folderPath="/Company/folder1/folder2",
     ingestionConfig={
         "chunkStrategy": "default",
         "uniqueIngestionMode": "standard",
@@ -535,13 +552,33 @@ Allows you to add access to a folder and apply to the subfolders or not: `
 - `scopeAccesses`
 - `applyToSubScopes`
 
-Example of adding access to a folder and its subfolders.
+The update can be done by referencing the folder by id or by path. If none of them are provided. the API will return an error. If both of them are provided, the scope id will take precedence.
+
+Example of adding access to a folder and its subfolders using the id.
+
+```python
+unique_sdk.Folder.add_access(
+    user_id=user_id,
+    company_id=company_id,
+    scopeId="scope_231e4kjn4foffww34",
+    scopeAccesses=[
+        {
+            "entityId": "group_id",
+            "type": "WRITE",
+            "entityType": "GROUP",
+        }
+    ],
+    applyToSubScopes=True,
+)
+```
+
+Example of adding access to a folder and its subfolders using the folder path.
 
 ```python
 unique_sdk.Folder.add_access(
     user_id=user_id,
     company_id=company_id,
-    scope_id=scope_id,
+    folderPath="/Company/folder1/folder2"
     scopeAccesses=[
         {
             "entityId": "group_id",
@@ -560,13 +597,35 @@ Allows you to delete access from a folder and apply to the subfolders or not: `
 - `scopeAccesses`
 - `applyToSubScopes`
 
-Example of deleting the access from a folder and its subfolders.
+The update can be done by referencing the folder by id or by path. If none of them are provided. the API will return an error. If both of them are provided, the scope id will take precedence.
+
+
+Example of deleting the access from a folder and its subfolders using the id.
+
+```python
+unique_sdk.Folder.remove_access(
+    user_id=user_id,
+    company_id=company_id,
+    scopeId="scope_dwekjnf3330woioppm,
+    scopeAccesses=[
+        {
+            "entityId": "group_id",
+            "type": "WRITE",
+            "entityType": "GROUP",
+        }
+    ],
+    applyToSubScopes=True,
+)
+```
+
+
+Example of deleting the access from a folder and its subfolders using the path.
 
 ```python
 unique_sdk.Folder.remove_access(
     user_id=user_id,
     company_id=company_id,
-    scope_id=scope_id,
+    folderPath="/Company/folder1/folder2"
     scopeAccesses=[
         {
             "entityId": "group_id",
@@ -1170,6 +1229,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), 
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.9.35] - 2025-06-18
+- Allow scope access updates (add/remove) on folder based on scope id or path.
+
+## [0.9.34] - 2025-06-17
+- Allow ingestion config updates on folder based on scope id or path.
+
 ## [0.9.33] - 2025-06-11
 - Add function to get a folder by id or by path.
 

{unique_sdk-0.9.33 → unique_sdk-0.9.35}/README.md

@@ -492,18 +492,35 @@ unique_sdk.Folder.create_paths(
 
 #### `unique_sdk.Folder.update_ingestion_config`
 
-Allows you to update the ingestion config of a folder and whether to apply to the subscopes or not: `
+Allows you to update the ingestion config of a folder and choose whether to apply to the subscopes or not: `
 
 - `ingestionConfig`
 - `applyToSubScopes`
 
-Example of updating the ingestion config of a folder and its subfolders.
+The update can be done by referencing the folder by id or by path. If none of them are provided. the API will return an error. If both of them are provided, the scope id will take precedence.
+
+Example of updating the ingestion config of a folder and its subfolders using the id.
 
 ```python
 unique_sdk.Folder.update_ingestion_config(
     user_id=user_id,
     company_id=company_id,
-    scope_id=scope_id,
+    scopeId="scope_qbnkde820dbmuw2900,
+    ingestionConfig={
+        "chunkStrategy": "default",
+        "uniqueIngestionMode": "standard",
+    },
+    applyToSubScopes=True
+)
+```
+
+Example of updating the ingestion config of a folder and its subfolders using the path.
+
+```python
+unique_sdk.Folder.update_ingestion_config(
+    user_id=user_id,
+    company_id=company_id,
+    folderPath="/Company/folder1/folder2",
     ingestionConfig={
         "chunkStrategy": "default",
         "uniqueIngestionMode": "standard",
@@ -519,13 +536,33 @@ Allows you to add access to a folder and apply to the subfolders or not: `
 - `scopeAccesses`
 - `applyToSubScopes`
 
-Example of adding access to a folder and its subfolders.
+The update can be done by referencing the folder by id or by path. If none of them are provided. the API will return an error. If both of them are provided, the scope id will take precedence.
+
+Example of adding access to a folder and its subfolders using the id.
+
+```python
+unique_sdk.Folder.add_access(
+    user_id=user_id,
+    company_id=company_id,
+    scopeId="scope_231e4kjn4foffww34",
+    scopeAccesses=[
+        {
+            "entityId": "group_id",
+            "type": "WRITE",
+            "entityType": "GROUP",
+        }
+    ],
+    applyToSubScopes=True,
+)
+```
+
+Example of adding access to a folder and its subfolders using the folder path.
 
 ```python
 unique_sdk.Folder.add_access(
     user_id=user_id,
     company_id=company_id,
-    scope_id=scope_id,
+    folderPath="/Company/folder1/folder2"
     scopeAccesses=[
         {
             "entityId": "group_id",
@@ -544,13 +581,35 @@ Allows you to delete access from a folder and apply to the subfolders or not: `
 - `scopeAccesses`
 - `applyToSubScopes`
 
-Example of deleting the access from a folder and its subfolders.
+The update can be done by referencing the folder by id or by path. If none of them are provided. the API will return an error. If both of them are provided, the scope id will take precedence.
+
+
+Example of deleting the access from a folder and its subfolders using the id.
+
+```python
+unique_sdk.Folder.remove_access(
+    user_id=user_id,
+    company_id=company_id,
+    scopeId="scope_dwekjnf3330woioppm,
+    scopeAccesses=[
+        {
+            "entityId": "group_id",
+            "type": "WRITE",
+            "entityType": "GROUP",
+        }
+    ],
+    applyToSubScopes=True,
+)
+```
+
+
+Example of deleting the access from a folder and its subfolders using the path.
 
 ```python
 unique_sdk.Folder.remove_access(
     user_id=user_id,
     company_id=company_id,
-    scope_id=scope_id,
+    folderPath="/Company/folder1/folder2"
     scopeAccesses=[
         {
             "entityId": "group_id",

{unique_sdk-0.9.33 → unique_sdk-0.9.35}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "unique_sdk"
-version = "0.9.33"
+version = "0.9.35"
 description = ""
 authors = [
     "Martin Fadler <martin.fadler@unique.ch>",

{unique_sdk-0.9.33 → unique_sdk-0.9.35}/unique_sdk/api_resources/_folder.py

@@ -101,6 +101,8 @@ class Folder(APIResource["Folder"]):
         Parameters for updating folder ingestion config.
         """
 
+        scopeId: str | None
+        folderPath: str | None
         ingestionConfig: "Folder.IngestionConfig"
         applyToSubScopes: bool
 
@@ -109,6 +111,8 @@ class Folder(APIResource["Folder"]):
         Parameters for adding access to a folder.
         """
 
+        scopeId: str | None
+        folderPath: str | None
         scopeAccesses: List["Folder.ScopeAccess"]
         applyToSubScopes: bool
 
@@ -117,6 +121,8 @@ class Folder(APIResource["Folder"]):
         Parameters for removing access from a folder.
         """
 
+        scopeId: str | None
+        folderPath: str | None
         scopeAccesses: List["Folder.ScopeAccess"]
         applyToSubScopes: bool
 
@@ -199,7 +205,6 @@ class Folder(APIResource["Folder"]):
         cls,
         user_id: str,
         company_id: str,
-        scope_id: str,
         **params: Unpack["Folder.UpdateIngestionConfigParams"],
     ) -> "Folder":
         """
@@ -209,7 +214,7 @@ class Folder(APIResource["Folder"]):
             "Folder",
             cls._static_request(
                 "patch",
-                f"/folder/{scope_id}/ingestion-config",
+                "/folder/ingestion-config",
                 user_id,
                 company_id,
                 params=params,
@@ -221,7 +226,6 @@ class Folder(APIResource["Folder"]):
         cls,
         user_id: str,
         company_id: str,
-        scope_id: str,
         **params: Unpack["Folder.UpdateIngestionConfigParams"],
     ) -> "Folder":
         """
@@ -231,7 +235,7 @@ class Folder(APIResource["Folder"]):
             "Folder",
             await cls._static_request_async(
                 "patch",
-                f"/folder/{scope_id}/ingestion-config",
+                "/folder/ingestion-config",
                 user_id,
                 company_id,
                 params=params,
@@ -243,7 +247,6 @@ class Folder(APIResource["Folder"]):
         cls,
         user_id: str,
         company_id: str,
-        scope_id: str,
         **params: Unpack["Folder.AddAccessParams"],
     ) -> "Folder":
         """
@@ -253,7 +256,7 @@ class Folder(APIResource["Folder"]):
             "Folder",
             cls._static_request(
                 "patch",
-                f"/folder/{scope_id}/access",
+                "/folder/add-access",
                 user_id,
                 company_id,
                 params=params,
@@ -265,7 +268,6 @@ class Folder(APIResource["Folder"]):
         cls,
         user_id: str,
         company_id: str,
-        scope_id: str,
         **params: Unpack["Folder.AddAccessParams"],
     ) -> "Folder":
         """
@@ -275,7 +277,7 @@ class Folder(APIResource["Folder"]):
             "Folder",
             await cls._static_request_async(
                 "patch",
-                f"/folder/{scope_id}/access",
+                "/folder/add-access",
                 user_id,
                 company_id,
                 params=params,
@@ -287,7 +289,6 @@ class Folder(APIResource["Folder"]):
         cls,
         user_id: str,
         company_id: str,
-        scope_id: str,
         **params: Unpack["Folder.RemoveAccessParams"],
     ) -> dict:
         """
@@ -297,7 +298,7 @@ class Folder(APIResource["Folder"]):
             dict,
             cls._static_request(
                 "patch",
-                f"/folder/{scope_id}/remove-access",
+                "/folder/remove-access",
                 user_id,
                 company_id,
                 params=params,
@@ -309,7 +310,6 @@ class Folder(APIResource["Folder"]):
         cls,
         user_id: str,
         company_id: str,
-        scope_id: str,
         **params: Unpack["Folder.RemoveAccessParams"],
     ) -> "Folder":
         """
@@ -319,7 +319,7 @@ class Folder(APIResource["Folder"]):
             "Folder",
             await cls._static_request_async(
                 "patch",
-                f"/folder/{scope_id}/remove-access",
+                "/folder/remove-access",
                 user_id,
                 company_id,
                 params=params,