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

usecortex_ai/upload/client.py

@@ -8,7 +8,6 @@ from ..core.request_options import RequestOptions
 from ..types.app_sources_upload_data import AppSourcesUploadData
 from ..types.batch_upload_data import BatchUploadData
 from ..types.processing_status import ProcessingStatus
-from ..types.relations import Relations
 from ..types.single_upload_data import SingleUploadData
 from ..types.source_model import SourceModel
 from .raw_client import AsyncRawUploadClient, RawUploadClient
@@ -38,26 +37,44 @@ class UploadClient:
         tenant_id: str,
         files: typing.List[core.File],
         sub_tenant_id: typing.Optional[str] = None,
+        file_ids: typing.Optional[str] = OMIT,
         tenant_metadata: typing.Optional[str] = OMIT,
         document_metadata: typing.Optional[str] = OMIT,
-        relations: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> BatchUploadData:
         """
+        Upload multiple documents simultaneously for efficient bulk processing.
+
+        This endpoint allows you to upload several files at once, which is ideal for large document collections or periodic data imports. Each file gets processed asynchronously, and you can track the progress of individual files using their returned file IDs.
+
+        The system automatically handles file parsing, content extraction, and indexing across all uploaded documents. You'll receive confirmation once all files are queued for processing.
+
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         files : typing.List[core.File]
             See core.File for more documentation
 
         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.
+
+        file_ids : typing.Optional[str]
+            Optional JSON string array of file IDs for the uploaded content. If not provided or empty, will be generated automatically.
 
         tenant_metadata : typing.Optional[str]
+            JSON string containing tenant-level document metadata (e.g., department, compliance_tag)
+
+            Example: > "{"department":"Finance","compliance_tag":"GDPR"}"
+
 
         document_metadata : typing.Optional[str]
+            JSON string containing document-specific metadata (e.g., title, author, file_id). If file_id is not provided, the system will generate an ID automatically.
+
+            Example: > "{"title":"Q1 Report.pdf","author":"Alice Smith","file_id":"custom_file_123"}"
+
 
-        relations : typing.Optional[str]
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -72,15 +89,15 @@ class UploadClient:
         from usecortex-ai import CortexAI
 
         client = CortexAI(token="YOUR_TOKEN", )
-        client.upload.batch_upload(tenant_id='tenant_id', )
+        client.upload.batch_upload(tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', )
         """
         _response = self._raw_client.batch_upload(
             tenant_id=tenant_id,
             files=files,
             sub_tenant_id=sub_tenant_id,
+            file_ids=file_ids,
             tenant_metadata=tenant_metadata,
             document_metadata=document_metadata,
-            relations=relations,
             request_options=request_options,
         )
         return _response.data
@@ -94,26 +111,41 @@ class UploadClient:
         source_ids: typing.Optional[typing.List[str]] = OMIT,
         tenant_metadata: typing.Optional[str] = OMIT,
         document_metadata: typing.Optional[str] = OMIT,
-        relations: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> BatchUploadData:
         """
+        Update multiple existing documents with new content and metadata.
+
+        Use this endpoint when you need to replace or modify several documents that are already in your knowledge base. Each file must correspond to an existing source ID, ensuring that updates are applied to the correct documents.
+
+        The system processes updates asynchronously, allowing you to continue working while your documents are re-indexed. Track the progress using the returned file IDs to know when updates are complete.
+
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         files : typing.List[core.File]
             See core.File for more documentation
 
         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.
 
         source_ids : typing.Optional[typing.List[str]]
+            List of source IDs corresponding to the files being updated
 
         tenant_metadata : typing.Optional[str]
+            JSON string containing tenant-level document metadata (e.g., department, compliance_tag)
+
+            Example: > "{"department":"Finance","compliance_tag":"GDPR"}"
+
 
         document_metadata : typing.Optional[str]
+            JSON string containing document-specific metadata (e.g., title, author, file_id). If file_id is not provided, the system will generate an ID automatically.
+
+            Example: > "{"title":"Q1 Report.pdf","author":"Alice Smith","file_id":"custom_file_123"}"
+
 
-        relations : typing.Optional[str]
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -128,7 +160,7 @@ class UploadClient:
         from usecortex-ai import CortexAI
 
         client = CortexAI(token="YOUR_TOKEN", )
-        client.upload.batch_update(tenant_id='tenant_id', )
+        client.upload.batch_update(tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', )
         """
         _response = self._raw_client.batch_update(
             tenant_id=tenant_id,
@@ -137,7 +169,6 @@ class UploadClient:
             source_ids=source_ids,
             tenant_metadata=tenant_metadata,
             document_metadata=document_metadata,
-            relations=relations,
             request_options=request_options,
         )
         return _response.data
@@ -148,26 +179,44 @@ class UploadClient:
         tenant_id: str,
         file: core.File,
         sub_tenant_id: typing.Optional[str] = None,
+        file_id: typing.Optional[str] = OMIT,
         tenant_metadata: typing.Optional[str] = OMIT,
         document_metadata: typing.Optional[str] = OMIT,
-        relations: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SingleUploadData:
         """
+        Upload a single document for processing and indexing into your knowledge base.
+
+        This endpoint accepts documents in various formats and processes them for search and retrieval. You can include custom metadata to help organize and categorize your content.
+
+        The system extracts text content, processes it asynchronously, and makes it available for search queries. You can track the processing status using the returned file ID.
+
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         file : core.File
             See core.File for more documentation
 
         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.
+
+        file_id : typing.Optional[str]
+            Optional file ID for the uploaded content. If not provided, will be generated automatically.
 
         tenant_metadata : typing.Optional[str]
+            JSON string containing tenant-level document metadata (e.g., department, compliance_tag)
+
+            Example: > "{"department":"Finance","compliance_tag":"GDPR"}"
+
 
         document_metadata : typing.Optional[str]
+            JSON string containing document-specific metadata (e.g., title, author, file_id). If file_id is not provided, the system will generate an ID automatically.
+
+            Example: > "{"title":"Q1 Report.pdf","author":"Alice Smith","file_id":"custom_file_123"}"
+
 
-        relations : typing.Optional[str]
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -182,15 +231,15 @@ class UploadClient:
         from usecortex-ai import CortexAI
 
         client = CortexAI(token="YOUR_TOKEN", )
-        client.upload.upload_document(tenant_id='tenant_id', )
+        client.upload.upload_document(tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', )
         """
         _response = self._raw_client.upload_document(
             tenant_id=tenant_id,
             file=file,
             sub_tenant_id=sub_tenant_id,
+            file_id=file_id,
             tenant_metadata=tenant_metadata,
             document_metadata=document_metadata,
-            relations=relations,
             request_options=request_options,
         )
         return _response.data
@@ -204,26 +253,41 @@ class UploadClient:
         sub_tenant_id: typing.Optional[str] = None,
         tenant_metadata: typing.Optional[str] = OMIT,
         document_metadata: typing.Optional[str] = OMIT,
-        relations: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SingleUploadData:
         """
+        Replace an existing document with updated content.
+
+        This endpoint allows you to update a specific document that's already in your knowledge base. Provide the source ID of the document you want to modify, along with the new file content.
+
+        The system will process your update asynchronously and re-index the document with the new content. You can monitor the progress using the returned file ID.
+
         Parameters
         ----------
         source_id : str
+            The source ID of the document to update
 
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         file : core.File
             See core.File for more documentation
 
         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.
 
         tenant_metadata : typing.Optional[str]
+            JSON string containing tenant-level document metadata (e.g., department, compliance_tag)
+
+            Example: > "{"department":"Finance","compliance_tag":"GDPR"}"
+
 
         document_metadata : typing.Optional[str]
+            JSON string containing document-specific metadata (e.g., title, author, file_id). If file_id is not provided, the system will generate an ID automatically.
+
+            Example: > "{"title":"Q1 Report.pdf","author":"Alice Smith","file_id":"custom_file_123"}"
+
 
-        relations : typing.Optional[str]
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -238,7 +302,7 @@ class UploadClient:
         from usecortex-ai import CortexAI
 
         client = CortexAI(token="YOUR_TOKEN", )
-        client.upload.update_document(source_id='source_id', tenant_id='tenant_id', )
+        client.upload.update_document(source_id='CortexDoc1234', tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', )
         """
         _response = self._raw_client.update_document(
             source_id=source_id,
@@ -247,7 +311,6 @@ class UploadClient:
             sub_tenant_id=sub_tenant_id,
             tenant_metadata=tenant_metadata,
             document_metadata=document_metadata,
-            relations=relations,
             request_options=request_options,
         )
         return _response.data
@@ -261,13 +324,21 @@ class UploadClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AppSourcesUploadData:
         """
+        Upload structured data from applications or APIs for indexing.
+
+        This endpoint is designed for importing data from applications. If you are specifically using Cortex to provide search to an application, you should prefer this endpoint. It accepts structured source objects and allows you to clearly define contents of attachments
+
+        The system processes each source asynchronously and makes the content available for search and retrieval. Use this when you need to integrate search and indexing from data in your applications into your knowledge base.
+
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         request : typing.Sequence[SourceModel]
 
         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 +353,7 @@ class UploadClient:
         from usecortex-ai import CortexAI, SourceModel
 
         client = CortexAI(token="YOUR_TOKEN", )
-        client.upload.upload_app_sources(tenant_id='tenant_id', request=[SourceModel()], )
+        client.upload.upload_app_sources(tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', request=[SourceModel()], )
         """
         _response = self._raw_client.upload_app_sources(
             tenant_id=tenant_id, request=request, sub_tenant_id=sub_tenant_id, request_options=request_options
@@ -295,28 +366,42 @@ class UploadClient:
         tenant_id: str,
         content: str,
         sub_tenant_id: typing.Optional[str] = None,
+        file_id: typing.Optional[str] = OMIT,
         tenant_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         document_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
-        relations: typing.Optional[Relations] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SingleUploadData:
         """
-        Upload markdown content. If request.document_metadata contains a 'file_id' key (non-empty), it will be used as the file ID;
-        otherwise, a new file_id will be generated for that file. This allows file-specific IDs to be set directly in the metadata.
+        Upload text or markdown content directly for processing.
+
+        This endpoint accepts plain text or markdown-formatted content that you want to add to your knowledge base. It's perfect for notes, documentation, articles, or any text-based content you want to make searchable.
+
+        You can include custom metadata to help organize and categorize your content. You can track the processing status using the returned file ID.
 
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         content : str
+            The text or markdown content to upload
 
         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.
+
+        file_id : typing.Optional[str]
+            Optional file ID for the uploaded content. If not provided, will be generated automatically.
 
         tenant_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            JSON string containing tenant-level document metadata (e.g., department, compliance_tag)
+
+            Example: > "{"department":"Finance","compliance_tag":"GDPR"}"
 
         document_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            JSON string containing document-specific metadata (e.g., title, author, file_id). If file_id is not provided, the system will generate an ID automatically.
+
+            Example: > "{"title":"Q1 Report.pdf","author":"Alice Smith","file_id":"custom_file_123"}"
 
-        relations : typing.Optional[Relations]
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -331,15 +416,15 @@ class UploadClient:
         from usecortex-ai import CortexAI
 
         client = CortexAI(token="YOUR_TOKEN", )
-        client.upload.upload_markdown(tenant_id='tenant_id', content='content', )
+        client.upload.upload_markdown(tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', content='<content>', )
         """
         _response = self._raw_client.upload_markdown(
             tenant_id=tenant_id,
             content=content,
             sub_tenant_id=sub_tenant_id,
+            file_id=file_id,
             tenant_metadata=tenant_metadata,
             document_metadata=document_metadata,
-            relations=relations,
             request_options=request_options,
         )
         return _response.data
@@ -350,28 +435,42 @@ class UploadClient:
         tenant_id: str,
         content: str,
         sub_tenant_id: typing.Optional[str] = None,
+        file_id: typing.Optional[str] = OMIT,
         tenant_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         document_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
-        relations: typing.Optional[Relations] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SingleUploadData:
         """
-        Upload markdown content. If request.document_metadata contains a 'file_id' key (non-empty), it will be used as the file ID;
-        otherwise, a new file_id will be generated for that file. This allows file-specific IDs to be set directly in the metadata.
+        Upload text or markdown content directly for processing.
+
+        This endpoint accepts plain text or markdown-formatted content that you want to add to your knowledge base. It's perfect for notes, documentation, articles, or any text-based content you want to make searchable.
+
+        You can include custom metadata to help organize and categorize your content. You can track the processing status using the returned file ID.
 
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         content : str
+            The text or markdown content to upload
 
         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.
+
+        file_id : typing.Optional[str]
+            Optional file ID for the uploaded content. If not provided, will be generated automatically.
 
         tenant_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            JSON string containing tenant-level document metadata (e.g., department, compliance_tag)
+
+            Example: > "{"department":"Finance","compliance_tag":"GDPR"}"
 
         document_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            JSON string containing document-specific metadata (e.g., title, author, file_id). If file_id is not provided, the system will generate an ID automatically.
+
+            Example: > "{"title":"Q1 Report.pdf","author":"Alice Smith","file_id":"custom_file_123"}"
 
-        relations : typing.Optional[Relations]
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -386,15 +485,15 @@ class UploadClient:
         from usecortex-ai import CortexAI
 
         client = CortexAI(token="YOUR_TOKEN", )
-        client.upload.upload_text(tenant_id='tenant_id', content='content', )
+        client.upload.upload_text(tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', content='<content>', )
         """
         _response = self._raw_client.upload_text(
             tenant_id=tenant_id,
             content=content,
             sub_tenant_id=sub_tenant_id,
+            file_id=file_id,
             tenant_metadata=tenant_metadata,
             document_metadata=document_metadata,
-            relations=relations,
             request_options=request_options,
         )
         return _response.data
@@ -406,27 +505,45 @@ class UploadClient:
         tenant_id: str,
         content: str,
         sub_tenant_id: typing.Optional[str] = None,
+        file_id: typing.Optional[str] = OMIT,
         tenant_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         document_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
-        relations: typing.Optional[Relations] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SingleUploadData:
         """
+        Update existing text or markdown content with new information.
+
+        This endpoint allows you to modify text or markdown content that's already in your knowledge base. Provide the source ID of the content you want to update, along with the new text.
+
+        The system will reprocess and re-index the updated content asynchronously. Use this when you need to correct information, add details, or refresh existing documentation.
+
         Parameters
         ----------
         source_id : str
+            The source ID of the document to update
 
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         content : str
+            The text or markdown content to upload
 
         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.
+
+        file_id : typing.Optional[str]
+            Optional file ID for the uploaded content. If not provided, will be generated automatically.
 
         tenant_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            JSON string containing tenant-level document metadata (e.g., department, compliance_tag)
+
+            Example: > "{"department":"Finance","compliance_tag":"GDPR"}"
 
         document_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            JSON string containing document-specific metadata (e.g., title, author, file_id). If file_id is not provided, the system will generate an ID automatically.
+
+            Example: > "{"title":"Q1 Report.pdf","author":"Alice Smith","file_id":"custom_file_123"}"
 
-        relations : typing.Optional[Relations]
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -441,16 +558,16 @@ class UploadClient:
         from usecortex-ai import CortexAI
 
         client = CortexAI(token="YOUR_TOKEN", )
-        client.upload.update_markdown(source_id='source_id', tenant_id='tenant_id', content='content', )
+        client.upload.update_markdown(source_id='CortexDoc1234', tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', content='<content>', )
         """
         _response = self._raw_client.update_markdown(
             source_id=source_id,
             tenant_id=tenant_id,
             content=content,
             sub_tenant_id=sub_tenant_id,
+            file_id=file_id,
             tenant_metadata=tenant_metadata,
             document_metadata=document_metadata,
-            relations=relations,
             request_options=request_options,
         )
         return _response.data
@@ -462,27 +579,45 @@ class UploadClient:
         tenant_id: str,
         content: str,
         sub_tenant_id: typing.Optional[str] = None,
+        file_id: typing.Optional[str] = OMIT,
         tenant_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         document_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
-        relations: typing.Optional[Relations] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SingleUploadData:
         """
+        Update existing text or markdown content with new information.
+
+        This endpoint allows you to modify text or markdown content that's already in your knowledge base. Provide the source ID of the content you want to update, along with the new text.
+
+        The system will reprocess and re-index the updated content asynchronously. Use this when you need to correct information, add details, or refresh existing documentation.
+
         Parameters
         ----------
         source_id : str
+            The source ID of the document to update
 
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         content : str
+            The text or markdown content to upload
 
         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.
+
+        file_id : typing.Optional[str]
+            Optional file ID for the uploaded content. If not provided, will be generated automatically.
 
         tenant_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            JSON string containing tenant-level document metadata (e.g., department, compliance_tag)
+
+            Example: > "{"department":"Finance","compliance_tag":"GDPR"}"
 
         document_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            JSON string containing document-specific metadata (e.g., title, author, file_id). If file_id is not provided, the system will generate an ID automatically.
+
+            Example: > "{"title":"Q1 Report.pdf","author":"Alice Smith","file_id":"custom_file_123"}"
 
-        relations : typing.Optional[Relations]
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -497,16 +632,16 @@ class UploadClient:
         from usecortex-ai import CortexAI
 
         client = CortexAI(token="YOUR_TOKEN", )
-        client.upload.update_text(source_id='source_id', tenant_id='tenant_id', content='content', )
+        client.upload.update_text(source_id='CortexDoc1234', tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', content='<content>', )
         """
         _response = self._raw_client.update_text(
             source_id=source_id,
             tenant_id=tenant_id,
             content=content,
             sub_tenant_id=sub_tenant_id,
+            file_id=file_id,
             tenant_metadata=tenant_metadata,
             document_metadata=document_metadata,
-            relations=relations,
             request_options=request_options,
         )
         return _response.data
@@ -521,15 +656,25 @@ class UploadClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SingleUploadData:
         """
+        Upload pre-computed embeddings for advanced similarity search.
+
+        This endpoint accepts vector embeddings that you've generated externally, allowing you to integrate with custom embedding models or existing vector databases. The embeddings represent chunks of your content as numerical vectors.
+
+        The system stores these embeddings and makes them available for semantic search and similarity matching. Use this when you want to leverage specialized embedding models or have existing vector representations.
+
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         embeddings : typing.Sequence[typing.Sequence[float]]
+            The embeddings of source you want to index
 
         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.
 
         file_id : typing.Optional[str]
+            The Source ID of the target source you want to index
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -544,7 +689,7 @@ class UploadClient:
         from usecortex-ai import CortexAI
 
         client = CortexAI(token="YOUR_TOKEN", )
-        client.upload.upload_embeddings(tenant_id='tenant_id', embeddings=[[1.1]], )
+        client.upload.upload_embeddings(tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', embeddings=[[0.123413, 0.655367, 0.987654, 0.123456, 0.789012], [0.123413, 0.655367, 0.987654, 0.123456, 0.789012]], )
         """
         _response = self._raw_client.upload_embeddings(
             tenant_id=tenant_id,
@@ -564,13 +709,22 @@ class UploadClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SingleUploadData:
         """
+        Update existing embeddings with new vector representations.
+
+        This endpoint allows you to modify embeddings that are already stored in your knowledge base. Provide updated vector representations for specific chunks of content, identified by their chunk IDs.
+
+        The system will replace the existing embeddings with your new ones, ensuring that similarity searches reflect the most current vector representations. Use this when you need to update embeddings due to model improvements or content changes.
+
         Parameters
         ----------
         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.
 
         embeddings : typing.Optional[typing.Dict[str, typing.Sequence[float]]]
+            The embeddings of source you want to index
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -585,7 +739,7 @@ class UploadClient:
         from usecortex-ai import CortexAI
 
         client = CortexAI(token="YOUR_TOKEN", )
-        client.upload.update_embeddings(tenant_id='tenant_id', )
+        client.upload.update_embeddings(tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', )
         """
         _response = self._raw_client.update_embeddings(
             tenant_id=tenant_id, sub_tenant_id=sub_tenant_id, embeddings=embeddings, request_options=request_options
@@ -599,21 +753,28 @@ class UploadClient:
         tenant_id: str,
         sub_tenant_id: typing.Optional[str] = None,
         file_id: typing.Optional[str] = None,
-        relations: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SingleUploadData:
         """
+        Extract and index content from web pages automatically.
+
+        This endpoint initiates web scraping for the specified URL, extracting the main content, text, and structure from the webpage. It's perfect for capturing articles, documentation, or any web content you want to include in your knowledge base.
+
+        The system processes the webpage content asynchronously, cleaning and structuring the information for optimal search and retrieval. Use this when you need to add web content without manual copying and pasting.
+
         Parameters
         ----------
         web_url : str
+            The URL of the webpage to scrape and index
 
         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.
 
         file_id : typing.Optional[str]
-
-        relations : typing.Optional[str]
+            Optional custom file ID for the scraped content. If not provided, a unique ID will be generated
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -628,14 +789,13 @@ class UploadClient:
         from usecortex-ai import CortexAI
 
         client = CortexAI(token="YOUR_TOKEN", )
-        client.upload.scrape_webpage(web_url='web_url', tenant_id='tenant_id', )
+        client.upload.scrape_webpage(web_url='https://www.usecortex.ai/', tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', file_id='CortexDoc1234', )
         """
         _response = self._raw_client.scrape_webpage(
             web_url=web_url,
             tenant_id=tenant_id,
             sub_tenant_id=sub_tenant_id,
             file_id=file_id,
-            relations=relations,
             request_options=request_options,
         )
         return _response.data
@@ -647,21 +807,28 @@ class UploadClient:
         source_id: str,
         tenant_id: str,
         sub_tenant_id: typing.Optional[str] = None,
-        relations: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SingleUploadData:
         """
+        Update web scraping content with fresh data from the source URL.
+
+        This endpoint refreshes the content for an existing web scraping job. Provide the source ID of the webpage content you want to update, and the system will re-scrape the URL to capture any changes.
+
+        The updated content gets processed asynchronously and re-indexed in your knowledge base. Use this to keep web content current when the source pages are frequently updated.
+
         Parameters
         ----------
         web_url : str
+            The URL of the webpage to re-scrape
 
         source_id : str
+            The file ID of the existing web scraping job to update
 
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         sub_tenant_id : typing.Optional[str]
-
-        relations : 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.
@@ -676,14 +843,13 @@ class UploadClient:
         from usecortex-ai import CortexAI
 
         client = CortexAI(token="YOUR_TOKEN", )
-        client.upload.update_webpage(web_url='web_url', source_id='source_id', tenant_id='tenant_id', )
+        client.upload.update_webpage(web_url='https://www.usecortex.ai/', source_id='CortexDoc1234', tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', )
         """
         _response = self._raw_client.update_webpage(
             web_url=web_url,
             source_id=source_id,
             tenant_id=tenant_id,
             sub_tenant_id=sub_tenant_id,
-            relations=relations,
             request_options=request_options,
         )
         return _response.data
@@ -697,13 +863,22 @@ class UploadClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.Optional[typing.Any]:
         """
+        Remove documents and content from your knowledge base.
+
+        This endpoint permanently deletes the specified sources from your knowledge base. Once deleted, the content will no longer be available for search or retrieval.
+
+        Use this carefully as the action cannot be undone. The system will confirm successful deletion of each source ID you specify.
+
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         source_ids : typing.Sequence[str]
+            List of source IDs to delete
 
         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.
@@ -718,7 +893,7 @@ class UploadClient:
         from usecortex-ai import CortexAI
 
         client = CortexAI(token="YOUR_TOKEN", )
-        client.upload.delete_source(tenant_id='tenant_id', source_ids=['source_ids'], )
+        client.upload.delete_source(tenant_id='tenant_1234', source_ids=['CortexDoc1234', 'CortexDoc4567'], )
         """
         _response = self._raw_client.delete_source(
             tenant_id=tenant_id, source_ids=source_ids, sub_tenant_id=sub_tenant_id, request_options=request_options
@@ -734,13 +909,22 @@ class UploadClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.Optional[typing.Any]:
         """
+        Remove documents and content from your knowledge base.
+
+        This endpoint permanently deletes the specified sources from your knowledge base. Once deleted, the content will no longer be available for search or retrieval.
+
+        Use this carefully as the action cannot be undone. The system will confirm successful deletion of each source ID you specify.
+
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         source_ids : typing.Sequence[str]
+            List of source IDs to delete
 
         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.
@@ -755,7 +939,7 @@ class UploadClient:
         from usecortex-ai import CortexAI
 
         client = CortexAI(token="YOUR_TOKEN", )
-        client.upload.delete_memory(tenant_id='tenant_id', source_ids=['source_ids'], )
+        client.upload.delete_memory(tenant_id='tenant_1234', source_ids=['CortexDoc1234', 'CortexDoc4567'], )
         """
         _response = self._raw_client.delete_memory(
             tenant_id=tenant_id, source_ids=source_ids, sub_tenant_id=sub_tenant_id, request_options=request_options
@@ -770,16 +954,19 @@ class UploadClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ProcessingStatus:
         """
-        Verify the processing status of an uploaded file.
+        Check the current processing status of your uploaded content.
+
+        This endpoint allows you to monitor the progress of documents, text, or other content you've uploaded. Simply provide the file ID to see whether processing is complete, still in progress, or if any errors occurred.
 
-        Returns:
-            ProcessingStatusResponse: Processing status information
+        Use this to determine when your content is ready for search and retrieval, or to troubleshoot any processing issues.
 
         Parameters
         ----------
         file_id : str
+            The file ID to check processing status for
 
         tenant_id : typing.Optional[str]
+            Unique identifier for the tenant/organization
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -794,7 +981,7 @@ class UploadClient:
         from usecortex-ai import CortexAI
 
         client = CortexAI(token="YOUR_TOKEN", )
-        client.upload.verify_processing(file_id='file_id', )
+        client.upload.verify_processing(file_id='CortexDoc1234', tenant_id='tenant_1234', )
         """
         _response = self._raw_client.verify_processing(
             file_id=file_id, tenant_id=tenant_id, request_options=request_options
@@ -823,26 +1010,44 @@ class AsyncUploadClient:
         tenant_id: str,
         files: typing.List[core.File],
         sub_tenant_id: typing.Optional[str] = None,
+        file_ids: typing.Optional[str] = OMIT,
         tenant_metadata: typing.Optional[str] = OMIT,
         document_metadata: typing.Optional[str] = OMIT,
-        relations: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> BatchUploadData:
         """
+        Upload multiple documents simultaneously for efficient bulk processing.
+
+        This endpoint allows you to upload several files at once, which is ideal for large document collections or periodic data imports. Each file gets processed asynchronously, and you can track the progress of individual files using their returned file IDs.
+
+        The system automatically handles file parsing, content extraction, and indexing across all uploaded documents. You'll receive confirmation once all files are queued for processing.
+
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         files : typing.List[core.File]
             See core.File for more documentation
 
         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.
+
+        file_ids : typing.Optional[str]
+            Optional JSON string array of file IDs for the uploaded content. If not provided or empty, will be generated automatically.
 
         tenant_metadata : typing.Optional[str]
+            JSON string containing tenant-level document metadata (e.g., department, compliance_tag)
+
+            Example: > "{"department":"Finance","compliance_tag":"GDPR"}"
+
 
         document_metadata : typing.Optional[str]
+            JSON string containing document-specific metadata (e.g., title, author, file_id). If file_id is not provided, the system will generate an ID automatically.
+
+            Example: > "{"title":"Q1 Report.pdf","author":"Alice Smith","file_id":"custom_file_123"}"
+
 
-        relations : typing.Optional[str]
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -860,16 +1065,16 @@ class AsyncUploadClient:
 
         client = AsyncCortexAI(token="YOUR_TOKEN", )
         async def main() -> None:
-            await client.upload.batch_upload(tenant_id='tenant_id', )
+            await client.upload.batch_upload(tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', )
         asyncio.run(main())
         """
         _response = await self._raw_client.batch_upload(
             tenant_id=tenant_id,
             files=files,
             sub_tenant_id=sub_tenant_id,
+            file_ids=file_ids,
             tenant_metadata=tenant_metadata,
             document_metadata=document_metadata,
-            relations=relations,
             request_options=request_options,
         )
         return _response.data
@@ -883,26 +1088,41 @@ class AsyncUploadClient:
         source_ids: typing.Optional[typing.List[str]] = OMIT,
         tenant_metadata: typing.Optional[str] = OMIT,
         document_metadata: typing.Optional[str] = OMIT,
-        relations: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> BatchUploadData:
         """
+        Update multiple existing documents with new content and metadata.
+
+        Use this endpoint when you need to replace or modify several documents that are already in your knowledge base. Each file must correspond to an existing source ID, ensuring that updates are applied to the correct documents.
+
+        The system processes updates asynchronously, allowing you to continue working while your documents are re-indexed. Track the progress using the returned file IDs to know when updates are complete.
+
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         files : typing.List[core.File]
             See core.File for more documentation
 
         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.
 
         source_ids : typing.Optional[typing.List[str]]
+            List of source IDs corresponding to the files being updated
 
         tenant_metadata : typing.Optional[str]
+            JSON string containing tenant-level document metadata (e.g., department, compliance_tag)
+
+            Example: > "{"department":"Finance","compliance_tag":"GDPR"}"
+
 
         document_metadata : typing.Optional[str]
+            JSON string containing document-specific metadata (e.g., title, author, file_id). If file_id is not provided, the system will generate an ID automatically.
+
+            Example: > "{"title":"Q1 Report.pdf","author":"Alice Smith","file_id":"custom_file_123"}"
+
 
-        relations : typing.Optional[str]
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -920,7 +1140,7 @@ class AsyncUploadClient:
 
         client = AsyncCortexAI(token="YOUR_TOKEN", )
         async def main() -> None:
-            await client.upload.batch_update(tenant_id='tenant_id', )
+            await client.upload.batch_update(tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', )
         asyncio.run(main())
         """
         _response = await self._raw_client.batch_update(
@@ -930,7 +1150,6 @@ class AsyncUploadClient:
             source_ids=source_ids,
             tenant_metadata=tenant_metadata,
             document_metadata=document_metadata,
-            relations=relations,
             request_options=request_options,
         )
         return _response.data
@@ -941,26 +1160,44 @@ class AsyncUploadClient:
         tenant_id: str,
         file: core.File,
         sub_tenant_id: typing.Optional[str] = None,
+        file_id: typing.Optional[str] = OMIT,
         tenant_metadata: typing.Optional[str] = OMIT,
         document_metadata: typing.Optional[str] = OMIT,
-        relations: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SingleUploadData:
         """
+        Upload a single document for processing and indexing into your knowledge base.
+
+        This endpoint accepts documents in various formats and processes them for search and retrieval. You can include custom metadata to help organize and categorize your content.
+
+        The system extracts text content, processes it asynchronously, and makes it available for search queries. You can track the processing status using the returned file ID.
+
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         file : core.File
             See core.File for more documentation
 
         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.
+
+        file_id : typing.Optional[str]
+            Optional file ID for the uploaded content. If not provided, will be generated automatically.
 
         tenant_metadata : typing.Optional[str]
+            JSON string containing tenant-level document metadata (e.g., department, compliance_tag)
+
+            Example: > "{"department":"Finance","compliance_tag":"GDPR"}"
+
 
         document_metadata : typing.Optional[str]
+            JSON string containing document-specific metadata (e.g., title, author, file_id). If file_id is not provided, the system will generate an ID automatically.
+
+            Example: > "{"title":"Q1 Report.pdf","author":"Alice Smith","file_id":"custom_file_123"}"
+
 
-        relations : typing.Optional[str]
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -978,16 +1215,16 @@ class AsyncUploadClient:
 
         client = AsyncCortexAI(token="YOUR_TOKEN", )
         async def main() -> None:
-            await client.upload.upload_document(tenant_id='tenant_id', )
+            await client.upload.upload_document(tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', )
         asyncio.run(main())
         """
         _response = await self._raw_client.upload_document(
             tenant_id=tenant_id,
             file=file,
             sub_tenant_id=sub_tenant_id,
+            file_id=file_id,
             tenant_metadata=tenant_metadata,
             document_metadata=document_metadata,
-            relations=relations,
             request_options=request_options,
         )
         return _response.data
@@ -1001,26 +1238,41 @@ class AsyncUploadClient:
         sub_tenant_id: typing.Optional[str] = None,
         tenant_metadata: typing.Optional[str] = OMIT,
         document_metadata: typing.Optional[str] = OMIT,
-        relations: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SingleUploadData:
         """
+        Replace an existing document with updated content.
+
+        This endpoint allows you to update a specific document that's already in your knowledge base. Provide the source ID of the document you want to modify, along with the new file content.
+
+        The system will process your update asynchronously and re-index the document with the new content. You can monitor the progress using the returned file ID.
+
         Parameters
         ----------
         source_id : str
+            The source ID of the document to update
 
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         file : core.File
             See core.File for more documentation
 
         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.
 
         tenant_metadata : typing.Optional[str]
+            JSON string containing tenant-level document metadata (e.g., department, compliance_tag)
+
+            Example: > "{"department":"Finance","compliance_tag":"GDPR"}"
+
 
         document_metadata : typing.Optional[str]
+            JSON string containing document-specific metadata (e.g., title, author, file_id). If file_id is not provided, the system will generate an ID automatically.
+
+            Example: > "{"title":"Q1 Report.pdf","author":"Alice Smith","file_id":"custom_file_123"}"
+
 
-        relations : typing.Optional[str]
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -1038,7 +1290,7 @@ class AsyncUploadClient:
 
         client = AsyncCortexAI(token="YOUR_TOKEN", )
         async def main() -> None:
-            await client.upload.update_document(source_id='source_id', tenant_id='tenant_id', )
+            await client.upload.update_document(source_id='CortexDoc1234', tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', )
         asyncio.run(main())
         """
         _response = await self._raw_client.update_document(
@@ -1048,7 +1300,6 @@ class AsyncUploadClient:
             sub_tenant_id=sub_tenant_id,
             tenant_metadata=tenant_metadata,
             document_metadata=document_metadata,
-            relations=relations,
             request_options=request_options,
         )
         return _response.data
@@ -1062,13 +1313,21 @@ class AsyncUploadClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AppSourcesUploadData:
         """
+        Upload structured data from applications or APIs for indexing.
+
+        This endpoint is designed for importing data from applications. If you are specifically using Cortex to provide search to an application, you should prefer this endpoint. It accepts structured source objects and allows you to clearly define contents of attachments
+
+        The system processes each source asynchronously and makes the content available for search and retrieval. Use this when you need to integrate search and indexing from data in your applications into your knowledge base.
+
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         request : typing.Sequence[SourceModel]
 
         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.
@@ -1086,7 +1345,7 @@ class AsyncUploadClient:
 
         client = AsyncCortexAI(token="YOUR_TOKEN", )
         async def main() -> None:
-            await client.upload.upload_app_sources(tenant_id='tenant_id', request=[SourceModel()], )
+            await client.upload.upload_app_sources(tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', request=[SourceModel()], )
         asyncio.run(main())
         """
         _response = await self._raw_client.upload_app_sources(
@@ -1100,28 +1359,42 @@ class AsyncUploadClient:
         tenant_id: str,
         content: str,
         sub_tenant_id: typing.Optional[str] = None,
+        file_id: typing.Optional[str] = OMIT,
         tenant_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         document_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
-        relations: typing.Optional[Relations] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SingleUploadData:
         """
-        Upload markdown content. If request.document_metadata contains a 'file_id' key (non-empty), it will be used as the file ID;
-        otherwise, a new file_id will be generated for that file. This allows file-specific IDs to be set directly in the metadata.
+        Upload text or markdown content directly for processing.
+
+        This endpoint accepts plain text or markdown-formatted content that you want to add to your knowledge base. It's perfect for notes, documentation, articles, or any text-based content you want to make searchable.
+
+        You can include custom metadata to help organize and categorize your content. You can track the processing status using the returned file ID.
 
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         content : str
+            The text or markdown content to upload
 
         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.
+
+        file_id : typing.Optional[str]
+            Optional file ID for the uploaded content. If not provided, will be generated automatically.
 
         tenant_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            JSON string containing tenant-level document metadata (e.g., department, compliance_tag)
+
+            Example: > "{"department":"Finance","compliance_tag":"GDPR"}"
 
         document_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            JSON string containing document-specific metadata (e.g., title, author, file_id). If file_id is not provided, the system will generate an ID automatically.
+
+            Example: > "{"title":"Q1 Report.pdf","author":"Alice Smith","file_id":"custom_file_123"}"
 
-        relations : typing.Optional[Relations]
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -1139,16 +1412,16 @@ class AsyncUploadClient:
 
         client = AsyncCortexAI(token="YOUR_TOKEN", )
         async def main() -> None:
-            await client.upload.upload_markdown(tenant_id='tenant_id', content='content', )
+            await client.upload.upload_markdown(tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', content='<content>', )
         asyncio.run(main())
         """
         _response = await self._raw_client.upload_markdown(
             tenant_id=tenant_id,
             content=content,
             sub_tenant_id=sub_tenant_id,
+            file_id=file_id,
             tenant_metadata=tenant_metadata,
             document_metadata=document_metadata,
-            relations=relations,
             request_options=request_options,
         )
         return _response.data
@@ -1159,28 +1432,42 @@ class AsyncUploadClient:
         tenant_id: str,
         content: str,
         sub_tenant_id: typing.Optional[str] = None,
+        file_id: typing.Optional[str] = OMIT,
         tenant_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         document_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
-        relations: typing.Optional[Relations] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SingleUploadData:
         """
-        Upload markdown content. If request.document_metadata contains a 'file_id' key (non-empty), it will be used as the file ID;
-        otherwise, a new file_id will be generated for that file. This allows file-specific IDs to be set directly in the metadata.
+        Upload text or markdown content directly for processing.
+
+        This endpoint accepts plain text or markdown-formatted content that you want to add to your knowledge base. It's perfect for notes, documentation, articles, or any text-based content you want to make searchable.
+
+        You can include custom metadata to help organize and categorize your content. You can track the processing status using the returned file ID.
 
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         content : str
+            The text or markdown content to upload
 
         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.
+
+        file_id : typing.Optional[str]
+            Optional file ID for the uploaded content. If not provided, will be generated automatically.
 
         tenant_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            JSON string containing tenant-level document metadata (e.g., department, compliance_tag)
+
+            Example: > "{"department":"Finance","compliance_tag":"GDPR"}"
 
         document_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            JSON string containing document-specific metadata (e.g., title, author, file_id). If file_id is not provided, the system will generate an ID automatically.
+
+            Example: > "{"title":"Q1 Report.pdf","author":"Alice Smith","file_id":"custom_file_123"}"
 
-        relations : typing.Optional[Relations]
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -1198,16 +1485,16 @@ class AsyncUploadClient:
 
         client = AsyncCortexAI(token="YOUR_TOKEN", )
         async def main() -> None:
-            await client.upload.upload_text(tenant_id='tenant_id', content='content', )
+            await client.upload.upload_text(tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', content='<content>', )
         asyncio.run(main())
         """
         _response = await self._raw_client.upload_text(
             tenant_id=tenant_id,
             content=content,
             sub_tenant_id=sub_tenant_id,
+            file_id=file_id,
             tenant_metadata=tenant_metadata,
             document_metadata=document_metadata,
-            relations=relations,
             request_options=request_options,
         )
         return _response.data
@@ -1219,27 +1506,45 @@ class AsyncUploadClient:
         tenant_id: str,
         content: str,
         sub_tenant_id: typing.Optional[str] = None,
+        file_id: typing.Optional[str] = OMIT,
         tenant_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         document_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
-        relations: typing.Optional[Relations] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SingleUploadData:
         """
+        Update existing text or markdown content with new information.
+
+        This endpoint allows you to modify text or markdown content that's already in your knowledge base. Provide the source ID of the content you want to update, along with the new text.
+
+        The system will reprocess and re-index the updated content asynchronously. Use this when you need to correct information, add details, or refresh existing documentation.
+
         Parameters
         ----------
         source_id : str
+            The source ID of the document to update
 
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         content : str
+            The text or markdown content to upload
 
         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.
+
+        file_id : typing.Optional[str]
+            Optional file ID for the uploaded content. If not provided, will be generated automatically.
 
         tenant_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            JSON string containing tenant-level document metadata (e.g., department, compliance_tag)
+
+            Example: > "{"department":"Finance","compliance_tag":"GDPR"}"
 
         document_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            JSON string containing document-specific metadata (e.g., title, author, file_id). If file_id is not provided, the system will generate an ID automatically.
+
+            Example: > "{"title":"Q1 Report.pdf","author":"Alice Smith","file_id":"custom_file_123"}"
 
-        relations : typing.Optional[Relations]
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -1257,7 +1562,7 @@ class AsyncUploadClient:
 
         client = AsyncCortexAI(token="YOUR_TOKEN", )
         async def main() -> None:
-            await client.upload.update_markdown(source_id='source_id', tenant_id='tenant_id', content='content', )
+            await client.upload.update_markdown(source_id='CortexDoc1234', tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', content='<content>', )
         asyncio.run(main())
         """
         _response = await self._raw_client.update_markdown(
@@ -1265,9 +1570,9 @@ class AsyncUploadClient:
             tenant_id=tenant_id,
             content=content,
             sub_tenant_id=sub_tenant_id,
+            file_id=file_id,
             tenant_metadata=tenant_metadata,
             document_metadata=document_metadata,
-            relations=relations,
             request_options=request_options,
         )
         return _response.data
@@ -1279,27 +1584,45 @@ class AsyncUploadClient:
         tenant_id: str,
         content: str,
         sub_tenant_id: typing.Optional[str] = None,
+        file_id: typing.Optional[str] = OMIT,
         tenant_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         document_metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
-        relations: typing.Optional[Relations] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SingleUploadData:
         """
+        Update existing text or markdown content with new information.
+
+        This endpoint allows you to modify text or markdown content that's already in your knowledge base. Provide the source ID of the content you want to update, along with the new text.
+
+        The system will reprocess and re-index the updated content asynchronously. Use this when you need to correct information, add details, or refresh existing documentation.
+
         Parameters
         ----------
         source_id : str
+            The source ID of the document to update
 
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         content : str
+            The text or markdown content to upload
 
         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.
+
+        file_id : typing.Optional[str]
+            Optional file ID for the uploaded content. If not provided, will be generated automatically.
 
         tenant_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            JSON string containing tenant-level document metadata (e.g., department, compliance_tag)
+
+            Example: > "{"department":"Finance","compliance_tag":"GDPR"}"
 
         document_metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            JSON string containing document-specific metadata (e.g., title, author, file_id). If file_id is not provided, the system will generate an ID automatically.
+
+            Example: > "{"title":"Q1 Report.pdf","author":"Alice Smith","file_id":"custom_file_123"}"
 
-        relations : typing.Optional[Relations]
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -1317,7 +1640,7 @@ class AsyncUploadClient:
 
         client = AsyncCortexAI(token="YOUR_TOKEN", )
         async def main() -> None:
-            await client.upload.update_text(source_id='source_id', tenant_id='tenant_id', content='content', )
+            await client.upload.update_text(source_id='CortexDoc1234', tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', content='<content>', )
         asyncio.run(main())
         """
         _response = await self._raw_client.update_text(
@@ -1325,9 +1648,9 @@ class AsyncUploadClient:
             tenant_id=tenant_id,
             content=content,
             sub_tenant_id=sub_tenant_id,
+            file_id=file_id,
             tenant_metadata=tenant_metadata,
             document_metadata=document_metadata,
-            relations=relations,
             request_options=request_options,
         )
         return _response.data
@@ -1342,15 +1665,25 @@ class AsyncUploadClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SingleUploadData:
         """
+        Upload pre-computed embeddings for advanced similarity search.
+
+        This endpoint accepts vector embeddings that you've generated externally, allowing you to integrate with custom embedding models or existing vector databases. The embeddings represent chunks of your content as numerical vectors.
+
+        The system stores these embeddings and makes them available for semantic search and similarity matching. Use this when you want to leverage specialized embedding models or have existing vector representations.
+
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         embeddings : typing.Sequence[typing.Sequence[float]]
+            The embeddings of source you want to index
 
         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.
 
         file_id : typing.Optional[str]
+            The Source ID of the target source you want to index
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -1368,7 +1701,7 @@ class AsyncUploadClient:
 
         client = AsyncCortexAI(token="YOUR_TOKEN", )
         async def main() -> None:
-            await client.upload.upload_embeddings(tenant_id='tenant_id', embeddings=[[1.1]], )
+            await client.upload.upload_embeddings(tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', embeddings=[[0.123413, 0.655367, 0.987654, 0.123456, 0.789012], [0.123413, 0.655367, 0.987654, 0.123456, 0.789012]], )
         asyncio.run(main())
         """
         _response = await self._raw_client.upload_embeddings(
@@ -1389,13 +1722,22 @@ class AsyncUploadClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SingleUploadData:
         """
+        Update existing embeddings with new vector representations.
+
+        This endpoint allows you to modify embeddings that are already stored in your knowledge base. Provide updated vector representations for specific chunks of content, identified by their chunk IDs.
+
+        The system will replace the existing embeddings with your new ones, ensuring that similarity searches reflect the most current vector representations. Use this when you need to update embeddings due to model improvements or content changes.
+
         Parameters
         ----------
         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.
 
         embeddings : typing.Optional[typing.Dict[str, typing.Sequence[float]]]
+            The embeddings of source you want to index
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -1413,7 +1755,7 @@ class AsyncUploadClient:
 
         client = AsyncCortexAI(token="YOUR_TOKEN", )
         async def main() -> None:
-            await client.upload.update_embeddings(tenant_id='tenant_id', )
+            await client.upload.update_embeddings(tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', )
         asyncio.run(main())
         """
         _response = await self._raw_client.update_embeddings(
@@ -1428,21 +1770,28 @@ class AsyncUploadClient:
         tenant_id: str,
         sub_tenant_id: typing.Optional[str] = None,
         file_id: typing.Optional[str] = None,
-        relations: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SingleUploadData:
         """
+        Extract and index content from web pages automatically.
+
+        This endpoint initiates web scraping for the specified URL, extracting the main content, text, and structure from the webpage. It's perfect for capturing articles, documentation, or any web content you want to include in your knowledge base.
+
+        The system processes the webpage content asynchronously, cleaning and structuring the information for optimal search and retrieval. Use this when you need to add web content without manual copying and pasting.
+
         Parameters
         ----------
         web_url : str
+            The URL of the webpage to scrape and index
 
         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.
 
         file_id : typing.Optional[str]
-
-        relations : typing.Optional[str]
+            Optional custom file ID for the scraped content. If not provided, a unique ID will be generated
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -1460,7 +1809,7 @@ class AsyncUploadClient:
 
         client = AsyncCortexAI(token="YOUR_TOKEN", )
         async def main() -> None:
-            await client.upload.scrape_webpage(web_url='web_url', tenant_id='tenant_id', )
+            await client.upload.scrape_webpage(web_url='https://www.usecortex.ai/', tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', file_id='CortexDoc1234', )
         asyncio.run(main())
         """
         _response = await self._raw_client.scrape_webpage(
@@ -1468,7 +1817,6 @@ class AsyncUploadClient:
             tenant_id=tenant_id,
             sub_tenant_id=sub_tenant_id,
             file_id=file_id,
-            relations=relations,
             request_options=request_options,
         )
         return _response.data
@@ -1480,21 +1828,28 @@ class AsyncUploadClient:
         source_id: str,
         tenant_id: str,
         sub_tenant_id: typing.Optional[str] = None,
-        relations: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SingleUploadData:
         """
+        Update web scraping content with fresh data from the source URL.
+
+        This endpoint refreshes the content for an existing web scraping job. Provide the source ID of the webpage content you want to update, and the system will re-scrape the URL to capture any changes.
+
+        The updated content gets processed asynchronously and re-indexed in your knowledge base. Use this to keep web content current when the source pages are frequently updated.
+
         Parameters
         ----------
         web_url : str
+            The URL of the webpage to re-scrape
 
         source_id : str
+            The file ID of the existing web scraping job to update
 
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         sub_tenant_id : typing.Optional[str]
-
-        relations : 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.
@@ -1512,7 +1867,7 @@ class AsyncUploadClient:
 
         client = AsyncCortexAI(token="YOUR_TOKEN", )
         async def main() -> None:
-            await client.upload.update_webpage(web_url='web_url', source_id='source_id', tenant_id='tenant_id', )
+            await client.upload.update_webpage(web_url='https://www.usecortex.ai/', source_id='CortexDoc1234', tenant_id='tenant_1234', sub_tenant_id='sub_tenant_4567', )
         asyncio.run(main())
         """
         _response = await self._raw_client.update_webpage(
@@ -1520,7 +1875,6 @@ class AsyncUploadClient:
             source_id=source_id,
             tenant_id=tenant_id,
             sub_tenant_id=sub_tenant_id,
-            relations=relations,
             request_options=request_options,
         )
         return _response.data
@@ -1534,13 +1888,22 @@ class AsyncUploadClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.Optional[typing.Any]:
         """
+        Remove documents and content from your knowledge base.
+
+        This endpoint permanently deletes the specified sources from your knowledge base. Once deleted, the content will no longer be available for search or retrieval.
+
+        Use this carefully as the action cannot be undone. The system will confirm successful deletion of each source ID you specify.
+
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         source_ids : typing.Sequence[str]
+            List of source IDs to delete
 
         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.
@@ -1558,7 +1921,7 @@ class AsyncUploadClient:
 
         client = AsyncCortexAI(token="YOUR_TOKEN", )
         async def main() -> None:
-            await client.upload.delete_source(tenant_id='tenant_id', source_ids=['source_ids'], )
+            await client.upload.delete_source(tenant_id='tenant_1234', source_ids=['CortexDoc1234', 'CortexDoc4567'], )
         asyncio.run(main())
         """
         _response = await self._raw_client.delete_source(
@@ -1575,13 +1938,22 @@ class AsyncUploadClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.Optional[typing.Any]:
         """
+        Remove documents and content from your knowledge base.
+
+        This endpoint permanently deletes the specified sources from your knowledge base. Once deleted, the content will no longer be available for search or retrieval.
+
+        Use this carefully as the action cannot be undone. The system will confirm successful deletion of each source ID you specify.
+
         Parameters
         ----------
         tenant_id : str
+            Unique identifier for the tenant/organization
 
         source_ids : typing.Sequence[str]
+            List of source IDs to delete
 
         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.
@@ -1599,7 +1971,7 @@ class AsyncUploadClient:
 
         client = AsyncCortexAI(token="YOUR_TOKEN", )
         async def main() -> None:
-            await client.upload.delete_memory(tenant_id='tenant_id', source_ids=['source_ids'], )
+            await client.upload.delete_memory(tenant_id='tenant_1234', source_ids=['CortexDoc1234', 'CortexDoc4567'], )
         asyncio.run(main())
         """
         _response = await self._raw_client.delete_memory(
@@ -1615,16 +1987,19 @@ class AsyncUploadClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ProcessingStatus:
         """
-        Verify the processing status of an uploaded file.
+        Check the current processing status of your uploaded content.
+
+        This endpoint allows you to monitor the progress of documents, text, or other content you've uploaded. Simply provide the file ID to see whether processing is complete, still in progress, or if any errors occurred.
 
-        Returns:
-            ProcessingStatusResponse: Processing status information
+        Use this to determine when your content is ready for search and retrieval, or to troubleshoot any processing issues.
 
         Parameters
         ----------
         file_id : str
+            The file ID to check processing status for
 
         tenant_id : typing.Optional[str]
+            Unique identifier for the tenant/organization
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -1642,7 +2017,7 @@ class AsyncUploadClient:
 
         client = AsyncCortexAI(token="YOUR_TOKEN", )
         async def main() -> None:
-            await client.upload.verify_processing(file_id='file_id', )
+            await client.upload.verify_processing(file_id='CortexDoc1234', tenant_id='tenant_1234', )
         asyncio.run(main())
         """
         _response = await self._raw_client.verify_processing(