athena-intelligence 0.1.261__py3-none-any.whl → 0.1.263__py3-none-any.whl

athena/__init__.py

@@ -32,6 +32,7 @@ if typing.TYPE_CHECKING:
         ConversationMessage,
         ConversationResult,
         CreateNewSheetTabResponse,
+        CreateProjectResponseOut,
         CustomAgentResponse,
         DataFrameRequestOut,
         DataFrameRequestOutColumnsItem,
@@ -41,6 +42,7 @@ if typing.TYPE_CHECKING:
         DimensionProperties,
         DocumentChunk,
         DriveAgentResponse,
+        EditProjectResponseOut,
         FileChunkRequestOut,
         FileTooLargeError,
         FolderResponse,
@@ -125,6 +127,7 @@ _dynamic_imports: typing.Dict[str, str] = {
     "ConversationMessage": ".types",
     "ConversationResult": ".types",
     "CreateNewSheetTabResponse": ".types",
+    "CreateProjectResponseOut": ".types",
     "CustomAgentResponse": ".types",
     "DataFrameRequestOut": ".types",
     "DataFrameRequestOutColumnsItem": ".types",
@@ -134,6 +137,7 @@ _dynamic_imports: typing.Dict[str, str] = {
     "DimensionProperties": ".types",
     "DocumentChunk": ".types",
     "DriveAgentResponse": ".types",
+    "EditProjectResponseOut": ".types",
     "FileChunkRequestOut": ".types",
     "FileTooLargeError": ".types",
     "FolderResponse": ".types",
@@ -240,6 +244,7 @@ __all__ = [
     "ConversationMessage",
     "ConversationResult",
     "CreateNewSheetTabResponse",
+    "CreateProjectResponseOut",
     "CustomAgentResponse",
     "DataFrameRequestOut",
     "DataFrameRequestOutColumnsItem",
@@ -249,6 +254,7 @@ __all__ = [
     "DimensionProperties",
     "DocumentChunk",
     "DriveAgentResponse",
+    "EditProjectResponseOut",
     "FileChunkRequestOut",
     "FileTooLargeError",
     "FolderResponse",

athena/assets/client.py

@@ -4,10 +4,15 @@ import typing
 
 from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ..core.request_options import RequestOptions
+from ..types.create_project_response_out import CreateProjectResponseOut
+from ..types.edit_project_response_out import EditProjectResponseOut
 from ..types.paginated_assets_out import PaginatedAssetsOut
 from ..types.public_asset_out import PublicAssetOut
 from .raw_client import AsyncRawAssetsClient, RawAssetsClient
 
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
 
 class AssetsClient:
     def __init__(self, *, client_wrapper: SyncClientWrapper):
@@ -77,6 +82,142 @@ class AssetsClient:
         )
         return _response.data
 
+    def create_project(
+        self,
+        *,
+        title: str,
+        custom_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        description: typing.Optional[str] = OMIT,
+        parent_folder_id: typing.Optional[str] = OMIT,
+        project_type: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> CreateProjectResponseOut:
+        """
+        Create a new project with custom metadata. Projects can be typed (e.g., 'candidate', 'user', 'company') and include flexible custom metadata for storing additional information.
+
+        Parameters
+        ----------
+        title : str
+            The project title
+
+        custom_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            A flexible dictionary for storing custom metadata
+
+        description : typing.Optional[str]
+            Optional project description
+
+        parent_folder_id : typing.Optional[str]
+            Optional parent folder ID
+
+        project_type : typing.Optional[str]
+            User-defined project type (e.g., 'candidate', 'user', 'company')
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        CreateProjectResponseOut
+            Project created successfully
+
+        Examples
+        --------
+        from athena import Athena
+
+        client = Athena(
+            api_key="YOUR_API_KEY",
+        )
+        client.assets.create_project(
+            custom_metadata={
+                "email": "john.doe@example.com",
+                "phone": "+1-555-0123",
+                "source": "linkedin",
+                "status": "active",
+            },
+            description="Candidate profile for senior software engineer position",
+            parent_folder_id="asset_folder_123",
+            project_type="candidate",
+            title="John Doe - Software Engineer",
+        )
+        """
+        _response = self._raw_client.create_project(
+            title=title,
+            custom_metadata=custom_metadata,
+            description=description,
+            parent_folder_id=parent_folder_id,
+            project_type=project_type,
+            request_options=request_options,
+        )
+        return _response.data
+
+    def edit_project(
+        self,
+        *,
+        asset_id: str,
+        custom_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        description: typing.Optional[str] = OMIT,
+        parent_folder_id: typing.Optional[str] = OMIT,
+        project_type: typing.Optional[str] = OMIT,
+        title: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> EditProjectResponseOut:
+        """
+        Edit an existing project's metadata. All fields are optional - only provided fields will be updated. Custom metadata is merged with existing metadata (new keys added, existing keys updated).
+
+        Parameters
+        ----------
+        asset_id : str
+            The ID of the project to edit
+
+        custom_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            Custom metadata to merge with existing metadata (optional). New keys are added, existing keys are updated.
+
+        description : typing.Optional[str]
+            New project description (optional)
+
+        parent_folder_id : typing.Optional[str]
+            New parent folder ID (optional)
+
+        project_type : typing.Optional[str]
+            New project type (optional, e.g., 'candidate', 'user', 'company')
+
+        title : typing.Optional[str]
+            New project title (optional)
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        EditProjectResponseOut
+            Project edited successfully
+
+        Examples
+        --------
+        from athena import Athena
+
+        client = Athena(
+            api_key="YOUR_API_KEY",
+        )
+        client.assets.edit_project(
+            asset_id="asset_project_abc123",
+            custom_metadata={"interview_date": "2024-03-15", "status": "interviewed"},
+            description="Updated candidate profile",
+            project_type="candidate",
+            title="Jane Smith - Senior Engineer",
+        )
+        """
+        _response = self._raw_client.edit_project(
+            asset_id=asset_id,
+            custom_metadata=custom_metadata,
+            description=description,
+            parent_folder_id=parent_folder_id,
+            project_type=project_type,
+            title=title,
+            request_options=request_options,
+        )
+        return _response.data
+
     def get(self, asset_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> PublicAssetOut:
         """
         Retrieve a single asset by its ID. Returns comprehensive metadata including creation info, tags, timestamps, media type, and AI-generated summary.
@@ -184,6 +325,161 @@ class AsyncAssetsClient:
         )
         return _response.data
 
+    async def create_project(
+        self,
+        *,
+        title: str,
+        custom_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        description: typing.Optional[str] = OMIT,
+        parent_folder_id: typing.Optional[str] = OMIT,
+        project_type: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> CreateProjectResponseOut:
+        """
+        Create a new project with custom metadata. Projects can be typed (e.g., 'candidate', 'user', 'company') and include flexible custom metadata for storing additional information.
+
+        Parameters
+        ----------
+        title : str
+            The project title
+
+        custom_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            A flexible dictionary for storing custom metadata
+
+        description : typing.Optional[str]
+            Optional project description
+
+        parent_folder_id : typing.Optional[str]
+            Optional parent folder ID
+
+        project_type : typing.Optional[str]
+            User-defined project type (e.g., 'candidate', 'user', 'company')
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        CreateProjectResponseOut
+            Project created successfully
+
+        Examples
+        --------
+        import asyncio
+
+        from athena import AsyncAthena
+
+        client = AsyncAthena(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.assets.create_project(
+                custom_metadata={
+                    "email": "john.doe@example.com",
+                    "phone": "+1-555-0123",
+                    "source": "linkedin",
+                    "status": "active",
+                },
+                description="Candidate profile for senior software engineer position",
+                parent_folder_id="asset_folder_123",
+                project_type="candidate",
+                title="John Doe - Software Engineer",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.create_project(
+            title=title,
+            custom_metadata=custom_metadata,
+            description=description,
+            parent_folder_id=parent_folder_id,
+            project_type=project_type,
+            request_options=request_options,
+        )
+        return _response.data
+
+    async def edit_project(
+        self,
+        *,
+        asset_id: str,
+        custom_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        description: typing.Optional[str] = OMIT,
+        parent_folder_id: typing.Optional[str] = OMIT,
+        project_type: typing.Optional[str] = OMIT,
+        title: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> EditProjectResponseOut:
+        """
+        Edit an existing project's metadata. All fields are optional - only provided fields will be updated. Custom metadata is merged with existing metadata (new keys added, existing keys updated).
+
+        Parameters
+        ----------
+        asset_id : str
+            The ID of the project to edit
+
+        custom_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            Custom metadata to merge with existing metadata (optional). New keys are added, existing keys are updated.
+
+        description : typing.Optional[str]
+            New project description (optional)
+
+        parent_folder_id : typing.Optional[str]
+            New parent folder ID (optional)
+
+        project_type : typing.Optional[str]
+            New project type (optional, e.g., 'candidate', 'user', 'company')
+
+        title : typing.Optional[str]
+            New project title (optional)
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        EditProjectResponseOut
+            Project edited successfully
+
+        Examples
+        --------
+        import asyncio
+
+        from athena import AsyncAthena
+
+        client = AsyncAthena(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.assets.edit_project(
+                asset_id="asset_project_abc123",
+                custom_metadata={
+                    "interview_date": "2024-03-15",
+                    "status": "interviewed",
+                },
+                description="Updated candidate profile",
+                project_type="candidate",
+                title="Jane Smith - Senior Engineer",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.edit_project(
+            asset_id=asset_id,
+            custom_metadata=custom_metadata,
+            description=description,
+            parent_folder_id=parent_folder_id,
+            project_type=project_type,
+            title=title,
+            request_options=request_options,
+        )
+        return _response.data
+
     async def get(self, asset_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> PublicAssetOut:
         """
         Retrieve a single asset by its ID. Returns comprehensive metadata including creation info, tags, timestamps, media type, and AI-generated summary.

athena/assets/raw_client.py

@@ -9,12 +9,19 @@ from ..core.http_response import AsyncHttpResponse, HttpResponse
 from ..core.jsonable_encoder import jsonable_encoder
 from ..core.pydantic_utilities import parse_obj_as
 from ..core.request_options import RequestOptions
+from ..errors.bad_request_error import BadRequestError
+from ..errors.internal_server_error import InternalServerError
 from ..errors.not_found_error import NotFoundError
 from ..errors.unauthorized_error import UnauthorizedError
 from ..errors.unprocessable_entity_error import UnprocessableEntityError
+from ..types.create_project_response_out import CreateProjectResponseOut
+from ..types.edit_project_response_out import EditProjectResponseOut
 from ..types.paginated_assets_out import PaginatedAssetsOut
 from ..types.public_asset_out import PublicAssetOut
 
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
 
 class RawAssetsClient:
     def __init__(self, *, client_wrapper: SyncClientWrapper):
@@ -91,6 +98,226 @@ class RawAssetsClient:
             raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
 
+    def create_project(
+        self,
+        *,
+        title: str,
+        custom_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        description: typing.Optional[str] = OMIT,
+        parent_folder_id: typing.Optional[str] = OMIT,
+        project_type: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[CreateProjectResponseOut]:
+        """
+        Create a new project with custom metadata. Projects can be typed (e.g., 'candidate', 'user', 'company') and include flexible custom metadata for storing additional information.
+
+        Parameters
+        ----------
+        title : str
+            The project title
+
+        custom_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            A flexible dictionary for storing custom metadata
+
+        description : typing.Optional[str]
+            Optional project description
+
+        parent_folder_id : typing.Optional[str]
+            Optional parent folder ID
+
+        project_type : typing.Optional[str]
+            User-defined project type (e.g., 'candidate', 'user', 'company')
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[CreateProjectResponseOut]
+            Project created successfully
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "api/v0/assets/create_project",
+            method="POST",
+            json={
+                "custom_metadata": custom_metadata,
+                "description": description,
+                "parent_folder_id": parent_folder_id,
+                "project_type": project_type,
+                "title": title,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    CreateProjectResponseOut,
+                    parse_obj_as(
+                        type_=CreateProjectResponseOut,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def edit_project(
+        self,
+        *,
+        asset_id: str,
+        custom_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        description: typing.Optional[str] = OMIT,
+        parent_folder_id: typing.Optional[str] = OMIT,
+        project_type: typing.Optional[str] = OMIT,
+        title: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[EditProjectResponseOut]:
+        """
+        Edit an existing project's metadata. All fields are optional - only provided fields will be updated. Custom metadata is merged with existing metadata (new keys added, existing keys updated).
+
+        Parameters
+        ----------
+        asset_id : str
+            The ID of the project to edit
+
+        custom_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            Custom metadata to merge with existing metadata (optional). New keys are added, existing keys are updated.
+
+        description : typing.Optional[str]
+            New project description (optional)
+
+        parent_folder_id : typing.Optional[str]
+            New parent folder ID (optional)
+
+        project_type : typing.Optional[str]
+            New project type (optional, e.g., 'candidate', 'user', 'company')
+
+        title : typing.Optional[str]
+            New project title (optional)
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[EditProjectResponseOut]
+            Project edited successfully
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "api/v0/assets/edit_project",
+            method="POST",
+            json={
+                "asset_id": asset_id,
+                "custom_metadata": custom_metadata,
+                "description": description,
+                "parent_folder_id": parent_folder_id,
+                "project_type": project_type,
+                "title": title,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    EditProjectResponseOut,
+                    parse_obj_as(
+                        type_=EditProjectResponseOut,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
     def get(
         self, asset_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> HttpResponse[PublicAssetOut]:
@@ -238,6 +465,226 @@ class AsyncRawAssetsClient:
             raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
 
+    async def create_project(
+        self,
+        *,
+        title: str,
+        custom_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        description: typing.Optional[str] = OMIT,
+        parent_folder_id: typing.Optional[str] = OMIT,
+        project_type: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[CreateProjectResponseOut]:
+        """
+        Create a new project with custom metadata. Projects can be typed (e.g., 'candidate', 'user', 'company') and include flexible custom metadata for storing additional information.
+
+        Parameters
+        ----------
+        title : str
+            The project title
+
+        custom_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            A flexible dictionary for storing custom metadata
+
+        description : typing.Optional[str]
+            Optional project description
+
+        parent_folder_id : typing.Optional[str]
+            Optional parent folder ID
+
+        project_type : typing.Optional[str]
+            User-defined project type (e.g., 'candidate', 'user', 'company')
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[CreateProjectResponseOut]
+            Project created successfully
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "api/v0/assets/create_project",
+            method="POST",
+            json={
+                "custom_metadata": custom_metadata,
+                "description": description,
+                "parent_folder_id": parent_folder_id,
+                "project_type": project_type,
+                "title": title,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    CreateProjectResponseOut,
+                    parse_obj_as(
+                        type_=CreateProjectResponseOut,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def edit_project(
+        self,
+        *,
+        asset_id: str,
+        custom_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        description: typing.Optional[str] = OMIT,
+        parent_folder_id: typing.Optional[str] = OMIT,
+        project_type: typing.Optional[str] = OMIT,
+        title: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[EditProjectResponseOut]:
+        """
+        Edit an existing project's metadata. All fields are optional - only provided fields will be updated. Custom metadata is merged with existing metadata (new keys added, existing keys updated).
+
+        Parameters
+        ----------
+        asset_id : str
+            The ID of the project to edit
+
+        custom_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            Custom metadata to merge with existing metadata (optional). New keys are added, existing keys are updated.
+
+        description : typing.Optional[str]
+            New project description (optional)
+
+        parent_folder_id : typing.Optional[str]
+            New parent folder ID (optional)
+
+        project_type : typing.Optional[str]
+            New project type (optional, e.g., 'candidate', 'user', 'company')
+
+        title : typing.Optional[str]
+            New project title (optional)
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[EditProjectResponseOut]
+            Project edited successfully
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "api/v0/assets/edit_project",
+            method="POST",
+            json={
+                "asset_id": asset_id,
+                "custom_metadata": custom_metadata,
+                "description": description,
+                "parent_folder_id": parent_folder_id,
+                "project_type": project_type,
+                "title": title,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    EditProjectResponseOut,
+                    parse_obj_as(
+                        type_=EditProjectResponseOut,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
     async def get(
         self, asset_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> AsyncHttpResponse[PublicAssetOut]:

athena/core/client_wrapper.py

@@ -22,10 +22,10 @@ class BaseClientWrapper:
 
     def get_headers(self) -> typing.Dict[str, str]:
         headers: typing.Dict[str, str] = {
-            "User-Agent": "athena-intelligence/0.1.261",
+            "User-Agent": "athena-intelligence/0.1.263",
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "athena-intelligence",
-            "X-Fern-SDK-Version": "0.1.261",
+            "X-Fern-SDK-Version": "0.1.263",
             **(self.get_custom_headers() or {}),
         }
         headers["X-API-KEY"] = self.api_key

athena/types/__init__.py

@@ -29,6 +29,7 @@ if typing.TYPE_CHECKING:
     from .conversation_message import ConversationMessage
     from .conversation_result import ConversationResult
     from .create_new_sheet_tab_response import CreateNewSheetTabResponse
+    from .create_project_response_out import CreateProjectResponseOut
     from .custom_agent_response import CustomAgentResponse
     from .data_frame_request_out import DataFrameRequestOut
     from .data_frame_request_out_columns_item import DataFrameRequestOutColumnsItem
@@ -38,6 +39,7 @@ if typing.TYPE_CHECKING:
     from .dimension_properties import DimensionProperties
     from .document_chunk import DocumentChunk
     from .drive_agent_response import DriveAgentResponse
+    from .edit_project_response_out import EditProjectResponseOut
     from .file_chunk_request_out import FileChunkRequestOut
     from .file_too_large_error import FileTooLargeError
     from .folder_response import FolderResponse
@@ -103,6 +105,7 @@ _dynamic_imports: typing.Dict[str, str] = {
     "ConversationMessage": ".conversation_message",
     "ConversationResult": ".conversation_result",
     "CreateNewSheetTabResponse": ".create_new_sheet_tab_response",
+    "CreateProjectResponseOut": ".create_project_response_out",
     "CustomAgentResponse": ".custom_agent_response",
     "DataFrameRequestOut": ".data_frame_request_out",
     "DataFrameRequestOutColumnsItem": ".data_frame_request_out_columns_item",
@@ -112,6 +115,7 @@ _dynamic_imports: typing.Dict[str, str] = {
     "DimensionProperties": ".dimension_properties",
     "DocumentChunk": ".document_chunk",
     "DriveAgentResponse": ".drive_agent_response",
+    "EditProjectResponseOut": ".edit_project_response_out",
     "FileChunkRequestOut": ".file_chunk_request_out",
     "FileTooLargeError": ".file_too_large_error",
     "FolderResponse": ".folder_response",
@@ -199,6 +203,7 @@ __all__ = [
     "ConversationMessage",
     "ConversationResult",
     "CreateNewSheetTabResponse",
+    "CreateProjectResponseOut",
     "CustomAgentResponse",
     "DataFrameRequestOut",
     "DataFrameRequestOutColumnsItem",
@@ -208,6 +213,7 @@ __all__ = [
     "DimensionProperties",
     "DocumentChunk",
     "DriveAgentResponse",
+    "EditProjectResponseOut",
     "FileChunkRequestOut",
     "FileTooLargeError",
     "FolderResponse",

athena/types/create_project_response_out.py

@@ -0,0 +1,46 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+
+
+class CreateProjectResponseOut(UniversalBaseModel):
+    """
+    Response model for project creation.
+    """
+
+    asset_id: str = pydantic.Field()
+    """
+    ID of the created project asset
+    """
+
+    custom_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+    """
+    Custom metadata associated with the project
+    """
+
+    description: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Description of the project
+    """
+
+    project_type: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Type of the project
+    """
+
+    title: str = pydantic.Field()
+    """
+    Title of the created project
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

athena/types/edit_project_response_out.py

@@ -0,0 +1,46 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+
+
+class EditProjectResponseOut(UniversalBaseModel):
+    """
+    Response model for editing a project.
+    """
+
+    asset_id: str = pydantic.Field()
+    """
+    The ID of the edited project
+    """
+
+    custom_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+    """
+    The updated custom metadata
+    """
+
+    description: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The updated project description
+    """
+
+    project_type: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The updated project type
+    """
+
+    title: str = pydantic.Field()
+    """
+    The updated project title
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

{athena_intelligence-0.1.261.dist-info → athena_intelligence-0.1.263.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: athena-intelligence
-Version: 0.1.261
+Version: 0.1.263
 Summary: Athena Intelligence Python Library
 Requires-Python: >=3.9,<4.0
 Classifier: Intended Audience :: Developers

{athena_intelligence-0.1.261.dist-info → athena_intelligence-0.1.263.dist-info}/RECORD

@@ -1,4 +1,4 @@
-athena/__init__.py,sha256=STNRCCbbckdPq_mE-66Rdr4r24pajTxp5adeICpoQUU,8987
+athena/__init__.py,sha256=ozQ_fUo-mbCgv2VArpZNgBfIdOm7sP18XSEKfPYMGN8,9197
 athena/agents/__init__.py,sha256=LqM1Kj7aFzYoFsB7xrYKPDJAnOWmcig1LNE4jAiWpJQ,1166
 athena/agents/client.py,sha256=b3QvSCRsiHD6UREN7llGY946V-oZdKkhouQ6p_nH1j8,8044
 athena/agents/drive/__init__.py,sha256=_VhToAyIt_5axN6CLJwtxg3-CO7THa_23pbUzqhXJa4,85
@@ -18,13 +18,13 @@ athena/aop/__init__.py,sha256=_VhToAyIt_5axN6CLJwtxg3-CO7THa_23pbUzqhXJa4,85
 athena/aop/client.py,sha256=Fg7rNF1k78MIKDELy8GE-DfAaJvHFUUBG5haMR_Vefo,6758
 athena/aop/raw_client.py,sha256=ZQRtNNirk1xfbkKHADxSCPB0UQjf4HO5l-6z7W936X8,18509
 athena/assets/__init__.py,sha256=_VhToAyIt_5axN6CLJwtxg3-CO7THa_23pbUzqhXJa4,85
-athena/assets/client.py,sha256=yRU6wHLqQpqppqhOKIC-drEp0WJyUjewvqIG3g6qQkU,7335
-athena/assets/raw_client.py,sha256=lXFjKzqHvge7_DBIjoPLYT5URYcBxOZcpD3i3O_ePOE,13132
+athena/assets/client.py,sha256=jKDXqX5TPPckKKAw7lIPmpOFEGFcMGLiIpWaoZ2AlkU,17421
+athena/assets/raw_client.py,sha256=LjmNe1uULGoiH1yQBYxUwqrK8bBCUwjJ786K1b6PqyU,31369
 athena/base_client.py,sha256=IlYf1TLV3w-JZPATzyT-b5wSrjKm-fsT_3bC172GpVI,9576
 athena/client.py,sha256=I-aFsGhcViOdOeaWayhMkaMkV5545Yz2Gb-BoVQvhE4,22317
 athena/core/__init__.py,sha256=GkNNgA0CeqvpCzo2vVtAafE8YcnGV-VGtbU5op93lbc,3624
 athena/core/api_error.py,sha256=44vPoTyWN59gonCIZMdzw7M1uspygiLnr3GNFOoVL2Q,614
-athena/core/client_wrapper.py,sha256=iqiiSIUfIyjxiR1SpJlCoZ79DIAIsVzyjvjklBo_BQo,2392
+athena/core/client_wrapper.py,sha256=FsapSsjpdAg6UqflA9Dsh_pkEifRPjUZDGC7rsggxrM,2392
 athena/core/datetime_utils.py,sha256=nBys2IsYrhPdszxGKCNRPSOCwa-5DWOHG95FB8G9PKo,1047
 athena/core/file.py,sha256=d4NNbX8XvXP32z8KpK2Xovv33nFfruIrpz0QWxlgpZk,2663
 athena/core/force_multipart.py,sha256=cH981xLy0kZVKiZZkFoeUjgJ2Zuq7KXB2aRAnmHzRDc,477
@@ -76,7 +76,7 @@ athena/tools/tasks/client.py,sha256=c_YZ7OjQNJmPKbeeXJznXj3zo5CRFSv02dLupAdHAyo,
 athena/tools/tasks/raw_client.py,sha256=Mexzuf_HcRXWNlESDGQkHHv5tC2tAo-AX3PBSuSRO3U,3812
 athena/tools/types/__init__.py,sha256=EBAoLXAl5YZCDYkI-YPJA0035ZRyGktyW4tspFXOQso,1180
 athena/tools/types/tools_data_frame_request_columns_item.py,sha256=GA1FUlTV_CfSc-KToTAwFf4Exl0rr4fsweVZupztjw0,138
-athena/types/__init__.py,sha256=j3rz_viMKkWBpTqWzHo-rMWDBO0V2aqdZfqa0ApcDcs,10285
+athena/types/__init__.py,sha256=lGgid5KUDJ_WOPYq-ty9esQfM9v47blav7RjFIc-9nw,10607
 athena/types/aop_async_execute_response_out.py,sha256=Ggs9j5JvLCMaVwaHNyY3whA5gcUffLqc4PwuxYWI-38,1642
 athena/types/aop_execute_request_in.py,sha256=mEsMKyNN6e90gZra733lJDC6z0bZWdc72af3B-Z5aqE,889
 athena/types/aop_execute_response_out.py,sha256=_w6_WERRgGEVI0O_4qRfVZPLpcaa8yihWgwB4ZV0Zs8,1847
@@ -100,6 +100,7 @@ athena/types/conversation_asset_info.py,sha256=SbsWJuGwic6nliEu9ykW-q2A7SfnRt4U3
 athena/types/conversation_message.py,sha256=bJsO0T9ktciCAys28ESQJQNfY-29pI3lKxPhRb7D4ic,1084
 athena/types/conversation_result.py,sha256=EwC27cGZWzRyrJxlyKrevndnOSDBM0DkaOUu7foeYeI,1851
 athena/types/create_new_sheet_tab_response.py,sha256=RF8iOL3mkSc3pY0pqQhvw9IdnncxDC_-XdSUhqPODsM,892
+athena/types/create_project_response_out.py,sha256=iMxs8dnwoNraOYmsVYm93TyXyAeSomUdWN5j720orxc,1156
 athena/types/custom_agent_response.py,sha256=hzw1s7mcCI9V58l5OqK4Q59AGF_NctSx5scjJeVWckk,684
 athena/types/data_frame_request_out.py,sha256=wyVIEEI6mqSoH6SyXTQpzLCJOWwsAlUvG9iAVlNuNOU,1076
 athena/types/data_frame_request_out_columns_item.py,sha256=9cjzciFv6C8n8Griytt_q_8ovkzHViS5tvUcMDfkfKE,143
@@ -109,6 +110,7 @@ athena/types/data_frame_unknown_format_error.py,sha256=yEykbkXCfsxDKYHXps8jOtv6R
 athena/types/dimension_properties.py,sha256=y221yMcIHjx9XMorHHaQyd9-h2h_qmCuRHyAqmYmn24,1709
 athena/types/document_chunk.py,sha256=Ma7nl0SnTZsshYtpjh37OJhwrNPmSkzw_QUaFChPCD0,651
 athena/types/drive_agent_response.py,sha256=sxxt3DVibsYrF8bnil9ZKD3GFkD0m2hp9qDfQSaNqcs,639
+athena/types/edit_project_response_out.py,sha256=NQqknEbD7Y74bi1tkXhZOTjB2o347wiPFgsmyRZEtx0,1143
 athena/types/file_chunk_request_out.py,sha256=5utKRptaqyizg0D9ogPEM1IPJIUW2NMHNLewYZLNe8Q,665
 athena/types/file_too_large_error.py,sha256=xXAMDgmJ9w0AGu-dKF1m1nCKtoqDetUf2DRqQ64npHY,527
 athena/types/folder_response.py,sha256=pKIzL_4PpNweVrfvMdJPsToaaxZqMuW8071zJ40-Xow,811
@@ -145,6 +147,6 @@ athena/types/thread_status_response_out.py,sha256=UuSAvs9woL1i8RwvVRKsFUufN4A9jO
 athena/types/type.py,sha256=Gvs56nvBMPcQpOZkfPocGNNb7S05PuINianbT309QAQ,146
 athena/types/wrap_strategy.py,sha256=ykPFCr91HGvzIk9BRppW_UBWoUamFxDhLO_ETzQgVKI,164
 athena/version.py,sha256=tnXYUugs9zF_pkVdem-QBorKSuhEOOuetkR57dADDxE,86
-athena_intelligence-0.1.261.dist-info/METADATA,sha256=Kqna4AyEcnPUQcdFngv1UuPFwmjWcK-qTS--Zc6n7no,5440
-athena_intelligence-0.1.261.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
-athena_intelligence-0.1.261.dist-info/RECORD,,
+athena_intelligence-0.1.263.dist-info/METADATA,sha256=Sz6YxOhYB_9Ow9hgfb0YgE5wrEHmbollItdTsi-i9DI,5440
+athena_intelligence-0.1.263.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+athena_intelligence-0.1.263.dist-info/RECORD,,