usecortex-ai 0.2.1__py3-none-any.whl → 0.3.0__py3-none-any.whl

usecortex_ai/embeddings/client.py

@@ -38,28 +38,20 @@ class EmbeddingsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> EmbeddingsDeleteData:
         """
-        Delete specific embedding chunks from indexed sources.
+        Delete embedding chunks by chunk ID.
 
-        This endpoint deletes specified embedding chunks from the Findr backend by sending
-        chunk IDs to the backend delete service.
-
-        Args:
-            request (EmbeddingsDeleteRequest): The delete request containing:
-                - chunk_ids (List[str]): List of chunk IDs to delete
-                - tenant_id (str): Tenant identifier for multi-tenancy
-                - sub_tenant_id (str, optional): Sub-tenant identifier, defaults to tenant_id
-            api_details (dict): Authentication details obtained from API key validation
-
-        Returns:
-            EmbeddingsDeleteData: Success response with deletion details
+        Use this to remove specific chunks from your embeddings index when they are no longer valid or should not appear in results.
 
         Parameters
         ----------
         chunk_ids : typing.Sequence[str]
+            The chunk IDs of the source you want to delete
 
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         sub_tenant_id : typing.Optional[str]
+            Optional sub-tenant identifier used to organize data within a tenant. If omitted, the default sub-tenant created during tenant setup will be used.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -74,7 +66,7 @@ class EmbeddingsClient:
         from usecortex-ai import CortexAI
 
         client = CortexAI(token="YOUR_TOKEN", )
-        client.embeddings.delete(chunk_ids=['chunk_ids'], tenant_id='tenant_id', )
+        client.embeddings.delete(chunk_ids=['CortexEmbeddings123_0', 'CortexEmbeddings123_1'], tenant_id='tenant_1234', )
         """
         _response = self._raw_client.delete(
             chunk_ids=chunk_ids, tenant_id=tenant_id, sub_tenant_id=sub_tenant_id, request_options=request_options
@@ -91,29 +83,24 @@ class EmbeddingsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> EmbeddingsSearchData:
         """
-        Search for similar embedding chunks using vector similarity.
+        Find similar chunks using an embedding vector.
 
-        This endpoint performs semantic search by sending an embedding vector to the Findr backend
-        and returns a list of the most similar chunk IDs based on vector similarity.
+        Use this to retrieve the most similar chunk IDs to a single query embedding.
 
-        Args:
-            request (EmbeddingsSearchRequest): The search request containing:
-                - embeddings (List[float]): Single embedding vector for similarity search
-                - tenant_id (str): Tenant identifier for multi-tenancy
-                - sub_tenant_id (str, optional): Sub-tenant identifier, defaults to tenant_id
-                - max_chunks (int, optional): Maximum number of chunk IDs to return (default: 10)
-            api_details (dict): Authentication details obtained from API key validation
 
-        Returns:
-            EmbeddingsSearchData: List of chunk IDs with similarity scores
+        Expected outcome
+        - You receive the closest chunk IDs with optional similarity scores.
 
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         embeddings : typing.Optional[typing.Sequence[float]]
+            The embedding vector for search
 
         sub_tenant_id : typing.Optional[str]
+            Optional sub-tenant identifier used to organize data within a tenant. If omitted, the default sub-tenant created during tenant setup will be used.
 
         max_chunks : typing.Optional[int]
 
@@ -130,7 +117,7 @@ class EmbeddingsClient:
         from usecortex-ai import CortexAI
 
         client = CortexAI(token="YOUR_TOKEN", )
-        client.embeddings.search(tenant_id='tenant_id', )
+        client.embeddings.search(tenant_id='tenant_1234', )
         """
         _response = self._raw_client.search(
             tenant_id=tenant_id,
@@ -150,20 +137,20 @@ class EmbeddingsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> EmbeddingsGetData:
         """
-        Get embeddings based on chunk IDs.
+        Retrieve embeddings for specific chunk IDs.
 
-        This endpoint returns embeddings for a list of chunk IDs.
-
-        Returns:
-            EmbeddingsGetData: Embeddings data for the requested chunk IDs
+        Use this when you already know the chunk IDs and need their corresponding embeddings.
 
         Parameters
         ----------
         chunk_ids : typing.Sequence[str]
+            The chunk IDs of the source you want to get embeddings for
 
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         sub_tenant_id : typing.Optional[str]
+            Optional sub-tenant identifier used to organize data within a tenant. If omitted, the default sub-tenant created during tenant setup will be used.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -178,7 +165,7 @@ class EmbeddingsClient:
         from usecortex-ai import CortexAI
 
         client = CortexAI(token="YOUR_TOKEN", )
-        client.embeddings.get_by_chunk_ids(chunk_ids=['chunk_ids'], tenant_id='tenant_id', )
+        client.embeddings.get_by_chunk_ids(chunk_ids=['CortexEmbeddings123_0', 'CortexEmbeddings123_1'], tenant_id='tenant_1234', )
         """
         _response = self._raw_client.get_by_chunk_ids(
             chunk_ids=chunk_ids, tenant_id=tenant_id, sub_tenant_id=sub_tenant_id, request_options=request_options
@@ -189,16 +176,14 @@ class EmbeddingsClient:
         self, *, tenant_id: str, request_options: typing.Optional[RequestOptions] = None
     ) -> EmbeddingsCreateCollectionData:
         """
-        Create an embeddings collection for the given tenant in Findr.
-
-        sub_tenant_id is set to be the same as tenant_id as per requirements.
+        Create an embeddings collection for a tenant.
 
-        Returns:
-            EmbeddingsCreateCollectionData: Success response with collection details
+        Use this to initialize storage so you can index and query embeddings for the tenant.
 
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -213,7 +198,7 @@ class EmbeddingsClient:
         from usecortex-ai import CortexAI
 
         client = CortexAI(token="YOUR_TOKEN", )
-        client.embeddings.create_collection(tenant_id='tenant_id', )
+        client.embeddings.create_collection(tenant_id='tenant_1234', )
         """
         _response = self._raw_client.create_collection(tenant_id=tenant_id, request_options=request_options)
         return _response.data
@@ -243,28 +228,20 @@ class AsyncEmbeddingsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> EmbeddingsDeleteData:
         """
-        Delete specific embedding chunks from indexed sources.
+        Delete embedding chunks by chunk ID.
 
-        This endpoint deletes specified embedding chunks from the Findr backend by sending
-        chunk IDs to the backend delete service.
-
-        Args:
-            request (EmbeddingsDeleteRequest): The delete request containing:
-                - chunk_ids (List[str]): List of chunk IDs to delete
-                - tenant_id (str): Tenant identifier for multi-tenancy
-                - sub_tenant_id (str, optional): Sub-tenant identifier, defaults to tenant_id
-            api_details (dict): Authentication details obtained from API key validation
-
-        Returns:
-            EmbeddingsDeleteData: Success response with deletion details
+        Use this to remove specific chunks from your embeddings index when they are no longer valid or should not appear in results.
 
         Parameters
         ----------
         chunk_ids : typing.Sequence[str]
+            The chunk IDs of the source you want to delete
 
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         sub_tenant_id : typing.Optional[str]
+            Optional sub-tenant identifier used to organize data within a tenant. If omitted, the default sub-tenant created during tenant setup will be used.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -282,7 +259,7 @@ class AsyncEmbeddingsClient:
 
         client = AsyncCortexAI(token="YOUR_TOKEN", )
         async def main() -> None:
-            await client.embeddings.delete(chunk_ids=['chunk_ids'], tenant_id='tenant_id', )
+            await client.embeddings.delete(chunk_ids=['CortexEmbeddings123_0', 'CortexEmbeddings123_1'], tenant_id='tenant_1234', )
         asyncio.run(main())
         """
         _response = await self._raw_client.delete(
@@ -300,29 +277,24 @@ class AsyncEmbeddingsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> EmbeddingsSearchData:
         """
-        Search for similar embedding chunks using vector similarity.
+        Find similar chunks using an embedding vector.
 
-        This endpoint performs semantic search by sending an embedding vector to the Findr backend
-        and returns a list of the most similar chunk IDs based on vector similarity.
+        Use this to retrieve the most similar chunk IDs to a single query embedding.
 
-        Args:
-            request (EmbeddingsSearchRequest): The search request containing:
-                - embeddings (List[float]): Single embedding vector for similarity search
-                - tenant_id (str): Tenant identifier for multi-tenancy
-                - sub_tenant_id (str, optional): Sub-tenant identifier, defaults to tenant_id
-                - max_chunks (int, optional): Maximum number of chunk IDs to return (default: 10)
-            api_details (dict): Authentication details obtained from API key validation
 
-        Returns:
-            EmbeddingsSearchData: List of chunk IDs with similarity scores
+        Expected outcome
+        - You receive the closest chunk IDs with optional similarity scores.
 
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         embeddings : typing.Optional[typing.Sequence[float]]
+            The embedding vector for search
 
         sub_tenant_id : typing.Optional[str]
+            Optional sub-tenant identifier used to organize data within a tenant. If omitted, the default sub-tenant created during tenant setup will be used.
 
         max_chunks : typing.Optional[int]
 
@@ -342,7 +314,7 @@ class AsyncEmbeddingsClient:
 
         client = AsyncCortexAI(token="YOUR_TOKEN", )
         async def main() -> None:
-            await client.embeddings.search(tenant_id='tenant_id', )
+            await client.embeddings.search(tenant_id='tenant_1234', )
         asyncio.run(main())
         """
         _response = await self._raw_client.search(
@@ -363,20 +335,20 @@ class AsyncEmbeddingsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> EmbeddingsGetData:
         """
-        Get embeddings based on chunk IDs.
+        Retrieve embeddings for specific chunk IDs.
 
-        This endpoint returns embeddings for a list of chunk IDs.
-
-        Returns:
-            EmbeddingsGetData: Embeddings data for the requested chunk IDs
+        Use this when you already know the chunk IDs and need their corresponding embeddings.
 
         Parameters
         ----------
         chunk_ids : typing.Sequence[str]
+            The chunk IDs of the source you want to get embeddings for
 
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         sub_tenant_id : typing.Optional[str]
+            Optional sub-tenant identifier used to organize data within a tenant. If omitted, the default sub-tenant created during tenant setup will be used.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -394,7 +366,7 @@ class AsyncEmbeddingsClient:
 
         client = AsyncCortexAI(token="YOUR_TOKEN", )
         async def main() -> None:
-            await client.embeddings.get_by_chunk_ids(chunk_ids=['chunk_ids'], tenant_id='tenant_id', )
+            await client.embeddings.get_by_chunk_ids(chunk_ids=['CortexEmbeddings123_0', 'CortexEmbeddings123_1'], tenant_id='tenant_1234', )
         asyncio.run(main())
         """
         _response = await self._raw_client.get_by_chunk_ids(
@@ -406,16 +378,14 @@ class AsyncEmbeddingsClient:
         self, *, tenant_id: str, request_options: typing.Optional[RequestOptions] = None
     ) -> EmbeddingsCreateCollectionData:
         """
-        Create an embeddings collection for the given tenant in Findr.
-
-        sub_tenant_id is set to be the same as tenant_id as per requirements.
+        Create an embeddings collection for a tenant.
 
-        Returns:
-            EmbeddingsCreateCollectionData: Success response with collection details
+        Use this to initialize storage so you can index and query embeddings for the tenant.
 
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -433,7 +403,7 @@ class AsyncEmbeddingsClient:
 
         client = AsyncCortexAI(token="YOUR_TOKEN", )
         async def main() -> None:
-            await client.embeddings.create_collection(tenant_id='tenant_id', )
+            await client.embeddings.create_collection(tenant_id='tenant_1234', )
         asyncio.run(main())
         """
         _response = await self._raw_client.create_collection(tenant_id=tenant_id, request_options=request_options)

usecortex_ai/embeddings/raw_client.py

@@ -38,28 +38,20 @@ class RawEmbeddingsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[EmbeddingsDeleteData]:
         """
-        Delete specific embedding chunks from indexed sources.
+        Delete embedding chunks by chunk ID.
 
-        This endpoint deletes specified embedding chunks from the Findr backend by sending
-        chunk IDs to the backend delete service.
-
-        Args:
-            request (EmbeddingsDeleteRequest): The delete request containing:
-                - chunk_ids (List[str]): List of chunk IDs to delete
-                - tenant_id (str): Tenant identifier for multi-tenancy
-                - sub_tenant_id (str, optional): Sub-tenant identifier, defaults to tenant_id
-            api_details (dict): Authentication details obtained from API key validation
-
-        Returns:
-            EmbeddingsDeleteData: Success response with deletion details
+        Use this to remove specific chunks from your embeddings index when they are no longer valid or should not appear in results.
 
         Parameters
         ----------
         chunk_ids : typing.Sequence[str]
+            The chunk IDs of the source you want to delete
 
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         sub_tenant_id : typing.Optional[str]
+            Optional sub-tenant identifier used to organize data within a tenant. If omitted, the default sub-tenant created during tenant setup will be used.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -185,29 +177,24 @@ class RawEmbeddingsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[EmbeddingsSearchData]:
         """
-        Search for similar embedding chunks using vector similarity.
+        Find similar chunks using an embedding vector.
 
-        This endpoint performs semantic search by sending an embedding vector to the Findr backend
-        and returns a list of the most similar chunk IDs based on vector similarity.
+        Use this to retrieve the most similar chunk IDs to a single query embedding.
 
-        Args:
-            request (EmbeddingsSearchRequest): The search request containing:
-                - embeddings (List[float]): Single embedding vector for similarity search
-                - tenant_id (str): Tenant identifier for multi-tenancy
-                - sub_tenant_id (str, optional): Sub-tenant identifier, defaults to tenant_id
-                - max_chunks (int, optional): Maximum number of chunk IDs to return (default: 10)
-            api_details (dict): Authentication details obtained from API key validation
 
-        Returns:
-            EmbeddingsSearchData: List of chunk IDs with similarity scores
+        Expected outcome
+        - You receive the closest chunk IDs with optional similarity scores.
 
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         embeddings : typing.Optional[typing.Sequence[float]]
+            The embedding vector for search
 
         sub_tenant_id : typing.Optional[str]
+            Optional sub-tenant identifier used to organize data within a tenant. If omitted, the default sub-tenant created during tenant setup will be used.
 
         max_chunks : typing.Optional[int]
 
@@ -335,20 +322,20 @@ class RawEmbeddingsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[EmbeddingsGetData]:
         """
-        Get embeddings based on chunk IDs.
+        Retrieve embeddings for specific chunk IDs.
 
-        This endpoint returns embeddings for a list of chunk IDs.
-
-        Returns:
-            EmbeddingsGetData: Embeddings data for the requested chunk IDs
+        Use this when you already know the chunk IDs and need their corresponding embeddings.
 
         Parameters
         ----------
         chunk_ids : typing.Sequence[str]
+            The chunk IDs of the source you want to get embeddings for
 
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         sub_tenant_id : typing.Optional[str]
+            Optional sub-tenant identifier used to organize data within a tenant. If omitted, the default sub-tenant created during tenant setup will be used.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -359,7 +346,7 @@ class RawEmbeddingsClient:
             Successful Response
         """
         _response = self._client_wrapper.httpx_client.request(
-            "embeddings/by-chunk-ids",
+            "embeddings/retrieve_by_ids",
             method="POST",
             json={
                 "chunk_ids": chunk_ids,
@@ -468,16 +455,14 @@ class RawEmbeddingsClient:
         self, *, tenant_id: str, request_options: typing.Optional[RequestOptions] = None
     ) -> HttpResponse[EmbeddingsCreateCollectionData]:
         """
-        Create an embeddings collection for the given tenant in Findr.
-
-        sub_tenant_id is set to be the same as tenant_id as per requirements.
+        Create an embeddings collection for a tenant.
 
-        Returns:
-            EmbeddingsCreateCollectionData: Success response with collection details
+        Use this to initialize storage so you can index and query embeddings for the tenant.
 
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -488,7 +473,7 @@ class RawEmbeddingsClient:
             Successful Response
         """
         _response = self._client_wrapper.httpx_client.request(
-            "embeddings/create_embeddings_tenant",
+            "embeddings/create_tenant",
             method="POST",
             params={
                 "tenant_id": tenant_id,
@@ -601,28 +586,20 @@ class AsyncRawEmbeddingsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[EmbeddingsDeleteData]:
         """
-        Delete specific embedding chunks from indexed sources.
+        Delete embedding chunks by chunk ID.
 
-        This endpoint deletes specified embedding chunks from the Findr backend by sending
-        chunk IDs to the backend delete service.
-
-        Args:
-            request (EmbeddingsDeleteRequest): The delete request containing:
-                - chunk_ids (List[str]): List of chunk IDs to delete
-                - tenant_id (str): Tenant identifier for multi-tenancy
-                - sub_tenant_id (str, optional): Sub-tenant identifier, defaults to tenant_id
-            api_details (dict): Authentication details obtained from API key validation
-
-        Returns:
-            EmbeddingsDeleteData: Success response with deletion details
+        Use this to remove specific chunks from your embeddings index when they are no longer valid or should not appear in results.
 
         Parameters
         ----------
         chunk_ids : typing.Sequence[str]
+            The chunk IDs of the source you want to delete
 
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         sub_tenant_id : typing.Optional[str]
+            Optional sub-tenant identifier used to organize data within a tenant. If omitted, the default sub-tenant created during tenant setup will be used.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -748,29 +725,24 @@ class AsyncRawEmbeddingsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[EmbeddingsSearchData]:
         """
-        Search for similar embedding chunks using vector similarity.
+        Find similar chunks using an embedding vector.
 
-        This endpoint performs semantic search by sending an embedding vector to the Findr backend
-        and returns a list of the most similar chunk IDs based on vector similarity.
+        Use this to retrieve the most similar chunk IDs to a single query embedding.
 
-        Args:
-            request (EmbeddingsSearchRequest): The search request containing:
-                - embeddings (List[float]): Single embedding vector for similarity search
-                - tenant_id (str): Tenant identifier for multi-tenancy
-                - sub_tenant_id (str, optional): Sub-tenant identifier, defaults to tenant_id
-                - max_chunks (int, optional): Maximum number of chunk IDs to return (default: 10)
-            api_details (dict): Authentication details obtained from API key validation
 
-        Returns:
-            EmbeddingsSearchData: List of chunk IDs with similarity scores
+        Expected outcome
+        - You receive the closest chunk IDs with optional similarity scores.
 
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         embeddings : typing.Optional[typing.Sequence[float]]
+            The embedding vector for search
 
         sub_tenant_id : typing.Optional[str]
+            Optional sub-tenant identifier used to organize data within a tenant. If omitted, the default sub-tenant created during tenant setup will be used.
 
         max_chunks : typing.Optional[int]
 
@@ -898,20 +870,20 @@ class AsyncRawEmbeddingsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[EmbeddingsGetData]:
         """
-        Get embeddings based on chunk IDs.
+        Retrieve embeddings for specific chunk IDs.
 
-        This endpoint returns embeddings for a list of chunk IDs.
-
-        Returns:
-            EmbeddingsGetData: Embeddings data for the requested chunk IDs
+        Use this when you already know the chunk IDs and need their corresponding embeddings.
 
         Parameters
         ----------
         chunk_ids : typing.Sequence[str]
+            The chunk IDs of the source you want to get embeddings for
 
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         sub_tenant_id : typing.Optional[str]
+            Optional sub-tenant identifier used to organize data within a tenant. If omitted, the default sub-tenant created during tenant setup will be used.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -922,7 +894,7 @@ class AsyncRawEmbeddingsClient:
             Successful Response
         """
         _response = await self._client_wrapper.httpx_client.request(
-            "embeddings/by-chunk-ids",
+            "embeddings/retrieve_by_ids",
             method="POST",
             json={
                 "chunk_ids": chunk_ids,
@@ -1031,16 +1003,14 @@ class AsyncRawEmbeddingsClient:
         self, *, tenant_id: str, request_options: typing.Optional[RequestOptions] = None
     ) -> AsyncHttpResponse[EmbeddingsCreateCollectionData]:
         """
-        Create an embeddings collection for the given tenant in Findr.
-
-        sub_tenant_id is set to be the same as tenant_id as per requirements.
+        Create an embeddings collection for a tenant.
 
-        Returns:
-            EmbeddingsCreateCollectionData: Success response with collection details
+        Use this to initialize storage so you can index and query embeddings for the tenant.
 
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -1051,7 +1021,7 @@ class AsyncRawEmbeddingsClient:
             Successful Response
         """
         _response = await self._client_wrapper.httpx_client.request(
-            "embeddings/create_embeddings_tenant",
+            "embeddings/create_tenant",
             method="POST",
             params={
                 "tenant_id": tenant_id,

usecortex_ai/fetch/client.py

@@ -62,7 +62,7 @@ class FetchClient:
         from usecortex-ai import CortexAI
 
         client = CortexAI(token="YOUR_TOKEN", )
-        client.fetch.fetch_content(file_id='file_id', file_type='file_type', tenant_id='tenant_id', )
+        client.fetch.fetch_content(file_id='CortexDoc1234', file_type='<file_type>', tenant_id='tenant_1234', )
         """
         _response = self._raw_client.fetch_content(
             file_id=file_id,
@@ -129,7 +129,7 @@ class AsyncFetchClient:
 
         client = AsyncCortexAI(token="YOUR_TOKEN", )
         async def main() -> None:
-            await client.fetch.fetch_content(file_id='file_id', file_type='file_type', tenant_id='tenant_id', )
+            await client.fetch.fetch_content(file_id='CortexDoc1234', file_type='<file_type>', tenant_id='tenant_1234', )
         asyncio.run(main())
         """
         _response = await self._raw_client.fetch_content(