llama-cloud 0.1.41__py3-none-any.whl → 0.1.43__py3-none-any.whl

llama_cloud/resources/beta/client.py

@@ -12,9 +12,13 @@ from ...core.jsonable_encoder import jsonable_encoder
 from ...core.remove_none_from_dict import remove_none_from_dict
 from ...errors.unprocessable_entity_error import UnprocessableEntityError
 from ...types.agent_data import AgentData
+from ...types.api_key import ApiKey
+from ...types.api_key_query_response import ApiKeyQueryResponse
+from ...types.api_key_type import ApiKeyType
 from ...types.batch import Batch
 from ...types.batch_paginated_list import BatchPaginatedList
 from ...types.batch_public_output import BatchPublicOutput
+from ...types.delete_response import DeleteResponse
 from ...types.file import File
 from ...types.file_create import FileCreate
 from ...types.file_filter import FileFilter
@@ -25,10 +29,14 @@ from ...types.llama_parse_parameters import LlamaParseParameters
 from ...types.paginated_response_agent_data import PaginatedResponseAgentData
 from ...types.paginated_response_aggregate_group import PaginatedResponseAggregateGroup
 from ...types.paginated_response_quota_configuration import PaginatedResponseQuotaConfiguration
+from ...types.paginated_response_spreadsheet_job import PaginatedResponseSpreadsheetJob
 from ...types.parse_configuration import ParseConfiguration
 from ...types.parse_configuration_create import ParseConfigurationCreate
 from ...types.parse_configuration_filter import ParseConfigurationFilter
 from ...types.parse_configuration_query_response import ParseConfigurationQueryResponse
+from ...types.presigned_url import PresignedUrl
+from ...types.spreadsheet_job import SpreadsheetJob
+from ...types.spreadsheet_parsing_config import SpreadsheetParsingConfig
 
 try:
     import pydantic
@@ -46,6 +54,220 @@ class BetaClient:
     def __init__(self, *, client_wrapper: SyncClientWrapper):
         self._client_wrapper = client_wrapper
 
+    def list_api_keys(
+        self,
+        *,
+        page_size: typing.Optional[int] = None,
+        page_token: typing.Optional[str] = None,
+        name: typing.Optional[str] = None,
+        project_id: typing.Optional[str] = None,
+        key_type: typing.Optional[ApiKeyType] = None,
+    ) -> ApiKeyQueryResponse:
+        """
+        List API keys.
+
+        If project_id is provided, validates user has access to that project.
+        If project_id is not provided, scopes results to the current user.
+
+        Args:
+        user: Current user
+        db: Database session
+        page_size: Number of items per page
+        page_token: Token for pagination
+        name: Filter by API key name
+        project_id: Filter by project ID
+        key_type: Filter by key type
+
+        Returns:
+        Paginated response with API keys
+
+        Parameters:
+            - page_size: typing.Optional[int].
+
+            - page_token: typing.Optional[str].
+
+            - name: typing.Optional[str].
+
+            - project_id: typing.Optional[str].
+
+            - key_type: typing.Optional[ApiKeyType].
+        ---
+        from llama_cloud import ApiKeyType
+        from llama_cloud.client import LlamaCloud
+
+        client = LlamaCloud(
+            token="YOUR_TOKEN",
+        )
+        client.beta.list_api_keys(
+            key_type=ApiKeyType.USER,
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "GET",
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v1/beta/api-keys"),
+            params=remove_none_from_dict(
+                {
+                    "page_size": page_size,
+                    "page_token": page_token,
+                    "name": name,
+                    "project_id": project_id,
+                    "key_type": key_type,
+                }
+            ),
+            headers=self._client_wrapper.get_headers(),
+            timeout=60,
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic.parse_obj_as(ApiKeyQueryResponse, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _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 create_api_key(
+        self,
+        *,
+        name: typing.Optional[str] = OMIT,
+        project_id: typing.Optional[str] = OMIT,
+        key_type: typing.Optional[ApiKeyType] = OMIT,
+    ) -> ApiKey:
+        """
+        Create a new API key.
+
+        If project_id is specified, validates user has admin permissions for that project.
+
+        Args:
+        api_key_create: API key creation data
+        user: Current user
+        db: Database session
+
+        Returns:
+        The created API key with the secret key visible in redacted_api_key field
+
+        Parameters:
+            - name: typing.Optional[str].
+
+            - project_id: typing.Optional[str].
+
+            - key_type: typing.Optional[ApiKeyType].
+        ---
+        from llama_cloud import ApiKeyType
+        from llama_cloud.client import LlamaCloud
+
+        client = LlamaCloud(
+            token="YOUR_TOKEN",
+        )
+        client.beta.create_api_key(
+            key_type=ApiKeyType.USER,
+        )
+        """
+        _request: typing.Dict[str, typing.Any] = {}
+        if name is not OMIT:
+            _request["name"] = name
+        if project_id is not OMIT:
+            _request["project_id"] = project_id
+        if key_type is not OMIT:
+            _request["key_type"] = key_type
+        _response = self._client_wrapper.httpx_client.request(
+            "POST",
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v1/beta/api-keys"),
+            json=jsonable_encoder(_request),
+            headers=self._client_wrapper.get_headers(),
+            timeout=60,
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic.parse_obj_as(ApiKey, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _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_api_key(self, api_key_id: str) -> ApiKey:
+        """
+        Get an API key by ID.
+
+        Args:
+        api_key_id: The ID of the API key
+        user: Current user
+        db: Database session
+
+        Returns:
+        The API key
+
+        Parameters:
+            - api_key_id: str.
+        ---
+        from llama_cloud.client import LlamaCloud
+
+        client = LlamaCloud(
+            token="YOUR_TOKEN",
+        )
+        client.beta.get_api_key(
+            api_key_id="string",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "GET",
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", f"api/v1/beta/api-keys/{api_key_id}"),
+            headers=self._client_wrapper.get_headers(),
+            timeout=60,
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic.parse_obj_as(ApiKey, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _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 delete_api_key(self, api_key_id: str) -> None:
+        """
+        Delete an API key.
+
+        If the API key belongs to a project, validates user has admin permissions for that project.
+        If the API key has no project, validates it belongs to the current user.
+
+        Args:
+        api_key_id: The ID of the API key to delete
+        user: Current user
+        db: Database session
+
+        Parameters:
+            - api_key_id: str.
+        ---
+        from llama_cloud.client import LlamaCloud
+
+        client = LlamaCloud(
+            token="YOUR_TOKEN",
+        )
+        client.beta.delete_api_key(
+            api_key_id="string",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "DELETE",
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", f"api/v1/beta/api-keys/{api_key_id}"),
+            headers=self._client_wrapper.get_headers(),
+            timeout=60,
+        )
+        if 200 <= _response.status_code < 300:
+            return
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _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 list_batches(
         self,
         *,
@@ -350,7 +572,7 @@ class BetaClient:
         *,
         project_id: typing.Optional[str] = None,
         organization_id: typing.Optional[str] = None,
-        agent_slug: str,
+        deployment_name: str,
         collection: typing.Optional[str] = OMIT,
         data: typing.Dict[str, typing.Any],
     ) -> AgentData:
@@ -362,7 +584,7 @@ class BetaClient:
 
             - organization_id: typing.Optional[str].
 
-            - agent_slug: str.
+            - deployment_name: str.
 
             - collection: typing.Optional[str].
 
@@ -374,11 +596,11 @@ class BetaClient:
             token="YOUR_TOKEN",
         )
         client.beta.create_agent_data(
-            agent_slug="string",
+            deployment_name="string",
             data={"string": {}},
         )
         """
-        _request: typing.Dict[str, typing.Any] = {"agent_slug": agent_slug, "data": data}
+        _request: typing.Dict[str, typing.Any] = {"deployment_name": deployment_name, "data": data}
         if collection is not OMIT:
             _request["collection"] = collection
         _response = self._client_wrapper.httpx_client.request(
@@ -408,7 +630,7 @@ class BetaClient:
         page_token: typing.Optional[str] = OMIT,
         filter: typing.Optional[typing.Dict[str, typing.Optional[FilterOperation]]] = OMIT,
         order_by: typing.Optional[str] = OMIT,
-        agent_slug: str,
+        deployment_name: str,
         collection: typing.Optional[str] = OMIT,
         include_total: typing.Optional[bool] = OMIT,
         offset: typing.Optional[int] = OMIT,
@@ -429,7 +651,7 @@ class BetaClient:
 
             - order_by: typing.Optional[str].
 
-            - agent_slug: str. The agent deployment's agent_slug to search within
+            - deployment_name: str. The agent deployment's name to search within
 
             - collection: typing.Optional[str]. The logical agent data collection to search within
 
@@ -443,10 +665,10 @@ class BetaClient:
             token="YOUR_TOKEN",
         )
         client.beta.search_agent_data_api_v_1_beta_agent_data_search_post(
-            agent_slug="string",
+            deployment_name="string",
         )
         """
-        _request: typing.Dict[str, typing.Any] = {"agent_slug": agent_slug}
+        _request: typing.Dict[str, typing.Any] = {"deployment_name": deployment_name}
         if page_size is not OMIT:
             _request["page_size"] = page_size
         if page_token is not OMIT:
@@ -488,7 +710,7 @@ class BetaClient:
         page_token: typing.Optional[str] = OMIT,
         filter: typing.Optional[typing.Dict[str, typing.Optional[FilterOperation]]] = OMIT,
         order_by: typing.Optional[str] = OMIT,
-        agent_slug: str,
+        deployment_name: str,
         collection: typing.Optional[str] = OMIT,
         group_by: typing.Optional[typing.List[str]] = OMIT,
         count: typing.Optional[bool] = OMIT,
@@ -511,7 +733,7 @@ class BetaClient:
 
             - order_by: typing.Optional[str].
 
-            - agent_slug: str. The agent deployment's agent_slug to aggregate data for
+            - deployment_name: str. The agent deployment's name to aggregate data for
 
             - collection: typing.Optional[str]. The logical agent data collection to aggregate data for
 
@@ -529,10 +751,10 @@ class BetaClient:
             token="YOUR_TOKEN",
         )
         client.beta.aggregate_agent_data_api_v_1_beta_agent_data_aggregate_post(
-            agent_slug="string",
+            deployment_name="string",
         )
         """
-        _request: typing.Dict[str, typing.Any] = {"agent_slug": agent_slug}
+        _request: typing.Dict[str, typing.Any] = {"deployment_name": deployment_name}
         if page_size is not OMIT:
             _request["page_size"] = page_size
         if page_token is not OMIT:
@@ -569,6 +791,61 @@ class BetaClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    def delete_agent_data_by_query_api_v_1_beta_agent_data_delete_post(
+        self,
+        *,
+        project_id: typing.Optional[str] = None,
+        organization_id: typing.Optional[str] = None,
+        deployment_name: str,
+        collection: typing.Optional[str] = OMIT,
+        filter: typing.Optional[typing.Dict[str, typing.Optional[FilterOperation]]] = OMIT,
+    ) -> DeleteResponse:
+        """
+        Bulk delete agent data by query (deployment_name, collection, optional filters).
+
+        Parameters:
+            - project_id: typing.Optional[str].
+
+            - organization_id: typing.Optional[str].
+
+            - deployment_name: str. The agent deployment's name to delete data for
+
+            - collection: typing.Optional[str]. The logical agent data collection to delete from
+
+            - filter: typing.Optional[typing.Dict[str, typing.Optional[FilterOperation]]].
+        ---
+        from llama_cloud.client import LlamaCloud
+
+        client = LlamaCloud(
+            token="YOUR_TOKEN",
+        )
+        client.beta.delete_agent_data_by_query_api_v_1_beta_agent_data_delete_post(
+            deployment_name="string",
+        )
+        """
+        _request: typing.Dict[str, typing.Any] = {"deployment_name": deployment_name}
+        if collection is not OMIT:
+            _request["collection"] = collection
+        if filter is not OMIT:
+            _request["filter"] = filter
+        _response = self._client_wrapper.httpx_client.request(
+            "POST",
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v1/beta/agent-data/:delete"),
+            params=remove_none_from_dict({"project_id": project_id, "organization_id": organization_id}),
+            json=jsonable_encoder(_request),
+            headers=self._client_wrapper.get_headers(),
+            timeout=60,
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic.parse_obj_as(DeleteResponse, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _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 list_quota_configurations(
         self,
         *,
@@ -1352,47 +1629,54 @@ class BetaClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-
-class AsyncBetaClient:
-    def __init__(self, *, client_wrapper: AsyncClientWrapper):
-        self._client_wrapper = client_wrapper
-
-    async def list_batches(
+    def list_spreadsheet_jobs(
         self,
         *,
-        limit: typing.Optional[int] = None,
-        offset: typing.Optional[int] = None,
+        include_results: typing.Optional[bool] = None,
         project_id: typing.Optional[str] = None,
         organization_id: typing.Optional[str] = None,
-    ) -> BatchPaginatedList:
+        page_size: typing.Optional[int] = None,
+        page_token: typing.Optional[str] = None,
+    ) -> PaginatedResponseSpreadsheetJob:
         """
-        Parameters:
-            - limit: typing.Optional[int].
+        List spreadsheet parsing jobs.
+        Experimental: This endpoint is not yet ready for production use and is subject to change at any time.
 
-            - offset: typing.Optional[int].
+        Parameters:
+            - include_results: typing.Optional[bool].
 
             - project_id: typing.Optional[str].
 
             - organization_id: typing.Optional[str].
+
+            - page_size: typing.Optional[int].
+
+            - page_token: typing.Optional[str].
         ---
-        from llama_cloud.client import AsyncLlamaCloud
+        from llama_cloud.client import LlamaCloud
 
-        client = AsyncLlamaCloud(
+        client = LlamaCloud(
             token="YOUR_TOKEN",
         )
-        await client.beta.list_batches()
+        client.beta.list_spreadsheet_jobs()
         """
-        _response = await self._client_wrapper.httpx_client.request(
+        _response = self._client_wrapper.httpx_client.request(
             "GET",
-            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v1/beta/batches"),
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v1/beta/spreadsheet/jobs"),
             params=remove_none_from_dict(
-                {"limit": limit, "offset": offset, "project_id": project_id, "organization_id": organization_id}
+                {
+                    "include_results": include_results,
+                    "project_id": project_id,
+                    "organization_id": organization_id,
+                    "page_size": page_size,
+                    "page_token": page_token,
+                }
             ),
             headers=self._client_wrapper.get_headers(),
             timeout=60,
         )
         if 200 <= _response.status_code < 300:
-            return pydantic.parse_obj_as(BatchPaginatedList, _response.json())  # type: ignore
+            return pydantic.parse_obj_as(PaginatedResponseSpreadsheetJob, _response.json())  # type: ignore
         if _response.status_code == 422:
             raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
         try:
@@ -1401,30 +1685,457 @@ class AsyncBetaClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    async def create_batch(
+    def create_spreadsheet_job(
         self,
         *,
-        organization_id: typing.Optional[str] = None,
         project_id: typing.Optional[str] = None,
-        tool: str,
-        tool_data: typing.Optional[LlamaParseParameters] = OMIT,
-        input_type: str,
-        input_id: str,
-        output_type: typing.Optional[str] = OMIT,
-        output_id: typing.Optional[str] = OMIT,
-        batch_create_project_id: str,
-        external_id: str,
-        completion_window: typing.Optional[int] = OMIT,
-    ) -> Batch:
+        organization_id: typing.Optional[str] = None,
+        file_id: str,
+        config: typing.Optional[SpreadsheetParsingConfig] = OMIT,
+    ) -> SpreadsheetJob:
         """
-        Parameters:
-            - organization_id: typing.Optional[str].
+        Create a spreadsheet parsing job.
+        Experimental: This endpoint is not yet ready for production use and is subject to change at any time.
 
+        Parameters:
             - project_id: typing.Optional[str].
 
-            - tool: str. The tool to be used for all requests in the batch.
+            - organization_id: typing.Optional[str].
 
-            - tool_data: typing.Optional[LlamaParseParameters].
+            - file_id: str. The ID of the file to parse
+
+            - config: typing.Optional[SpreadsheetParsingConfig]. Configuration for the parsing job
+        ---
+        from llama_cloud import SpreadsheetParsingConfig
+        from llama_cloud.client import LlamaCloud
+
+        client = LlamaCloud(
+            token="YOUR_TOKEN",
+        )
+        client.beta.create_spreadsheet_job(
+            file_id="string",
+            config=SpreadsheetParsingConfig(),
+        )
+        """
+        _request: typing.Dict[str, typing.Any] = {"file_id": file_id}
+        if config is not OMIT:
+            _request["config"] = config
+        _response = self._client_wrapper.httpx_client.request(
+            "POST",
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v1/beta/spreadsheet/jobs"),
+            params=remove_none_from_dict({"project_id": project_id, "organization_id": organization_id}),
+            json=jsonable_encoder(_request),
+            headers=self._client_wrapper.get_headers(),
+            timeout=60,
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic.parse_obj_as(SpreadsheetJob, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _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_spreadsheet_job(
+        self,
+        spreadsheet_job_id: str,
+        *,
+        include_results: typing.Optional[bool] = None,
+        project_id: typing.Optional[str] = None,
+        organization_id: typing.Optional[str] = None,
+    ) -> SpreadsheetJob:
+        """
+        Get a spreadsheet parsing job.
+
+        When include_results=True (default), the response will include extracted tables and results
+        if the job is complete, eliminating the need for a separate /results call.
+
+        Experimental: This endpoint is not yet ready for production use and is subject to change at any time.
+
+        Parameters:
+            - spreadsheet_job_id: str.
+
+            - include_results: typing.Optional[bool].
+
+            - project_id: typing.Optional[str].
+
+            - organization_id: typing.Optional[str].
+        ---
+        from llama_cloud.client import LlamaCloud
+
+        client = LlamaCloud(
+            token="YOUR_TOKEN",
+        )
+        client.beta.get_spreadsheet_job(
+            spreadsheet_job_id="string",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "GET",
+            urllib.parse.urljoin(
+                f"{self._client_wrapper.get_base_url()}/", f"api/v1/beta/spreadsheet/jobs/{spreadsheet_job_id}"
+            ),
+            params=remove_none_from_dict(
+                {"include_results": include_results, "project_id": project_id, "organization_id": organization_id}
+            ),
+            headers=self._client_wrapper.get_headers(),
+            timeout=60,
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic.parse_obj_as(SpreadsheetJob, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _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_table_download_presigned_url(
+        self,
+        spreadsheet_job_id: str,
+        table_id: int,
+        *,
+        expires_at_seconds: typing.Optional[int] = None,
+        project_id: typing.Optional[str] = None,
+        organization_id: typing.Optional[str] = None,
+    ) -> PresignedUrl:
+        """
+        Generate a presigned URL to download a specific extracted table.
+        Experimental: This endpoint is not yet ready for production use and is subject to change at any time.
+
+        Parameters:
+            - spreadsheet_job_id: str.
+
+            - table_id: int.
+
+            - expires_at_seconds: typing.Optional[int].
+
+            - project_id: typing.Optional[str].
+
+            - organization_id: typing.Optional[str].
+        ---
+        from llama_cloud.client import LlamaCloud
+
+        client = LlamaCloud(
+            token="YOUR_TOKEN",
+        )
+        client.beta.get_table_download_presigned_url(
+            spreadsheet_job_id="string",
+            table_id=1,
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "GET",
+            urllib.parse.urljoin(
+                f"{self._client_wrapper.get_base_url()}/",
+                f"api/v1/beta/spreadsheet/jobs/{spreadsheet_job_id}/tables/{table_id}/result",
+            ),
+            params=remove_none_from_dict(
+                {"expires_at_seconds": expires_at_seconds, "project_id": project_id, "organization_id": organization_id}
+            ),
+            headers=self._client_wrapper.get_headers(),
+            timeout=60,
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic.parse_obj_as(PresignedUrl, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _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)
+
+
+class AsyncBetaClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def list_api_keys(
+        self,
+        *,
+        page_size: typing.Optional[int] = None,
+        page_token: typing.Optional[str] = None,
+        name: typing.Optional[str] = None,
+        project_id: typing.Optional[str] = None,
+        key_type: typing.Optional[ApiKeyType] = None,
+    ) -> ApiKeyQueryResponse:
+        """
+        List API keys.
+
+        If project_id is provided, validates user has access to that project.
+        If project_id is not provided, scopes results to the current user.
+
+        Args:
+        user: Current user
+        db: Database session
+        page_size: Number of items per page
+        page_token: Token for pagination
+        name: Filter by API key name
+        project_id: Filter by project ID
+        key_type: Filter by key type
+
+        Returns:
+        Paginated response with API keys
+
+        Parameters:
+            - page_size: typing.Optional[int].
+
+            - page_token: typing.Optional[str].
+
+            - name: typing.Optional[str].
+
+            - project_id: typing.Optional[str].
+
+            - key_type: typing.Optional[ApiKeyType].
+        ---
+        from llama_cloud import ApiKeyType
+        from llama_cloud.client import AsyncLlamaCloud
+
+        client = AsyncLlamaCloud(
+            token="YOUR_TOKEN",
+        )
+        await client.beta.list_api_keys(
+            key_type=ApiKeyType.USER,
+        )
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "GET",
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v1/beta/api-keys"),
+            params=remove_none_from_dict(
+                {
+                    "page_size": page_size,
+                    "page_token": page_token,
+                    "name": name,
+                    "project_id": project_id,
+                    "key_type": key_type,
+                }
+            ),
+            headers=self._client_wrapper.get_headers(),
+            timeout=60,
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic.parse_obj_as(ApiKeyQueryResponse, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _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)
+
+    async def create_api_key(
+        self,
+        *,
+        name: typing.Optional[str] = OMIT,
+        project_id: typing.Optional[str] = OMIT,
+        key_type: typing.Optional[ApiKeyType] = OMIT,
+    ) -> ApiKey:
+        """
+        Create a new API key.
+
+        If project_id is specified, validates user has admin permissions for that project.
+
+        Args:
+        api_key_create: API key creation data
+        user: Current user
+        db: Database session
+
+        Returns:
+        The created API key with the secret key visible in redacted_api_key field
+
+        Parameters:
+            - name: typing.Optional[str].
+
+            - project_id: typing.Optional[str].
+
+            - key_type: typing.Optional[ApiKeyType].
+        ---
+        from llama_cloud import ApiKeyType
+        from llama_cloud.client import AsyncLlamaCloud
+
+        client = AsyncLlamaCloud(
+            token="YOUR_TOKEN",
+        )
+        await client.beta.create_api_key(
+            key_type=ApiKeyType.USER,
+        )
+        """
+        _request: typing.Dict[str, typing.Any] = {}
+        if name is not OMIT:
+            _request["name"] = name
+        if project_id is not OMIT:
+            _request["project_id"] = project_id
+        if key_type is not OMIT:
+            _request["key_type"] = key_type
+        _response = await self._client_wrapper.httpx_client.request(
+            "POST",
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v1/beta/api-keys"),
+            json=jsonable_encoder(_request),
+            headers=self._client_wrapper.get_headers(),
+            timeout=60,
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic.parse_obj_as(ApiKey, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _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)
+
+    async def get_api_key(self, api_key_id: str) -> ApiKey:
+        """
+        Get an API key by ID.
+
+        Args:
+        api_key_id: The ID of the API key
+        user: Current user
+        db: Database session
+
+        Returns:
+        The API key
+
+        Parameters:
+            - api_key_id: str.
+        ---
+        from llama_cloud.client import AsyncLlamaCloud
+
+        client = AsyncLlamaCloud(
+            token="YOUR_TOKEN",
+        )
+        await client.beta.get_api_key(
+            api_key_id="string",
+        )
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "GET",
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", f"api/v1/beta/api-keys/{api_key_id}"),
+            headers=self._client_wrapper.get_headers(),
+            timeout=60,
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic.parse_obj_as(ApiKey, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _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)
+
+    async def delete_api_key(self, api_key_id: str) -> None:
+        """
+        Delete an API key.
+
+        If the API key belongs to a project, validates user has admin permissions for that project.
+        If the API key has no project, validates it belongs to the current user.
+
+        Args:
+        api_key_id: The ID of the API key to delete
+        user: Current user
+        db: Database session
+
+        Parameters:
+            - api_key_id: str.
+        ---
+        from llama_cloud.client import AsyncLlamaCloud
+
+        client = AsyncLlamaCloud(
+            token="YOUR_TOKEN",
+        )
+        await client.beta.delete_api_key(
+            api_key_id="string",
+        )
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "DELETE",
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", f"api/v1/beta/api-keys/{api_key_id}"),
+            headers=self._client_wrapper.get_headers(),
+            timeout=60,
+        )
+        if 200 <= _response.status_code < 300:
+            return
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _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)
+
+    async def list_batches(
+        self,
+        *,
+        limit: typing.Optional[int] = None,
+        offset: typing.Optional[int] = None,
+        project_id: typing.Optional[str] = None,
+        organization_id: typing.Optional[str] = None,
+    ) -> BatchPaginatedList:
+        """
+        Parameters:
+            - limit: typing.Optional[int].
+
+            - offset: typing.Optional[int].
+
+            - project_id: typing.Optional[str].
+
+            - organization_id: typing.Optional[str].
+        ---
+        from llama_cloud.client import AsyncLlamaCloud
+
+        client = AsyncLlamaCloud(
+            token="YOUR_TOKEN",
+        )
+        await client.beta.list_batches()
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "GET",
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v1/beta/batches"),
+            params=remove_none_from_dict(
+                {"limit": limit, "offset": offset, "project_id": project_id, "organization_id": organization_id}
+            ),
+            headers=self._client_wrapper.get_headers(),
+            timeout=60,
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic.parse_obj_as(BatchPaginatedList, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _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)
+
+    async def create_batch(
+        self,
+        *,
+        organization_id: typing.Optional[str] = None,
+        project_id: typing.Optional[str] = None,
+        tool: str,
+        tool_data: typing.Optional[LlamaParseParameters] = OMIT,
+        input_type: str,
+        input_id: str,
+        output_type: typing.Optional[str] = OMIT,
+        output_id: typing.Optional[str] = OMIT,
+        batch_create_project_id: str,
+        external_id: str,
+        completion_window: typing.Optional[int] = OMIT,
+    ) -> Batch:
+        """
+        Parameters:
+            - organization_id: typing.Optional[str].
+
+            - project_id: typing.Optional[str].
+
+            - tool: str. The tool to be used for all requests in the batch.
+
+            - tool_data: typing.Optional[LlamaParseParameters].
 
             - input_type: str. The type of input file. Currently only 'datasource' is supported.
 
@@ -1661,7 +2372,7 @@ class AsyncBetaClient:
         *,
         project_id: typing.Optional[str] = None,
         organization_id: typing.Optional[str] = None,
-        agent_slug: str,
+        deployment_name: str,
         collection: typing.Optional[str] = OMIT,
         data: typing.Dict[str, typing.Any],
     ) -> AgentData:
@@ -1673,7 +2384,7 @@ class AsyncBetaClient:
 
             - organization_id: typing.Optional[str].
 
-            - agent_slug: str.
+            - deployment_name: str.
 
             - collection: typing.Optional[str].
 
@@ -1685,11 +2396,11 @@ class AsyncBetaClient:
             token="YOUR_TOKEN",
         )
         await client.beta.create_agent_data(
-            agent_slug="string",
+            deployment_name="string",
             data={"string": {}},
         )
         """
-        _request: typing.Dict[str, typing.Any] = {"agent_slug": agent_slug, "data": data}
+        _request: typing.Dict[str, typing.Any] = {"deployment_name": deployment_name, "data": data}
         if collection is not OMIT:
             _request["collection"] = collection
         _response = await self._client_wrapper.httpx_client.request(
@@ -1719,7 +2430,7 @@ class AsyncBetaClient:
         page_token: typing.Optional[str] = OMIT,
         filter: typing.Optional[typing.Dict[str, typing.Optional[FilterOperation]]] = OMIT,
         order_by: typing.Optional[str] = OMIT,
-        agent_slug: str,
+        deployment_name: str,
         collection: typing.Optional[str] = OMIT,
         include_total: typing.Optional[bool] = OMIT,
         offset: typing.Optional[int] = OMIT,
@@ -1740,7 +2451,7 @@ class AsyncBetaClient:
 
             - order_by: typing.Optional[str].
 
-            - agent_slug: str. The agent deployment's agent_slug to search within
+            - deployment_name: str. The agent deployment's name to search within
 
             - collection: typing.Optional[str]. The logical agent data collection to search within
 
@@ -1754,10 +2465,10 @@ class AsyncBetaClient:
             token="YOUR_TOKEN",
         )
         await client.beta.search_agent_data_api_v_1_beta_agent_data_search_post(
-            agent_slug="string",
+            deployment_name="string",
         )
         """
-        _request: typing.Dict[str, typing.Any] = {"agent_slug": agent_slug}
+        _request: typing.Dict[str, typing.Any] = {"deployment_name": deployment_name}
         if page_size is not OMIT:
             _request["page_size"] = page_size
         if page_token is not OMIT:
@@ -1799,7 +2510,7 @@ class AsyncBetaClient:
         page_token: typing.Optional[str] = OMIT,
         filter: typing.Optional[typing.Dict[str, typing.Optional[FilterOperation]]] = OMIT,
         order_by: typing.Optional[str] = OMIT,
-        agent_slug: str,
+        deployment_name: str,
         collection: typing.Optional[str] = OMIT,
         group_by: typing.Optional[typing.List[str]] = OMIT,
         count: typing.Optional[bool] = OMIT,
@@ -1822,7 +2533,7 @@ class AsyncBetaClient:
 
             - order_by: typing.Optional[str].
 
-            - agent_slug: str. The agent deployment's agent_slug to aggregate data for
+            - deployment_name: str. The agent deployment's name to aggregate data for
 
             - collection: typing.Optional[str]. The logical agent data collection to aggregate data for
 
@@ -1840,10 +2551,10 @@ class AsyncBetaClient:
             token="YOUR_TOKEN",
         )
         await client.beta.aggregate_agent_data_api_v_1_beta_agent_data_aggregate_post(
-            agent_slug="string",
+            deployment_name="string",
         )
         """
-        _request: typing.Dict[str, typing.Any] = {"agent_slug": agent_slug}
+        _request: typing.Dict[str, typing.Any] = {"deployment_name": deployment_name}
         if page_size is not OMIT:
             _request["page_size"] = page_size
         if page_token is not OMIT:
@@ -1880,6 +2591,61 @@ class AsyncBetaClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    async def delete_agent_data_by_query_api_v_1_beta_agent_data_delete_post(
+        self,
+        *,
+        project_id: typing.Optional[str] = None,
+        organization_id: typing.Optional[str] = None,
+        deployment_name: str,
+        collection: typing.Optional[str] = OMIT,
+        filter: typing.Optional[typing.Dict[str, typing.Optional[FilterOperation]]] = OMIT,
+    ) -> DeleteResponse:
+        """
+        Bulk delete agent data by query (deployment_name, collection, optional filters).
+
+        Parameters:
+            - project_id: typing.Optional[str].
+
+            - organization_id: typing.Optional[str].
+
+            - deployment_name: str. The agent deployment's name to delete data for
+
+            - collection: typing.Optional[str]. The logical agent data collection to delete from
+
+            - filter: typing.Optional[typing.Dict[str, typing.Optional[FilterOperation]]].
+        ---
+        from llama_cloud.client import AsyncLlamaCloud
+
+        client = AsyncLlamaCloud(
+            token="YOUR_TOKEN",
+        )
+        await client.beta.delete_agent_data_by_query_api_v_1_beta_agent_data_delete_post(
+            deployment_name="string",
+        )
+        """
+        _request: typing.Dict[str, typing.Any] = {"deployment_name": deployment_name}
+        if collection is not OMIT:
+            _request["collection"] = collection
+        if filter is not OMIT:
+            _request["filter"] = filter
+        _response = await self._client_wrapper.httpx_client.request(
+            "POST",
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v1/beta/agent-data/:delete"),
+            params=remove_none_from_dict({"project_id": project_id, "organization_id": organization_id}),
+            json=jsonable_encoder(_request),
+            headers=self._client_wrapper.get_headers(),
+            timeout=60,
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic.parse_obj_as(DeleteResponse, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _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)
+
     async def list_quota_configurations(
         self,
         *,
@@ -2662,3 +3428,223 @@ class AsyncBetaClient:
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    async def list_spreadsheet_jobs(
+        self,
+        *,
+        include_results: typing.Optional[bool] = None,
+        project_id: typing.Optional[str] = None,
+        organization_id: typing.Optional[str] = None,
+        page_size: typing.Optional[int] = None,
+        page_token: typing.Optional[str] = None,
+    ) -> PaginatedResponseSpreadsheetJob:
+        """
+        List spreadsheet parsing jobs.
+        Experimental: This endpoint is not yet ready for production use and is subject to change at any time.
+
+        Parameters:
+            - include_results: typing.Optional[bool].
+
+            - project_id: typing.Optional[str].
+
+            - organization_id: typing.Optional[str].
+
+            - page_size: typing.Optional[int].
+
+            - page_token: typing.Optional[str].
+        ---
+        from llama_cloud.client import AsyncLlamaCloud
+
+        client = AsyncLlamaCloud(
+            token="YOUR_TOKEN",
+        )
+        await client.beta.list_spreadsheet_jobs()
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "GET",
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v1/beta/spreadsheet/jobs"),
+            params=remove_none_from_dict(
+                {
+                    "include_results": include_results,
+                    "project_id": project_id,
+                    "organization_id": organization_id,
+                    "page_size": page_size,
+                    "page_token": page_token,
+                }
+            ),
+            headers=self._client_wrapper.get_headers(),
+            timeout=60,
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic.parse_obj_as(PaginatedResponseSpreadsheetJob, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _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)
+
+    async def create_spreadsheet_job(
+        self,
+        *,
+        project_id: typing.Optional[str] = None,
+        organization_id: typing.Optional[str] = None,
+        file_id: str,
+        config: typing.Optional[SpreadsheetParsingConfig] = OMIT,
+    ) -> SpreadsheetJob:
+        """
+        Create a spreadsheet parsing job.
+        Experimental: This endpoint is not yet ready for production use and is subject to change at any time.
+
+        Parameters:
+            - project_id: typing.Optional[str].
+
+            - organization_id: typing.Optional[str].
+
+            - file_id: str. The ID of the file to parse
+
+            - config: typing.Optional[SpreadsheetParsingConfig]. Configuration for the parsing job
+        ---
+        from llama_cloud import SpreadsheetParsingConfig
+        from llama_cloud.client import AsyncLlamaCloud
+
+        client = AsyncLlamaCloud(
+            token="YOUR_TOKEN",
+        )
+        await client.beta.create_spreadsheet_job(
+            file_id="string",
+            config=SpreadsheetParsingConfig(),
+        )
+        """
+        _request: typing.Dict[str, typing.Any] = {"file_id": file_id}
+        if config is not OMIT:
+            _request["config"] = config
+        _response = await self._client_wrapper.httpx_client.request(
+            "POST",
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v1/beta/spreadsheet/jobs"),
+            params=remove_none_from_dict({"project_id": project_id, "organization_id": organization_id}),
+            json=jsonable_encoder(_request),
+            headers=self._client_wrapper.get_headers(),
+            timeout=60,
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic.parse_obj_as(SpreadsheetJob, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _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)
+
+    async def get_spreadsheet_job(
+        self,
+        spreadsheet_job_id: str,
+        *,
+        include_results: typing.Optional[bool] = None,
+        project_id: typing.Optional[str] = None,
+        organization_id: typing.Optional[str] = None,
+    ) -> SpreadsheetJob:
+        """
+        Get a spreadsheet parsing job.
+
+        When include_results=True (default), the response will include extracted tables and results
+        if the job is complete, eliminating the need for a separate /results call.
+
+        Experimental: This endpoint is not yet ready for production use and is subject to change at any time.
+
+        Parameters:
+            - spreadsheet_job_id: str.
+
+            - include_results: typing.Optional[bool].
+
+            - project_id: typing.Optional[str].
+
+            - organization_id: typing.Optional[str].
+        ---
+        from llama_cloud.client import AsyncLlamaCloud
+
+        client = AsyncLlamaCloud(
+            token="YOUR_TOKEN",
+        )
+        await client.beta.get_spreadsheet_job(
+            spreadsheet_job_id="string",
+        )
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "GET",
+            urllib.parse.urljoin(
+                f"{self._client_wrapper.get_base_url()}/", f"api/v1/beta/spreadsheet/jobs/{spreadsheet_job_id}"
+            ),
+            params=remove_none_from_dict(
+                {"include_results": include_results, "project_id": project_id, "organization_id": organization_id}
+            ),
+            headers=self._client_wrapper.get_headers(),
+            timeout=60,
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic.parse_obj_as(SpreadsheetJob, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _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)
+
+    async def get_table_download_presigned_url(
+        self,
+        spreadsheet_job_id: str,
+        table_id: int,
+        *,
+        expires_at_seconds: typing.Optional[int] = None,
+        project_id: typing.Optional[str] = None,
+        organization_id: typing.Optional[str] = None,
+    ) -> PresignedUrl:
+        """
+        Generate a presigned URL to download a specific extracted table.
+        Experimental: This endpoint is not yet ready for production use and is subject to change at any time.
+
+        Parameters:
+            - spreadsheet_job_id: str.
+
+            - table_id: int.
+
+            - expires_at_seconds: typing.Optional[int].
+
+            - project_id: typing.Optional[str].
+
+            - organization_id: typing.Optional[str].
+        ---
+        from llama_cloud.client import AsyncLlamaCloud
+
+        client = AsyncLlamaCloud(
+            token="YOUR_TOKEN",
+        )
+        await client.beta.get_table_download_presigned_url(
+            spreadsheet_job_id="string",
+            table_id=1,
+        )
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "GET",
+            urllib.parse.urljoin(
+                f"{self._client_wrapper.get_base_url()}/",
+                f"api/v1/beta/spreadsheet/jobs/{spreadsheet_job_id}/tables/{table_id}/result",
+            ),
+            params=remove_none_from_dict(
+                {"expires_at_seconds": expires_at_seconds, "project_id": project_id, "organization_id": organization_id}
+            ),
+            headers=self._client_wrapper.get_headers(),
+            timeout=60,
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic.parse_obj_as(PresignedUrl, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _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)