groundx 2.0.15__py3-none-any.whl → 2.7.7__py3-none-any.whl

groundx/documents/client.py

@@ -1,27 +1,21 @@
 # This file was auto-generated by Fern from our API Definition.
 
 import typing
-from ..core.client_wrapper import SyncClientWrapper
-from ..types.ingest_remote_document import IngestRemoteDocument
+
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ..core.request_options import RequestOptions
+from ..types.document_list_response import DocumentListResponse
+from ..types.document_local_ingest_request import DocumentLocalIngestRequest
+from ..types.document_lookup_response import DocumentLookupResponse
+from ..types.document_response import DocumentResponse
+from ..types.ingest_remote_document import IngestRemoteDocument
 from ..types.ingest_response import IngestResponse
-from ..core.serialization import convert_and_respect_annotation_metadata
-from ..core.pydantic_utilities import parse_obj_as
-from ..errors.bad_request_error import BadRequestError
-from ..errors.unauthorized_error import UnauthorizedError
-from json.decoder import JSONDecodeError
-from ..core.api_error import ApiError
-from .types.documents_ingest_local_request_files_item import DocumentsIngestLocalRequestFilesItem
-from .types.website_crawl_request_websites_item import WebsiteCrawlRequestWebsitesItem
-from ..types.process_status_response import ProcessStatusResponse
-from ..core.jsonable_encoder import jsonable_encoder
+from ..types.processes_status_response import ProcessesStatusResponse
+from ..types.processing_status import ProcessingStatus
 from ..types.sort import Sort
 from ..types.sort_order import SortOrder
-from ..types.processing_status import ProcessingStatus
-from ..types.document_lookup_response import DocumentLookupResponse
-from ..types.document_list_response import DocumentListResponse
-from ..types.document_response import DocumentResponse
-from ..core.client_wrapper import AsyncClientWrapper
+from ..types.website_source import WebsiteSource
+from .raw_client import AsyncRawDocumentsClient, RawDocumentsClient
 
 # this is used as the default value for optional parameters
 OMIT = typing.cast(typing.Any, ...)
@@ -29,23 +23,42 @@ OMIT = typing.cast(typing.Any, ...)
 
 class DocumentsClient:
     def __init__(self, *, client_wrapper: SyncClientWrapper):
-        self._client_wrapper = client_wrapper
+        self._raw_client = RawDocumentsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawDocumentsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawDocumentsClient
+        """
+        return self._raw_client
 
     def ingest_remote(
         self,
         *,
         documents: typing.Sequence[IngestRemoteDocument],
+        callback_url: typing.Optional[str] = OMIT,
+        callback_data: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> IngestResponse:
         """
-        Ingest documents hosted on public URLs to a GroundX bucket.
+        Ingest documents hosted on public URLs into a GroundX bucket.
 
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
+        [Supported Document Types and Ingest Capacities](https://docs.eyelevel.ai/documentation/fundamentals/document-types-and-ingest-capacities)
 
         Parameters
         ----------
         documents : typing.Sequence[IngestRemoteDocument]
 
+        callback_url : typing.Optional[str]
+            An endpoint that will receive processing event updates as POST.
+
+        callback_data : typing.Optional[str]
+            A string that is returned, along with processing event updates, to the callback URL.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -65,76 +78,29 @@ class DocumentsClient:
             documents=[
                 IngestRemoteDocument(
                     bucket_id=1234,
-                    file_name="my_file.txt",
+                    file_name="my_file1.txt",
                     file_type="txt",
-                    search_data={"key": "value"},
-                    source_url="https://my.source.url.com/file.txt",
+                    source_url="https://my.source.url.com/file1.txt",
                 )
             ],
         )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            "v1/ingest/documents/remote",
-            method="POST",
-            json={
-                "documents": convert_and_respect_annotation_metadata(
-                    object_=documents, annotation=typing.Sequence[IngestRemoteDocument], direction="write"
-                ),
-            },
-            headers={
-                "content-type": "application/json",
-            },
-            request_options=request_options,
-            omit=OMIT,
+        _response = self._raw_client.ingest_remote(
+            documents=documents, callback_url=callback_url, callback_data=callback_data, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    IngestResponse,
-                    parse_obj_as(
-                        type_=IngestResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 401:
-                raise UnauthorizedError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        return _response.data
 
     def ingest_local(
-        self,
-        *,
-        files: typing.List[DocumentsIngestLocalRequestFilesItem],
-        request_options: typing.Optional[RequestOptions] = None,
+        self, *, request: DocumentLocalIngestRequest, request_options: typing.Optional[RequestOptions] = None
     ) -> IngestResponse:
         """
-        Upload documents hosted on a local file system for ingestion into a GroundX bucket.
+        Upload documents hosted on a local file system into a GroundX bucket.
 
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
+        [Supported Document Types and Ingest Capacities](https://docs.eyelevel.ai/documentation/fundamentals/document-types-and-ingest-capacities)
 
         Parameters
         ----------
-        files : typing.List[DocumentsIngestLocalRequestFilesItem]
+        request : DocumentLocalIngestRequest
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -146,81 +112,52 @@ class DocumentsClient:
 
         Examples
         --------
-        from groundx import GroundX
-        from groundx.documents import DocumentsIngestLocalRequestFilesItem
+        from groundx import GroundX, IngestLocalDocument, IngestLocalDocumentMetadata
 
         client = GroundX(
             api_key="YOUR_API_KEY",
         )
         client.documents.ingest_local(
-            files=[
-                DocumentsIngestLocalRequestFilesItem(
-                    bucket_id=1,
-                    file_data="fileData",
-                    file_name="fileName",
-                    file_type="txt",
+            request=[
+                IngestLocalDocument(
+                    blob="blob",
+                    metadata=IngestLocalDocumentMetadata(
+                        bucket_id=1234,
+                        file_name="my_file1.txt",
+                        file_type="txt",
+                    ),
                 )
             ],
         )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            "v1/ingest/documents/local",
-            method="POST",
-            data={
-                "files": files,
-            },
-            files={},
-            request_options=request_options,
-            omit=OMIT,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    IngestResponse,
-                    parse_obj_as(
-                        type_=IngestResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 401:
-                raise UnauthorizedError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        _response = self._raw_client.ingest_local(request=request, request_options=request_options)
+        return _response.data
 
     def crawl_website(
         self,
         *,
-        websites: typing.Sequence[WebsiteCrawlRequestWebsitesItem],
+        websites: typing.Sequence[WebsiteSource],
+        callback_url: typing.Optional[str] = OMIT,
+        callback_data: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> IngestResponse:
         """
         Upload the content of a publicly accessible website for ingestion into a GroundX bucket. This is done by following links within a specified URL, recursively, up to a specified depth or number of pages.
 
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
+        Note1: This endpoint is currently not supported for on-prem deployments.
+        Note2: The `source_url` must include the protocol, http:// or https://.
+
+        [Supported Document Types and Ingest Capacities](https://docs.eyelevel.ai/documentation/fundamentals/document-types-and-ingest-capacities)
 
         Parameters
         ----------
-        websites : typing.Sequence[WebsiteCrawlRequestWebsitesItem]
+        websites : typing.Sequence[WebsiteSource]
+
+        callback_url : typing.Optional[str]
+            The URL that will receive processing event updates.
+
+        callback_data : typing.Optional[str]
+            A string that is returned, along with processing event updates, to the callback URL.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -232,88 +169,68 @@ class DocumentsClient:
 
         Examples
         --------
-        from groundx import GroundX
-        from groundx.documents import WebsiteCrawlRequestWebsitesItem
+        from groundx import GroundX, WebsiteSource
 
         client = GroundX(
             api_key="YOUR_API_KEY",
         )
         client.documents.crawl_website(
             websites=[
-                WebsiteCrawlRequestWebsitesItem(
-                    bucket_id=123,
+                WebsiteSource(
+                    bucket_id=1234,
+                    cap=10,
+                    depth=2,
+                    search_data={"key": "value"},
                     source_url="https://my.website.com",
                 )
             ],
         )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            "v1/ingest/documents/website",
-            method="POST",
-            json={
-                "websites": convert_and_respect_annotation_metadata(
-                    object_=websites, annotation=typing.Sequence[WebsiteCrawlRequestWebsitesItem], direction="write"
-                ),
-            },
-            headers={
-                "content-type": "application/json",
-            },
-            request_options=request_options,
-            omit=OMIT,
+        _response = self._raw_client.crawl_website(
+            websites=websites, callback_url=callback_url, callback_data=callback_data, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    IngestResponse,
-                    parse_obj_as(
-                        type_=IngestResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 401:
-                raise UnauthorizedError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        return _response.data
 
-    def get_processing_status_by_id(
-        self, process_id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> ProcessStatusResponse:
+    def list(
+        self,
+        *,
+        n: typing.Optional[int] = None,
+        filter: typing.Optional[str] = None,
+        sort: typing.Optional[Sort] = None,
+        sort_order: typing.Optional[SortOrder] = None,
+        status: typing.Optional[ProcessingStatus] = None,
+        next_token: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> DocumentListResponse:
         """
-        Get the current status of an ingest, initiated with documents.ingest_remote, documents.ingest_local, or documents.crawl_website, by specifying the processId (the processId is included in the response of the documents.ingest functions).
-
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
+        lookup all documents across all resources which are currently on GroundX
 
         Parameters
         ----------
-        process_id : str
-            the processId for the ingest process being checked
+        n : typing.Optional[int]
+            The maximum number of returned documents. Accepts 1-100 with a default of 20.
+
+        filter : typing.Optional[str]
+            Only documents with names that contain the filter string will be returned in the results.
+
+        sort : typing.Optional[Sort]
+            The document attribute that will be used to sort the results.
+
+        sort_order : typing.Optional[SortOrder]
+            The order in which to sort the results. A value for sort must also be set.
+
+        status : typing.Optional[ProcessingStatus]
+            A status filter on the get documents query. If this value is set, then only documents with this status will be returned in the results.
+
+        next_token : typing.Optional[str]
+            A token for pagination. If the number of documents for a given query is larger than n, the response will include a "nextToken" value. That token can be included in this field to retrieve the next batch of n documents.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        ProcessStatusResponse
+        DocumentListResponse
             Look up success
 
         Examples
@@ -323,95 +240,79 @@ class DocumentsClient:
         client = GroundX(
             api_key="YOUR_API_KEY",
         )
-        client.documents.get_processing_status_by_id(
-            process_id="processId",
+        client.documents.list(
+            n=1,
+            filter="filter",
+            sort="name",
+            sort_order="asc",
+            status="queued",
+            next_token="nextToken",
         )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/ingest/{jsonable_encoder(process_id)}",
-            method="GET",
+        _response = self._raw_client.list(
+            n=n,
+            filter=filter,
+            sort=sort,
+            sort_order=sort_order,
+            status=status,
+            next_token=next_token,
             request_options=request_options,
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    ProcessStatusResponse,
-                    parse_obj_as(
-                        type_=ProcessStatusResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 401:
-                raise UnauthorizedError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        return _response.data
 
-    def lookup(
+    def delete(
         self,
-        id: int,
         *,
-        n: typing.Optional[int] = None,
-        filter: typing.Optional[str] = None,
-        sort: typing.Optional[Sort] = None,
-        sort_order: typing.Optional[SortOrder] = None,
-        status: typing.Optional[ProcessingStatus] = None,
-        next_token: typing.Optional[str] = None,
+        document_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> DocumentLookupResponse:
+    ) -> IngestResponse:
         """
-        lookup the document(s) associated with a processId, bucketId, groupId, or projectId.
-
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
+        Delete multiple documents hosted on GroundX
 
         Parameters
         ----------
-        id : int
-            a processId, bucketId, groupId, or projectId
+        document_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            A list of documentIds which correspond to documents ingested by GroundX
 
-        n : typing.Optional[int]
-            The maximum number of returned documents. Accepts 1-100 with a default of 20.
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
 
-        filter : typing.Optional[str]
-            Only documents with names that contain the filter string will be returned in the results.
+        Returns
+        -------
+        IngestResponse
+            Documents are queued to be deleted
 
-        sort : typing.Optional[Sort]
-            The document attribute that will be used to sort the results.
+        Examples
+        --------
+        from groundx import GroundX
 
-        sort_order : typing.Optional[SortOrder]
-            The order in which to sort the results. A value for sort must also be set.
+        client = GroundX(
+            api_key="YOUR_API_KEY",
+        )
+        client.documents.delete(
+            document_ids="123e4567-e89b-12d3-a456-426614174000,9f7c11a6-24b8-4d52-a9f3-90a7e70a9e49",
+        )
+        """
+        _response = self._raw_client.delete(document_ids=document_ids, request_options=request_options)
+        return _response.data
 
-        status : typing.Optional[ProcessingStatus]
-            A status filter on the get documents query. If this value is set, then only documents with this status will be returned in the results.
+    def get_processing_status_by_id(
+        self, process_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> IngestResponse:
+        """
+        Get the current status of an ingest, initiated with documents.ingest_remote, documents.ingest_local, or documents.crawl_website, by specifying the processId (the processId is included in the response of the documents.ingest functions).
 
-        next_token : typing.Optional[str]
-            A token for pagination. If the number of documents for a given query is larger than n, the response will include a "nextToken" value. That token can be included in this field to retrieve the next batch of n documents.
+        Parameters
+        ----------
+        process_id : str
+            the processId for the ingest process being checked
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        DocumentLookupResponse
+        IngestResponse
             Look up success
 
         Examples
@@ -421,59 +322,16 @@ class DocumentsClient:
         client = GroundX(
             api_key="YOUR_API_KEY",
         )
-        client.documents.lookup(
-            id=1,
+        client.documents.get_processing_status_by_id(
+            process_id="processId",
         )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/ingest/documents/{jsonable_encoder(id)}",
-            method="GET",
-            params={
-                "n": n,
-                "filter": filter,
-                "sort": sort,
-                "sortOrder": sort_order,
-                "status": status,
-                "nextToken": next_token,
-            },
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    DocumentLookupResponse,
-                    parse_obj_as(
-                        type_=DocumentLookupResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 401:
-                raise UnauthorizedError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        _response = self._raw_client.get_processing_status_by_id(process_id, request_options=request_options)
+        return _response.data
 
-    def list(
+    def lookup(
         self,
+        id: int,
         *,
         n: typing.Optional[int] = None,
         filter: typing.Optional[str] = None,
@@ -482,14 +340,15 @@ class DocumentsClient:
         status: typing.Optional[ProcessingStatus] = None,
         next_token: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> DocumentListResponse:
+    ) -> DocumentLookupResponse:
         """
-        lookup all documents across all resources which are currently on GroundX
-
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
+        lookup the document(s) associated with a processId, bucketId, or groupId.
 
         Parameters
         ----------
+        id : int
+            a processId, bucketId, or groupId
+
         n : typing.Optional[int]
             The maximum number of returned documents. Accepts 1-100 with a default of 20.
 
@@ -513,7 +372,7 @@ class DocumentsClient:
 
         Returns
         -------
-        DocumentListResponse
+        DocumentLookupResponse
             Look up success
 
         Examples
@@ -523,58 +382,44 @@ class DocumentsClient:
         client = GroundX(
             api_key="YOUR_API_KEY",
         )
-        client.documents.list()
+        client.documents.lookup(
+            id=1,
+            n=1,
+            filter="filter",
+            sort="name",
+            sort_order="asc",
+            status="queued",
+            next_token="nextToken",
+        )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            "v1/ingest/documents",
-            method="GET",
-            params={
-                "n": n,
-                "filter": filter,
-                "sort": sort,
-                "sortOrder": sort_order,
-                "status": status,
-                "nextToken": next_token,
-            },
+        _response = self._raw_client.lookup(
+            id,
+            n=n,
+            filter=filter,
+            sort=sort,
+            sort_order=sort_order,
+            status=status,
+            next_token=next_token,
             request_options=request_options,
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    DocumentListResponse,
-                    parse_obj_as(
-                        type_=DocumentListResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        return _response.data
 
-    def delete(
-        self,
-        *,
-        document_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> IngestResponse:
+    def get(self, document_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> DocumentResponse:
         """
-        Delete multiple documents hosted on GroundX
-
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
+        Look up an existing document by documentId.
 
         Parameters
         ----------
-        document_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
-            A list of documentIds which correspond to documents ingested by GroundX
+        document_id : str
+            The documentId of the document for which GroundX information will be provided.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        IngestResponse
-            Documents are queued to be deleted
+        DocumentResponse
+            Look up success
 
         Examples
         --------
@@ -583,68 +428,31 @@ class DocumentsClient:
         client = GroundX(
             api_key="YOUR_API_KEY",
         )
-        client.documents.delete()
-        """
-        _response = self._client_wrapper.httpx_client.request(
-            "v1/ingest/documents",
-            method="DELETE",
-            params={
-                "documentIds": document_ids,
-            },
-            request_options=request_options,
+        client.documents.get(
+            document_id="documentId",
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    IngestResponse,
-                    parse_obj_as(
-                        type_=IngestResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 401:
-                raise UnauthorizedError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
-
-    def get(self, document_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> DocumentResponse:
         """
-        Look up an existing document by documentId.
+        _response = self._raw_client.get(document_id, request_options=request_options)
+        return _response.data
 
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
+    def delete_by_id(
+        self, document_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> IngestResponse:
+        """
+        Delete a single document hosted on GroundX
 
         Parameters
         ----------
         document_id : str
-            The documentId of the document for which GroundX information will be provided.
+            A documentId which correspond to a document ingested by GroundX
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        DocumentResponse
-            Look up success
+        IngestResponse
+            Document successfully deleted
 
         Examples
         --------
@@ -653,69 +461,38 @@ class DocumentsClient:
         client = GroundX(
             api_key="YOUR_API_KEY",
         )
-        client.documents.get(
+        client.documents.delete_by_id(
             document_id="documentId",
         )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/ingest/document/{jsonable_encoder(document_id)}",
-            method="GET",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    DocumentResponse,
-                    parse_obj_as(
-                        type_=DocumentResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 401:
-                raise UnauthorizedError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        _response = self._raw_client.delete_by_id(document_id, request_options=request_options)
+        return _response.data
 
-    def delete_by_id(
-        self, document_id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> IngestResponse:
+    def get_processes(
+        self,
+        *,
+        n: typing.Optional[int] = None,
+        status: typing.Optional[ProcessingStatus] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ProcessesStatusResponse:
         """
-        Delete a single document hosted on GroundX
-
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
+        Get a list of ingest process requests, sorted from most recent to least.
 
         Parameters
         ----------
-        document_id : str
-            A documentId which correspond to a document ingested by GroundX
+        n : typing.Optional[int]
+            The maximum number of returned processes. Accepts 1-100 with a default of 20.
+
+        status : typing.Optional[ProcessingStatus]
+            A status filter on the processing status. If this value is set, then only processes with this status will be returned in the results.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        IngestResponse
-            Document successfully deleted
+        ProcessesStatusResponse
+            Look up success
 
         Examples
         --------
@@ -724,69 +501,53 @@ class DocumentsClient:
         client = GroundX(
             api_key="YOUR_API_KEY",
         )
-        client.documents.delete_by_id(
-            document_id="documentId",
+        client.documents.get_processes(
+            n=1,
+            status="queued",
         )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/ingest/document/{jsonable_encoder(document_id)}",
-            method="DELETE",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    IngestResponse,
-                    parse_obj_as(
-                        type_=IngestResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 401:
-                raise UnauthorizedError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        _response = self._raw_client.get_processes(n=n, status=status, request_options=request_options)
+        return _response.data
 
 
 class AsyncDocumentsClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
-        self._client_wrapper = client_wrapper
+        self._raw_client = AsyncRawDocumentsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawDocumentsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawDocumentsClient
+        """
+        return self._raw_client
 
     async def ingest_remote(
         self,
         *,
         documents: typing.Sequence[IngestRemoteDocument],
+        callback_url: typing.Optional[str] = OMIT,
+        callback_data: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> IngestResponse:
         """
-        Ingest documents hosted on public URLs to a GroundX bucket.
+        Ingest documents hosted on public URLs into a GroundX bucket.
 
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
+        [Supported Document Types and Ingest Capacities](https://docs.eyelevel.ai/documentation/fundamentals/document-types-and-ingest-capacities)
 
         Parameters
         ----------
         documents : typing.Sequence[IngestRemoteDocument]
 
+        callback_url : typing.Optional[str]
+            An endpoint that will receive processing event updates as POST.
+
+        callback_data : typing.Optional[str]
+            A string that is returned, along with processing event updates, to the callback URL.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -811,10 +572,9 @@ class AsyncDocumentsClient:
                 documents=[
                     IngestRemoteDocument(
                         bucket_id=1234,
-                        file_name="my_file.txt",
+                        file_name="my_file1.txt",
                         file_type="txt",
-                        search_data={"key": "value"},
-                        source_url="https://my.source.url.com/file.txt",
+                        source_url="https://my.source.url.com/file1.txt",
                     )
                 ],
             )
@@ -822,68 +582,22 @@ class AsyncDocumentsClient:
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            "v1/ingest/documents/remote",
-            method="POST",
-            json={
-                "documents": convert_and_respect_annotation_metadata(
-                    object_=documents, annotation=typing.Sequence[IngestRemoteDocument], direction="write"
-                ),
-            },
-            headers={
-                "content-type": "application/json",
-            },
-            request_options=request_options,
-            omit=OMIT,
+        _response = await self._raw_client.ingest_remote(
+            documents=documents, callback_url=callback_url, callback_data=callback_data, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    IngestResponse,
-                    parse_obj_as(
-                        type_=IngestResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 401:
-                raise UnauthorizedError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        return _response.data
 
-    async def ingest_local(
-        self,
-        *,
-        files: typing.List[DocumentsIngestLocalRequestFilesItem],
-        request_options: typing.Optional[RequestOptions] = None,
+    async def ingest_local(
+        self, *, request: DocumentLocalIngestRequest, request_options: typing.Optional[RequestOptions] = None
     ) -> IngestResponse:
         """
-        Upload documents hosted on a local file system for ingestion into a GroundX bucket.
+        Upload documents hosted on a local file system into a GroundX bucket.
 
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
+        [Supported Document Types and Ingest Capacities](https://docs.eyelevel.ai/documentation/fundamentals/document-types-and-ingest-capacities)
 
         Parameters
         ----------
-        files : typing.List[DocumentsIngestLocalRequestFilesItem]
+        request : DocumentLocalIngestRequest
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -897,8 +611,11 @@ class AsyncDocumentsClient:
         --------
         import asyncio
 
-        from groundx import AsyncGroundX
-        from groundx.documents import DocumentsIngestLocalRequestFilesItem
+        from groundx import (
+            AsyncGroundX,
+            IngestLocalDocument,
+            IngestLocalDocumentMetadata,
+        )
 
         client = AsyncGroundX(
             api_key="YOUR_API_KEY",
@@ -907,12 +624,14 @@ class AsyncDocumentsClient:
 
         async def main() -> None:
             await client.documents.ingest_local(
-                files=[
-                    DocumentsIngestLocalRequestFilesItem(
-                        bucket_id=1,
-                        file_data="fileData",
-                        file_name="fileName",
-                        file_type="txt",
+                request=[
+                    IngestLocalDocument(
+                        blob="blob",
+                        metadata=IngestLocalDocumentMetadata(
+                            bucket_id=1234,
+                            file_name="my_file1.txt",
+                            file_type="txt",
+                        ),
                     )
                 ],
             )
@@ -920,64 +639,34 @@ class AsyncDocumentsClient:
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            "v1/ingest/documents/local",
-            method="POST",
-            data={
-                "files": files,
-            },
-            files={},
-            request_options=request_options,
-            omit=OMIT,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    IngestResponse,
-                    parse_obj_as(
-                        type_=IngestResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 401:
-                raise UnauthorizedError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        _response = await self._raw_client.ingest_local(request=request, request_options=request_options)
+        return _response.data
 
     async def crawl_website(
         self,
         *,
-        websites: typing.Sequence[WebsiteCrawlRequestWebsitesItem],
+        websites: typing.Sequence[WebsiteSource],
+        callback_url: typing.Optional[str] = OMIT,
+        callback_data: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> IngestResponse:
         """
         Upload the content of a publicly accessible website for ingestion into a GroundX bucket. This is done by following links within a specified URL, recursively, up to a specified depth or number of pages.
 
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
+        Note1: This endpoint is currently not supported for on-prem deployments.
+        Note2: The `source_url` must include the protocol, http:// or https://.
+
+        [Supported Document Types and Ingest Capacities](https://docs.eyelevel.ai/documentation/fundamentals/document-types-and-ingest-capacities)
 
         Parameters
         ----------
-        websites : typing.Sequence[WebsiteCrawlRequestWebsitesItem]
+        websites : typing.Sequence[WebsiteSource]
+
+        callback_url : typing.Optional[str]
+            The URL that will receive processing event updates.
+
+        callback_data : typing.Optional[str]
+            A string that is returned, along with processing event updates, to the callback URL.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -991,8 +680,7 @@ class AsyncDocumentsClient:
         --------
         import asyncio
 
-        from groundx import AsyncGroundX
-        from groundx.documents import WebsiteCrawlRequestWebsitesItem
+        from groundx import AsyncGroundX, WebsiteSource
 
         client = AsyncGroundX(
             api_key="YOUR_API_KEY",
@@ -1002,8 +690,11 @@ class AsyncDocumentsClient:
         async def main() -> None:
             await client.documents.crawl_website(
                 websites=[
-                    WebsiteCrawlRequestWebsitesItem(
-                        bucket_id=123,
+                    WebsiteSource(
+                        bucket_id=1234,
+                        cap=10,
+                        depth=2,
+                        search_data={"key": "value"},
                         source_url="https://my.website.com",
                     )
                 ],
@@ -1012,73 +703,51 @@ class AsyncDocumentsClient:
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            "v1/ingest/documents/website",
-            method="POST",
-            json={
-                "websites": convert_and_respect_annotation_metadata(
-                    object_=websites, annotation=typing.Sequence[WebsiteCrawlRequestWebsitesItem], direction="write"
-                ),
-            },
-            headers={
-                "content-type": "application/json",
-            },
-            request_options=request_options,
-            omit=OMIT,
+        _response = await self._raw_client.crawl_website(
+            websites=websites, callback_url=callback_url, callback_data=callback_data, request_options=request_options
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    IngestResponse,
-                    parse_obj_as(
-                        type_=IngestResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 401:
-                raise UnauthorizedError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        return _response.data
 
-    async def get_processing_status_by_id(
-        self, process_id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> ProcessStatusResponse:
+    async def list(
+        self,
+        *,
+        n: typing.Optional[int] = None,
+        filter: typing.Optional[str] = None,
+        sort: typing.Optional[Sort] = None,
+        sort_order: typing.Optional[SortOrder] = None,
+        status: typing.Optional[ProcessingStatus] = None,
+        next_token: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> DocumentListResponse:
         """
-        Get the current status of an ingest, initiated with documents.ingest_remote, documents.ingest_local, or documents.crawl_website, by specifying the processId (the processId is included in the response of the documents.ingest functions).
-
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
+        lookup all documents across all resources which are currently on GroundX
 
         Parameters
         ----------
-        process_id : str
-            the processId for the ingest process being checked
+        n : typing.Optional[int]
+            The maximum number of returned documents. Accepts 1-100 with a default of 20.
+
+        filter : typing.Optional[str]
+            Only documents with names that contain the filter string will be returned in the results.
+
+        sort : typing.Optional[Sort]
+            The document attribute that will be used to sort the results.
+
+        sort_order : typing.Optional[SortOrder]
+            The order in which to sort the results. A value for sort must also be set.
+
+        status : typing.Optional[ProcessingStatus]
+            A status filter on the get documents query. If this value is set, then only documents with this status will be returned in the results.
+
+        next_token : typing.Optional[str]
+            A token for pagination. If the number of documents for a given query is larger than n, the response will include a "nextToken" value. That token can be included in this field to retrieve the next batch of n documents.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        ProcessStatusResponse
+        DocumentListResponse
             Look up success
 
         Examples
@@ -1093,98 +762,90 @@ class AsyncDocumentsClient:
 
 
         async def main() -> None:
-            await client.documents.get_processing_status_by_id(
-                process_id="processId",
+            await client.documents.list(
+                n=1,
+                filter="filter",
+                sort="name",
+                sort_order="asc",
+                status="queued",
+                next_token="nextToken",
             )
 
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/ingest/{jsonable_encoder(process_id)}",
-            method="GET",
+        _response = await self._raw_client.list(
+            n=n,
+            filter=filter,
+            sort=sort,
+            sort_order=sort_order,
+            status=status,
+            next_token=next_token,
             request_options=request_options,
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    ProcessStatusResponse,
-                    parse_obj_as(
-                        type_=ProcessStatusResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 401:
-                raise UnauthorizedError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        return _response.data
 
-    async def lookup(
+    async def delete(
         self,
-        id: int,
         *,
-        n: typing.Optional[int] = None,
-        filter: typing.Optional[str] = None,
-        sort: typing.Optional[Sort] = None,
-        sort_order: typing.Optional[SortOrder] = None,
-        status: typing.Optional[ProcessingStatus] = None,
-        next_token: typing.Optional[str] = None,
+        document_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> DocumentLookupResponse:
+    ) -> IngestResponse:
         """
-        lookup the document(s) associated with a processId, bucketId, groupId, or projectId.
-
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
+        Delete multiple documents hosted on GroundX
 
         Parameters
         ----------
-        id : int
-            a processId, bucketId, groupId, or projectId
+        document_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            A list of documentIds which correspond to documents ingested by GroundX
 
-        n : typing.Optional[int]
-            The maximum number of returned documents. Accepts 1-100 with a default of 20.
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
 
-        filter : typing.Optional[str]
-            Only documents with names that contain the filter string will be returned in the results.
+        Returns
+        -------
+        IngestResponse
+            Documents are queued to be deleted
 
-        sort : typing.Optional[Sort]
-            The document attribute that will be used to sort the results.
+        Examples
+        --------
+        import asyncio
 
-        sort_order : typing.Optional[SortOrder]
-            The order in which to sort the results. A value for sort must also be set.
+        from groundx import AsyncGroundX
 
-        status : typing.Optional[ProcessingStatus]
-            A status filter on the get documents query. If this value is set, then only documents with this status will be returned in the results.
+        client = AsyncGroundX(
+            api_key="YOUR_API_KEY",
+        )
 
-        next_token : typing.Optional[str]
-            A token for pagination. If the number of documents for a given query is larger than n, the response will include a "nextToken" value. That token can be included in this field to retrieve the next batch of n documents.
+
+        async def main() -> None:
+            await client.documents.delete(
+                document_ids="123e4567-e89b-12d3-a456-426614174000,9f7c11a6-24b8-4d52-a9f3-90a7e70a9e49",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.delete(document_ids=document_ids, request_options=request_options)
+        return _response.data
+
+    async def get_processing_status_by_id(
+        self, process_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> IngestResponse:
+        """
+        Get the current status of an ingest, initiated with documents.ingest_remote, documents.ingest_local, or documents.crawl_website, by specifying the processId (the processId is included in the response of the documents.ingest functions).
+
+        Parameters
+        ----------
+        process_id : str
+            the processId for the ingest process being checked
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        DocumentLookupResponse
+        IngestResponse
             Look up success
 
         Examples
@@ -1199,62 +860,19 @@ class AsyncDocumentsClient:
 
 
         async def main() -> None:
-            await client.documents.lookup(
-                id=1,
+            await client.documents.get_processing_status_by_id(
+                process_id="processId",
             )
 
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/ingest/documents/{jsonable_encoder(id)}",
-            method="GET",
-            params={
-                "n": n,
-                "filter": filter,
-                "sort": sort,
-                "sortOrder": sort_order,
-                "status": status,
-                "nextToken": next_token,
-            },
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    DocumentLookupResponse,
-                    parse_obj_as(
-                        type_=DocumentLookupResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 401:
-                raise UnauthorizedError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        _response = await self._raw_client.get_processing_status_by_id(process_id, request_options=request_options)
+        return _response.data
 
-    async def list(
+    async def lookup(
         self,
+        id: int,
         *,
         n: typing.Optional[int] = None,
         filter: typing.Optional[str] = None,
@@ -1263,14 +881,15 @@ class AsyncDocumentsClient:
         status: typing.Optional[ProcessingStatus] = None,
         next_token: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> DocumentListResponse:
+    ) -> DocumentLookupResponse:
         """
-        lookup all documents across all resources which are currently on GroundX
-
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
+        lookup the document(s) associated with a processId, bucketId, or groupId.
 
         Parameters
         ----------
+        id : int
+            a processId, bucketId, or groupId
+
         n : typing.Optional[int]
             The maximum number of returned documents. Accepts 1-100 with a default of 20.
 
@@ -1294,7 +913,7 @@ class AsyncDocumentsClient:
 
         Returns
         -------
-        DocumentListResponse
+        DocumentLookupResponse
             Look up success
 
         Examples
@@ -1309,61 +928,49 @@ class AsyncDocumentsClient:
 
 
         async def main() -> None:
-            await client.documents.list()
+            await client.documents.lookup(
+                id=1,
+                n=1,
+                filter="filter",
+                sort="name",
+                sort_order="asc",
+                status="queued",
+                next_token="nextToken",
+            )
 
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            "v1/ingest/documents",
-            method="GET",
-            params={
-                "n": n,
-                "filter": filter,
-                "sort": sort,
-                "sortOrder": sort_order,
-                "status": status,
-                "nextToken": next_token,
-            },
+        _response = await self._raw_client.lookup(
+            id,
+            n=n,
+            filter=filter,
+            sort=sort,
+            sort_order=sort_order,
+            status=status,
+            next_token=next_token,
             request_options=request_options,
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    DocumentListResponse,
-                    parse_obj_as(
-                        type_=DocumentListResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        return _response.data
 
-    async def delete(
-        self,
-        *,
-        document_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> IngestResponse:
+    async def get(
+        self, document_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> DocumentResponse:
         """
-        Delete multiple documents hosted on GroundX
-
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
+        Look up an existing document by documentId.
 
         Parameters
         ----------
-        document_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
-            A list of documentIds which correspond to documents ingested by GroundX
+        document_id : str
+            The documentId of the document for which GroundX information will be provided.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        IngestResponse
-            Documents are queued to be deleted
+        DocumentResponse
+            Look up success
 
         Examples
         --------
@@ -1377,73 +984,34 @@ class AsyncDocumentsClient:
 
 
         async def main() -> None:
-            await client.documents.delete()
+            await client.documents.get(
+                document_id="documentId",
+            )
 
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            "v1/ingest/documents",
-            method="DELETE",
-            params={
-                "documentIds": document_ids,
-            },
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    IngestResponse,
-                    parse_obj_as(
-                        type_=IngestResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 401:
-                raise UnauthorizedError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        _response = await self._raw_client.get(document_id, request_options=request_options)
+        return _response.data
 
-    async def get(
+    async def delete_by_id(
         self, document_id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> DocumentResponse:
+    ) -> IngestResponse:
         """
-        Look up an existing document by documentId.
-
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
+        Delete a single document hosted on GroundX
 
         Parameters
         ----------
         document_id : str
-            The documentId of the document for which GroundX information will be provided.
+            A documentId which correspond to a document ingested by GroundX
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        DocumentResponse
-            Look up success
+        IngestResponse
+            Document successfully deleted
 
         Examples
         --------
@@ -1457,72 +1025,41 @@ class AsyncDocumentsClient:
 
 
         async def main() -> None:
-            await client.documents.get(
+            await client.documents.delete_by_id(
                 document_id="documentId",
             )
 
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/ingest/document/{jsonable_encoder(document_id)}",
-            method="GET",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    DocumentResponse,
-                    parse_obj_as(
-                        type_=DocumentResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 401:
-                raise UnauthorizedError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        _response = await self._raw_client.delete_by_id(document_id, request_options=request_options)
+        return _response.data
 
-    async def delete_by_id(
-        self, document_id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> IngestResponse:
+    async def get_processes(
+        self,
+        *,
+        n: typing.Optional[int] = None,
+        status: typing.Optional[ProcessingStatus] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ProcessesStatusResponse:
         """
-        Delete a single document hosted on GroundX
-
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
+        Get a list of ingest process requests, sorted from most recent to least.
 
         Parameters
         ----------
-        document_id : str
-            A documentId which correspond to a document ingested by GroundX
+        n : typing.Optional[int]
+            The maximum number of returned processes. Accepts 1-100 with a default of 20.
+
+        status : typing.Optional[ProcessingStatus]
+            A status filter on the processing status. If this value is set, then only processes with this status will be returned in the results.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        IngestResponse
-            Document successfully deleted
+        ProcessesStatusResponse
+            Look up success
 
         Examples
         --------
@@ -1536,48 +1073,13 @@ class AsyncDocumentsClient:
 
 
         async def main() -> None:
-            await client.documents.delete_by_id(
-                document_id="documentId",
+            await client.documents.get_processes(
+                n=1,
+                status="queued",
             )
 
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/ingest/document/{jsonable_encoder(document_id)}",
-            method="DELETE",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    IngestResponse,
-                    parse_obj_as(
-                        type_=IngestResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 401:
-                raise UnauthorizedError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        _response = await self._raw_client.get_processes(n=n, status=status, request_options=request_options)
+        return _response.data