cyberdesk 2.0.0__tar.gz → 2.1.0__tar.gz

{cyberdesk-2.0.0 → cyberdesk-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cyberdesk
-Version: 2.0.0
+Version: 2.1.0
 Summary: The official Python SDK for Cyberdesk
 Author-email: Cyberdesk Team <dev@cyberdesk.io>
 License-Expression: MIT

{cyberdesk-2.0.0 → cyberdesk-2.1.0}/cyberdesk/__init__.py

@@ -27,7 +27,7 @@ from .client import (
     AttachmentType,
 )
 
-__version__ = "2.0.0"
+__version__ = "2.1.0"
 
 __all__ = [
     "CyberdeskClient",

{cyberdesk-2.0.0 → cyberdesk-2.1.0}/cyberdesk/client.py

@@ -14,6 +14,17 @@ from openapi_client.cyberdesk_cloud_client.api.machines import (
     get_machine_v1_machines_machine_id_get,
     update_machine_v1_machines_machine_id_patch,
     delete_machine_v1_machines_machine_id_delete,
+    get_machine_pools_v1_machines_machine_id_pools_get,
+    update_machine_pools_v1_machines_machine_id_pools_put,
+)
+from openapi_client.cyberdesk_cloud_client.api.pools import (
+    list_pools_v1_pools_get,
+    create_pool_v1_pools_post,
+    get_pool_v1_pools_pool_id_get,
+    update_pool_v1_pools_pool_id_patch,
+    delete_pool_v1_pools_pool_id_delete,
+    add_machines_to_pool_v1_pools_pool_id_machines_post,
+    remove_machines_from_pool_v1_pools_pool_id_machines_delete,
 )
 from openapi_client.cyberdesk_cloud_client.api.workflows import (
     list_workflows_v1_workflows_get,
@@ -58,6 +69,12 @@ from openapi_client.cyberdesk_cloud_client.models import (
     MachineUpdate,
     MachineResponse,
     MachineStatus,
+    MachinePoolUpdate,
+    PoolCreate,
+    PoolUpdate,
+    PoolResponse,
+    PoolWithMachines,
+    MachinePoolAssignment,
     WorkflowCreate,
     WorkflowUpdate,
     WorkflowResponse,
@@ -80,6 +97,7 @@ from openapi_client.cyberdesk_cloud_client.models import (
     RunAttachmentDownloadUrlResponse,
     AttachmentType,
     PaginatedResponseMachineResponse,
+    PaginatedResponsePoolResponse,
     PaginatedResponseWorkflowResponse,
     PaginatedResponseRunResponse,
     PaginatedResponseConnectionResponse,
@@ -94,6 +112,12 @@ __all__ = [
     "MachineUpdate",
     "MachineResponse",
     "MachineStatus",
+    "MachinePoolUpdate",
+    "PoolCreate",
+    "PoolUpdate",
+    "PoolResponse",
+    "PoolWithMachines",
+    "MachinePoolAssignment",
     "WorkflowCreate",
     "WorkflowUpdate",
     "WorkflowResponse",
@@ -270,6 +294,299 @@ class MachinesAPI:
             return ApiResponse(data={"success": True})
         except Exception as e:
             return ApiResponse(error=e)
+    
+    async def get_pools(self, machine_id: str) -> ApiResponse:
+        """Get all pools that a machine belongs to."""
+        try:
+            response = await get_machine_pools_v1_machines_machine_id_pools_get.asyncio(
+                client=self.client,
+                machine_id=_to_uuid(machine_id)
+            )
+            return ApiResponse(data=response)
+        except Exception as e:
+            return ApiResponse(error=e)
+    
+    def get_pools_sync(self, machine_id: str) -> ApiResponse:
+        """Get all pools that a machine belongs to (synchronous)."""
+        try:
+            response = get_machine_pools_v1_machines_machine_id_pools_get.sync(
+                client=self.client,
+                machine_id=_to_uuid(machine_id)
+            )
+            return ApiResponse(data=response)
+        except Exception as e:
+            return ApiResponse(error=e)
+    
+    async def update_pools(self, machine_id: str, data: MachinePoolUpdate) -> ApiResponse:
+        """Update a machine's pool assignments.
+        
+        This replaces all existing pool assignments with the new ones.
+        
+        Args:
+            machine_id: The machine ID
+            data: MachinePoolUpdate with pool_ids list
+        
+        Returns:
+            ApiResponse with updated MachineResponse
+        """
+        try:
+            response = await update_machine_pools_v1_machines_machine_id_pools_put.asyncio(
+                client=self.client,
+                machine_id=_to_uuid(machine_id),
+                body=data
+            )
+            return ApiResponse(data=response)
+        except Exception as e:
+            return ApiResponse(error=e)
+    
+    def update_pools_sync(self, machine_id: str, data: MachinePoolUpdate) -> ApiResponse:
+        """Update a machine's pool assignments (synchronous).
+        
+        This replaces all existing pool assignments with the new ones.
+        
+        Args:
+            machine_id: The machine ID
+            data: MachinePoolUpdate with pool_ids list
+        
+        Returns:
+            ApiResponse with updated MachineResponse
+        """
+        try:
+            response = update_machine_pools_v1_machines_machine_id_pools_put.sync(
+                client=self.client,
+                machine_id=_to_uuid(machine_id),
+                body=data
+            )
+            return ApiResponse(data=response)
+        except Exception as e:
+            return ApiResponse(error=e)
+
+
+class PoolsAPI:
+    """Pools API endpoints."""
+    
+    def __init__(self, client: AuthenticatedClient):
+        self.client = client
+    
+    async def list(
+        self,
+        skip: Optional[int] = None,
+        limit: Optional[int] = None
+    ) -> ApiResponse:
+        """List pools for the organization."""
+        try:
+            response = await list_pools_v1_pools_get.asyncio(
+                client=self.client,
+                skip=_to_unset_or_value(skip),
+                limit=_to_unset_or_value(limit)
+            )
+            return ApiResponse(data=response)
+        except Exception as e:
+            return ApiResponse(error=e)
+    
+    def list_sync(
+        self,
+        skip: Optional[int] = None,
+        limit: Optional[int] = None
+    ) -> ApiResponse:
+        """List pools for the organization (synchronous)."""
+        try:
+            response = list_pools_v1_pools_get.sync(
+                client=self.client,
+                skip=_to_unset_or_value(skip),
+                limit=_to_unset_or_value(limit)
+            )
+            return ApiResponse(data=response)
+        except Exception as e:
+            return ApiResponse(error=e)
+    
+    async def create(self, data: PoolCreate) -> ApiResponse:
+        """Create a new pool."""
+        try:
+            response = await create_pool_v1_pools_post.asyncio(
+                client=self.client,
+                body=data
+            )
+            return ApiResponse(data=response)
+        except Exception as e:
+            return ApiResponse(error=e)
+    
+    def create_sync(self, data: PoolCreate) -> ApiResponse:
+        """Create a new pool (synchronous)."""
+        try:
+            response = create_pool_v1_pools_post.sync(
+                client=self.client,
+                body=data
+            )
+            return ApiResponse(data=response)
+        except Exception as e:
+            return ApiResponse(error=e)
+    
+    async def get(self, pool_id: str, include_machines: bool = False) -> ApiResponse:
+        """Get a specific pool by ID.
+        
+        Args:
+            pool_id: The pool ID
+            include_machines: Whether to include full machine details
+        
+        Returns:
+            ApiResponse with PoolResponse or PoolWithMachines
+        """
+        try:
+            response = await get_pool_v1_pools_pool_id_get.asyncio(
+                client=self.client,
+                pool_id=_to_uuid(pool_id),
+                include_machines=include_machines
+            )
+            return ApiResponse(data=response)
+        except Exception as e:
+            return ApiResponse(error=e)
+    
+    def get_sync(self, pool_id: str, include_machines: bool = False) -> ApiResponse:
+        """Get a specific pool by ID (synchronous).
+        
+        Args:
+            pool_id: The pool ID
+            include_machines: Whether to include full machine details
+        
+        Returns:
+            ApiResponse with PoolResponse or PoolWithMachines
+        """
+        try:
+            response = get_pool_v1_pools_pool_id_get.sync(
+                client=self.client,
+                pool_id=_to_uuid(pool_id),
+                include_machines=include_machines
+            )
+            return ApiResponse(data=response)
+        except Exception as e:
+            return ApiResponse(error=e)
+    
+    async def update(self, pool_id: str, data: PoolUpdate) -> ApiResponse:
+        """Update a pool's details."""
+        try:
+            response = await update_pool_v1_pools_pool_id_patch.asyncio(
+                client=self.client,
+                pool_id=_to_uuid(pool_id),
+                body=data
+            )
+            return ApiResponse(data=response)
+        except Exception as e:
+            return ApiResponse(error=e)
+    
+    def update_sync(self, pool_id: str, data: PoolUpdate) -> ApiResponse:
+        """Update a pool's details (synchronous)."""
+        try:
+            response = update_pool_v1_pools_pool_id_patch.sync(
+                client=self.client,
+                pool_id=_to_uuid(pool_id),
+                body=data
+            )
+            return ApiResponse(data=response)
+        except Exception as e:
+            return ApiResponse(error=e)
+    
+    async def delete(self, pool_id: str) -> ApiResponse:
+        """Delete a pool. This will not delete the machines in the pool."""
+        try:
+            await delete_pool_v1_pools_pool_id_delete.asyncio(
+                client=self.client,
+                pool_id=_to_uuid(pool_id)
+            )
+            return ApiResponse(data={"success": True})
+        except Exception as e:
+            return ApiResponse(error=e)
+    
+    def delete_sync(self, pool_id: str) -> ApiResponse:
+        """Delete a pool. This will not delete the machines in the pool (synchronous)."""
+        try:
+            delete_pool_v1_pools_pool_id_delete.sync(
+                client=self.client,
+                pool_id=_to_uuid(pool_id)
+            )
+            return ApiResponse(data={"success": True})
+        except Exception as e:
+            return ApiResponse(error=e)
+    
+    async def add_machines(self, pool_id: str, data: MachinePoolAssignment) -> ApiResponse:
+        """Add machines to a pool.
+        
+        Args:
+            pool_id: The pool ID
+            data: MachinePoolAssignment with machine_ids list
+        
+        Returns:
+            ApiResponse with PoolWithMachines
+        """
+        try:
+            response = await add_machines_to_pool_v1_pools_pool_id_machines_post.asyncio(
+                client=self.client,
+                pool_id=_to_uuid(pool_id),
+                body=data
+            )
+            return ApiResponse(data=response)
+        except Exception as e:
+            return ApiResponse(error=e)
+    
+    def add_machines_sync(self, pool_id: str, data: MachinePoolAssignment) -> ApiResponse:
+        """Add machines to a pool (synchronous).
+        
+        Args:
+            pool_id: The pool ID
+            data: MachinePoolAssignment with machine_ids list
+        
+        Returns:
+            ApiResponse with PoolWithMachines
+        """
+        try:
+            response = add_machines_to_pool_v1_pools_pool_id_machines_post.sync(
+                client=self.client,
+                pool_id=_to_uuid(pool_id),
+                body=data
+            )
+            return ApiResponse(data=response)
+        except Exception as e:
+            return ApiResponse(error=e)
+    
+    async def remove_machines(self, pool_id: str, data: MachinePoolAssignment) -> ApiResponse:
+        """Remove machines from a pool.
+        
+        Args:
+            pool_id: The pool ID
+            data: MachinePoolAssignment with machine_ids list
+        
+        Returns:
+            ApiResponse with success status
+        """
+        try:
+            await remove_machines_from_pool_v1_pools_pool_id_machines_delete.asyncio(
+                client=self.client,
+                pool_id=_to_uuid(pool_id),
+                body=data
+            )
+            return ApiResponse(data={"success": True})
+        except Exception as e:
+            return ApiResponse(error=e)
+    
+    def remove_machines_sync(self, pool_id: str, data: MachinePoolAssignment) -> ApiResponse:
+        """Remove machines from a pool (synchronous).
+        
+        Args:
+            pool_id: The pool ID
+            data: MachinePoolAssignment with machine_ids list
+        
+        Returns:
+            ApiResponse with success status
+        """
+        try:
+            remove_machines_from_pool_v1_pools_pool_id_machines_delete.sync(
+                client=self.client,
+                pool_id=_to_uuid(pool_id),
+                body=data
+            )
+            return ApiResponse(data={"success": True})
+        except Exception as e:
+            return ApiResponse(error=e)
 
 
 class WorkflowsAPI:
@@ -444,7 +761,19 @@ class RunsAPI:
             return ApiResponse(error=e)
     
     async def create(self, data: RunCreate) -> ApiResponse:
-        """Create a new run."""
+        """Create a new run.
+        
+        Args:
+            data: RunCreate object with:
+                - workflow_id: The workflow to run
+                - machine_id: Optional specific machine ID
+                - pool_ids: Optional list of pool IDs (machine must be in ALL specified pools)
+                - input_values: Optional input values for workflow variables
+                - file_inputs: Optional files to upload to the machine
+        
+        Returns:
+            ApiResponse with RunResponse
+        """
         try:
             response = await create_run_v1_runs_post.asyncio(
                 client=self.client,
@@ -455,7 +784,19 @@ class RunsAPI:
             return ApiResponse(error=e)
     
     def create_sync(self, data: RunCreate) -> ApiResponse:
-        """Create a new run (synchronous)."""
+        """Create a new run (synchronous).
+        
+        Args:
+            data: RunCreate object with:
+                - workflow_id: The workflow to run
+                - machine_id: Optional specific machine ID
+                - pool_ids: Optional list of pool IDs (machine must be in ALL specified pools)
+                - input_values: Optional input values for workflow variables
+                - file_inputs: Optional files to upload to the machine
+        
+        Returns:
+            ApiResponse with RunResponse
+        """
         try:
             response = create_run_v1_runs_post.sync(
                 client=self.client,
@@ -542,8 +883,13 @@ class RunsAPI:
         - Returns immediately with created run details
         
         Args:
-            data: RunBulkCreate object containing workflow_id, machine_id, 
-                  input_values, file_inputs, and count (max 1000)
+            data: RunBulkCreate object containing:
+                - workflow_id: The workflow to run
+                - machine_id: Optional specific machine ID 
+                - pool_ids: Optional list of pool IDs (machine must be in ALL specified pools)
+                - input_values: Optional input values for workflow variables
+                - file_inputs: Optional files to upload to the machine
+                - count: Number of runs to create (max 1000)
         
         Returns:
             ApiResponse with RunBulkCreateResponse containing:
@@ -569,8 +915,13 @@ class RunsAPI:
         - Returns immediately with created run details
         
         Args:
-            data: RunBulkCreate object containing workflow_id, machine_id, 
-                  input_values, file_inputs, and count (max 1000)
+            data: RunBulkCreate object containing:
+                - workflow_id: The workflow to run
+                - machine_id: Optional specific machine ID 
+                - pool_ids: Optional list of pool IDs (machine must be in ALL specified pools)
+                - input_values: Optional input values for workflow variables
+                - file_inputs: Optional files to upload to the machine
+                - count: Number of runs to create (max 1000)
         
         Returns:
             ApiResponse with RunBulkCreateResponse containing:
@@ -1173,6 +1524,7 @@ class CyberdeskClient:
         
         # Initialize API endpoints
         self.machines = MachinesAPI(self._client)
+        self.pools = PoolsAPI(self._client)
         self.workflows = WorkflowsAPI(self._client)
         self.runs = RunsAPI(self._client)
         self.connections = ConnectionsAPI(self._client)

{cyberdesk-2.0.0 → cyberdesk-2.1.0}/cyberdesk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cyberdesk
-Version: 2.0.0
+Version: 2.1.0
 Summary: The official Python SDK for Cyberdesk
 Author-email: Cyberdesk Team <dev@cyberdesk.io>
 License-Expression: MIT

{cyberdesk-2.0.0 → cyberdesk-2.1.0}/cyberdesk.egg-info/SOURCES.txt

@@ -41,9 +41,19 @@ openapi_client/cyberdesk_cloud_client/api/health/health_check_v1_health_get.py
 openapi_client/cyberdesk_cloud_client/api/machines/__init__.py
 openapi_client/cyberdesk_cloud_client/api/machines/create_machine_v1_machines_post.py
 openapi_client/cyberdesk_cloud_client/api/machines/delete_machine_v1_machines_machine_id_delete.py
+openapi_client/cyberdesk_cloud_client/api/machines/get_machine_pools_v1_machines_machine_id_pools_get.py
 openapi_client/cyberdesk_cloud_client/api/machines/get_machine_v1_machines_machine_id_get.py
 openapi_client/cyberdesk_cloud_client/api/machines/list_machines_v1_machines_get.py
+openapi_client/cyberdesk_cloud_client/api/machines/update_machine_pools_v1_machines_machine_id_pools_put.py
 openapi_client/cyberdesk_cloud_client/api/machines/update_machine_v1_machines_machine_id_patch.py
+openapi_client/cyberdesk_cloud_client/api/pools/__init__.py
+openapi_client/cyberdesk_cloud_client/api/pools/add_machines_to_pool_v1_pools_pool_id_machines_post.py
+openapi_client/cyberdesk_cloud_client/api/pools/create_pool_v1_pools_post.py
+openapi_client/cyberdesk_cloud_client/api/pools/delete_pool_v1_pools_pool_id_delete.py
+openapi_client/cyberdesk_cloud_client/api/pools/get_pool_v1_pools_pool_id_get.py
+openapi_client/cyberdesk_cloud_client/api/pools/list_pools_v1_pools_get.py
+openapi_client/cyberdesk_cloud_client/api/pools/remove_machines_from_pool_v1_pools_pool_id_machines_delete.py
+openapi_client/cyberdesk_cloud_client/api/pools/update_pool_v1_pools_pool_id_patch.py
 openapi_client/cyberdesk_cloud_client/api/request_logs/__init__.py
 openapi_client/cyberdesk_cloud_client/api/request_logs/create_request_log_v1_request_logs_post.py
 openapi_client/cyberdesk_cloud_client/api/request_logs/delete_request_log_v1_request_logs_log_id_delete.py
@@ -100,6 +110,8 @@ openapi_client/cyberdesk_cloud_client/models/http_validation_error.py
 openapi_client/cyberdesk_cloud_client/models/keyboard_key_request.py
 openapi_client/cyberdesk_cloud_client/models/keyboard_type_request.py
 openapi_client/cyberdesk_cloud_client/models/machine_create.py
+openapi_client/cyberdesk_cloud_client/models/machine_pool_assignment.py
+openapi_client/cyberdesk_cloud_client/models/machine_pool_update.py
 openapi_client/cyberdesk_cloud_client/models/machine_response.py
 openapi_client/cyberdesk_cloud_client/models/machine_status.py
 openapi_client/cyberdesk_cloud_client/models/machine_update.py
@@ -109,10 +121,15 @@ openapi_client/cyberdesk_cloud_client/models/mouse_position.py
 openapi_client/cyberdesk_cloud_client/models/paginated_response.py
 openapi_client/cyberdesk_cloud_client/models/paginated_response_connection_response.py
 openapi_client/cyberdesk_cloud_client/models/paginated_response_machine_response.py
+openapi_client/cyberdesk_cloud_client/models/paginated_response_pool_response.py
 openapi_client/cyberdesk_cloud_client/models/paginated_response_run_attachment_response.py
 openapi_client/cyberdesk_cloud_client/models/paginated_response_run_response.py
 openapi_client/cyberdesk_cloud_client/models/paginated_response_trajectory_response.py
 openapi_client/cyberdesk_cloud_client/models/paginated_response_workflow_response.py
+openapi_client/cyberdesk_cloud_client/models/pool_create.py
+openapi_client/cyberdesk_cloud_client/models/pool_response.py
+openapi_client/cyberdesk_cloud_client/models/pool_update.py
+openapi_client/cyberdesk_cloud_client/models/pool_with_machines.py
 openapi_client/cyberdesk_cloud_client/models/power_shell_exec_request.py
 openapi_client/cyberdesk_cloud_client/models/power_shell_session_request.py
 openapi_client/cyberdesk_cloud_client/models/powershell_exec_v1_computer_machine_id_shell_powershell_exec_post_response_powershell_exec_v1_computer_machine_id_shell_powershell_exec_post.py

cyberdesk-2.1.0/openapi_client/cyberdesk_cloud_client/api/machines/get_machine_pools_v1_machines_machine_id_pools_get.py

@@ -0,0 +1,169 @@
+from http import HTTPStatus
+from typing import Any, Optional, Union
+from uuid import UUID
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.http_validation_error import HTTPValidationError
+from ...models.pool_response import PoolResponse
+from ...types import Response
+
+
+def _get_kwargs(
+    machine_id: UUID,
+) -> dict[str, Any]:
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": f"/v1/machines/{machine_id}/pools",
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: Union[AuthenticatedClient, Client], response: httpx.Response
+) -> Optional[Union[HTTPValidationError, list["PoolResponse"]]]:
+    if response.status_code == 200:
+        response_200 = []
+        _response_200 = response.json()
+        for response_200_item_data in _response_200:
+            response_200_item = PoolResponse.from_dict(response_200_item_data)
+
+            response_200.append(response_200_item)
+
+        return response_200
+    if response.status_code == 422:
+        response_422 = HTTPValidationError.from_dict(response.json())
+
+        return response_422
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: Union[AuthenticatedClient, Client], response: httpx.Response
+) -> Response[Union[HTTPValidationError, list["PoolResponse"]]]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    machine_id: UUID,
+    *,
+    client: AuthenticatedClient,
+) -> Response[Union[HTTPValidationError, list["PoolResponse"]]]:
+    """Get Machine Pools
+
+     Get all pools that a machine belongs to.
+
+    Args:
+        machine_id (UUID):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Union[HTTPValidationError, list['PoolResponse']]]
+    """
+
+    kwargs = _get_kwargs(
+        machine_id=machine_id,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    machine_id: UUID,
+    *,
+    client: AuthenticatedClient,
+) -> Optional[Union[HTTPValidationError, list["PoolResponse"]]]:
+    """Get Machine Pools
+
+     Get all pools that a machine belongs to.
+
+    Args:
+        machine_id (UUID):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Union[HTTPValidationError, list['PoolResponse']]
+    """
+
+    return sync_detailed(
+        machine_id=machine_id,
+        client=client,
+    ).parsed
+
+
+async def asyncio_detailed(
+    machine_id: UUID,
+    *,
+    client: AuthenticatedClient,
+) -> Response[Union[HTTPValidationError, list["PoolResponse"]]]:
+    """Get Machine Pools
+
+     Get all pools that a machine belongs to.
+
+    Args:
+        machine_id (UUID):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Union[HTTPValidationError, list['PoolResponse']]]
+    """
+
+    kwargs = _get_kwargs(
+        machine_id=machine_id,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    machine_id: UUID,
+    *,
+    client: AuthenticatedClient,
+) -> Optional[Union[HTTPValidationError, list["PoolResponse"]]]:
+    """Get Machine Pools
+
+     Get all pools that a machine belongs to.
+
+    Args:
+        machine_id (UUID):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Union[HTTPValidationError, list['PoolResponse']]
+    """
+
+    return (
+        await asyncio_detailed(
+            machine_id=machine_id,
+            client=client,
+        )
+    ).parsed