unique_sdk 0.10.15__tar.gz → 0.10.16__tar.gz

{unique_sdk-0.10.15 → unique_sdk-0.10.16}/CHANGELOG.md

@@ -5,6 +5,9 @@ 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.10.16] - 2025-08-31
+- Add function to delete a content.
+
 ## [0.10.15] - 2025-08-28
 - Add default values for message log types
 

{unique_sdk-0.10.15 → unique_sdk-0.10.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: unique_sdk
-Version: 0.10.15
+Version: 0.10.16
 Summary: 
 License: MIT
 Author: Martin Fadler
@@ -554,6 +554,35 @@ Allows you to ingest a magic table sheet, each row is processed and converted in
     unique_sdk.Content.ingest_magic_table_sheets(**params)
 ```
 
+#### `unique_sdk.Content.delete` (Compatible with release >.36)
+
+Allows you to delete a file by its `contentId` or by its `filePath`. When deleting by `id`, if the file is part of a chat, the `chatId` also needs do be set. If both `contentId` and `filePath` are provided, `filePath` is ignored.
+
+- `contentId` optional if `filePath` is provided, the id of the file to be deleted
+- `chatId` optional, the id of the chat where the file is. Only needed if the file is part of a chat
+- `filePath` optional if `contentId` is provided, the absolute path of the file to be deleted
+
+Example of deleting a file from a chat.
+
+```python
+unique_sdk.Content.delete(
+    user_id=user_id,
+    company_id=company_id,
+    contentId="cont_ok2343q5owbce80w78hudawu5",
+    chatId="chat_v3xfa7liv876h89vuiibus1"
+)
+```
+
+Example of deleting a file by its path.
+
+```python
+unique_sdk.Content.delete(
+    user_id=user_id,
+    company_id=company_id,
+    filePath="/Company/finance/january.xls",
+)
+```
+
 ### Message
 
 #### `unique_sdk.Message.list`
@@ -1516,6 +1545,9 @@ 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.10.16] - 2025-08-31
+- Add function to delete a content.
+
 ## [0.10.15] - 2025-08-28
 - Add default values for message log types
 

{unique_sdk-0.10.15 → unique_sdk-0.10.16}/README.md

@@ -538,6 +538,35 @@ Allows you to ingest a magic table sheet, each row is processed and converted in
     unique_sdk.Content.ingest_magic_table_sheets(**params)
 ```
 
+#### `unique_sdk.Content.delete` (Compatible with release >.36)
+
+Allows you to delete a file by its `contentId` or by its `filePath`. When deleting by `id`, if the file is part of a chat, the `chatId` also needs do be set. If both `contentId` and `filePath` are provided, `filePath` is ignored.
+
+- `contentId` optional if `filePath` is provided, the id of the file to be deleted
+- `chatId` optional, the id of the chat where the file is. Only needed if the file is part of a chat
+- `filePath` optional if `contentId` is provided, the absolute path of the file to be deleted
+
+Example of deleting a file from a chat.
+
+```python
+unique_sdk.Content.delete(
+    user_id=user_id,
+    company_id=company_id,
+    contentId="cont_ok2343q5owbce80w78hudawu5",
+    chatId="chat_v3xfa7liv876h89vuiibus1"
+)
+```
+
+Example of deleting a file by its path.
+
+```python
+unique_sdk.Content.delete(
+    user_id=user_id,
+    company_id=company_id,
+    filePath="/Company/finance/january.xls",
+)
+```
+
 ### Message
 
 #### `unique_sdk.Message.list`

{unique_sdk-0.10.15 → unique_sdk-0.10.16}/pyproject.toml

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

{unique_sdk-0.10.15 → unique_sdk-0.10.16}/unique_sdk/api_resources/_content.py

@@ -1,5 +1,14 @@
 from enum import Enum
-from typing import Any, ClassVar, Dict, List, Literal, Optional, TypedDict, cast
+from typing import (
+    Any,
+    ClassVar,
+    Dict,
+    List,
+    Literal,
+    Optional,
+    TypedDict,
+    cast,
+)
 
 from typing_extensions import NotRequired, Unpack
 
@@ -75,6 +84,7 @@ class Content(APIResource["Content"]):
         metadataFilter: dict
         skip: NotRequired[int]
         take: NotRequired[int]
+        filePath: NotRequired[str]
 
     class CustomApiOptions(TypedDict):
         apiIdentifier: str
@@ -148,6 +158,14 @@ class Content(APIResource["Content"]):
         contentInfos: List["Content.ContentInfo"]
         totalCount: int
 
+    class DeleteParams(RequestOptions):
+        contentId: NotRequired[str]
+        filePath: NotRequired[str]
+        chatId: NotRequired[str]
+
+    class DeleteResponse(TypedDict):
+        id: str
+
     id: str
     key: str
     url: Optional[str]
@@ -372,3 +390,93 @@ class Content(APIResource["Content"]):
                 params=params,
             ),
         )
+
+    @classmethod
+    def delete(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: "Content.DeleteParams",
+    ) -> "Content.DeleteResponse":
+        """
+        Deletes a content by its id or file path.
+        """
+        content_id = cls.resolve_content_id_from_file_path(
+            user_id,
+            company_id,
+            params.get("contentId"),
+            params.get("filePath"),
+        )
+        params.pop("contentId", None)
+        params.pop("filePath", None)
+
+        return cast(
+            "Content.DeleteResponse",
+            cls._static_request(
+                "delete",
+                f"/content/{content_id}",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def delete_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: "Content.DeleteParams",
+    ) -> "Content.DeleteResponse":
+        """
+        Async deletes a content by its id or file path.
+        """
+        content_id = cls.resolve_content_id_from_file_path(
+            user_id,
+            company_id,
+            params.get("contentId"),
+            params.get("filePath"),
+        )
+        params.pop("contentId", None)
+        params.pop("filePath", None)
+
+        return cast(
+            "Content.DeleteResponse",
+            await cls._static_request_async(
+                "delete",
+                f"/content/{content_id}",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    def resolve_content_id_from_file_path(
+        cls,
+        user_id: str,
+        company_id: str,
+        content_id: str | None = None,
+        file_path: str | None = None,
+    ) -> str:
+        """
+        Returns the contentId to use: if content_id is provided, returns it;
+        if not, but file_path is provided, resolves and returns the id for that file path.
+        """
+        if content_id:
+            return content_id
+        if file_path:
+            file_info = cls.get_info(
+                user_id=user_id,
+                company_id=company_id,
+                filePath=file_path,
+            )
+            resolved_id = (
+                file_info.get("contentInfo")[0].get("id")
+                if file_info.get("totalCount", 0) > 0
+                else None
+            )
+            if not resolved_id:
+                raise ValueError(f"Could not find file with filePath: {file_path}")
+            return resolved_id
+        return None