blaxel 0.2.34__py3-none-any.whl → 0.2.35__py3-none-any.whl

blaxel/core/client/api/models/update_model.py

@@ -1,10 +1,11 @@
 from http import HTTPStatus
-from typing import Any
+from typing import Any, Union
 
 import httpx
 
 from ... import errors
 from ...client import Client
+from ...models.error import Error
 from ...models.model import Model
 from ...types import Response
 
@@ -33,18 +34,38 @@ def _get_kwargs(
     return _kwargs
 
 
-def _parse_response(*, client: Client, response: httpx.Response) -> Model | None:
+def _parse_response(*, client: Client, response: httpx.Response) -> Union[Error, Model] | None:
     if response.status_code == 200:
         response_200 = Model.from_dict(response.json())
 
         return response_200
+    if response.status_code == 400:
+        response_400 = Error.from_dict(response.json())
+
+        return response_400
+    if response.status_code == 401:
+        response_401 = Error.from_dict(response.json())
+
+        return response_401
+    if response.status_code == 403:
+        response_403 = Error.from_dict(response.json())
+
+        return response_403
+    if response.status_code == 404:
+        response_404 = Error.from_dict(response.json())
+
+        return response_404
+    if response.status_code == 500:
+        response_500 = Error.from_dict(response.json())
+
+        return response_500
     if client.raise_on_unexpected_status:
         raise errors.UnexpectedStatus(response.status_code, response.content)
     else:
         return None
 
 
-def _build_response(*, client: Client, response: httpx.Response) -> Response[Model]:
+def _build_response(*, client: Client, response: httpx.Response) -> Response[Union[Error, Model]]:
     return Response(
         status_code=HTTPStatus(response.status_code),
         content=response.content,
@@ -58,21 +79,23 @@ def sync_detailed(
     *,
     client: Client,
     body: Model,
-) -> Response[Model]:
-    """Create or update model
+) -> Response[Union[Error, Model]]:
+    """Update model endpoint
 
-     Update a model by name.
+     Updates a model gateway endpoint's configuration. Changes to provider settings or integration
+    connection take effect immediately.
 
     Args:
         model_name (str):
-        body (Model): Logical object representing a model
+        body (Model): Gateway endpoint to external LLM provider APIs (OpenAI, Anthropic, etc.)
+            with unified access control, credentials management, and usage tracking.
 
     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[Model]
+        Response[Union[Error, Model]]
     """
 
     kwargs = _get_kwargs(
@@ -92,21 +115,23 @@ def sync(
     *,
     client: Client,
     body: Model,
-) -> Model | None:
-    """Create or update model
+) -> Union[Error, Model] | None:
+    """Update model endpoint
 
-     Update a model by name.
+     Updates a model gateway endpoint's configuration. Changes to provider settings or integration
+    connection take effect immediately.
 
     Args:
         model_name (str):
-        body (Model): Logical object representing a model
+        body (Model): Gateway endpoint to external LLM provider APIs (OpenAI, Anthropic, etc.)
+            with unified access control, credentials management, and usage tracking.
 
     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:
-        Model
+        Union[Error, Model]
     """
 
     return sync_detailed(
@@ -121,21 +146,23 @@ async def asyncio_detailed(
     *,
     client: Client,
     body: Model,
-) -> Response[Model]:
-    """Create or update model
+) -> Response[Union[Error, Model]]:
+    """Update model endpoint
 
-     Update a model by name.
+     Updates a model gateway endpoint's configuration. Changes to provider settings or integration
+    connection take effect immediately.
 
     Args:
         model_name (str):
-        body (Model): Logical object representing a model
+        body (Model): Gateway endpoint to external LLM provider APIs (OpenAI, Anthropic, etc.)
+            with unified access control, credentials management, and usage tracking.
 
     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[Model]
+        Response[Union[Error, Model]]
     """
 
     kwargs = _get_kwargs(
@@ -153,21 +180,23 @@ async def asyncio(
     *,
     client: Client,
     body: Model,
-) -> Model | None:
-    """Create or update model
+) -> Union[Error, Model] | None:
+    """Update model endpoint
 
-     Update a model by name.
+     Updates a model gateway endpoint's configuration. Changes to provider settings or integration
+    connection take effect immediately.
 
     Args:
         model_name (str):
-        body (Model): Logical object representing a model
+        body (Model): Gateway endpoint to external LLM provider APIs (OpenAI, Anthropic, etc.)
+            with unified access control, credentials management, and usage tracking.
 
     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:
-        Model
+        Union[Error, Model]
     """
 
     return (

blaxel/core/client/api/policies/create_policy.py

@@ -57,9 +57,10 @@ def sync_detailed(
     client: Client,
     body: Policy,
 ) -> Response[Policy]:
-    """Create policy
+    """Create governance policy
 
-     Creates a policy.
+     Creates a new governance policy to control where and how resources are deployed. Policies can
+    restrict deployment to specific regions, countries, or continents for compliance.
 
     Args:
         body (Policy): Rule that controls how a deployment is made and served (e.g. location
@@ -89,9 +90,10 @@ def sync(
     client: Client,
     body: Policy,
 ) -> Policy | None:
-    """Create policy
+    """Create governance policy
 
-     Creates a policy.
+     Creates a new governance policy to control where and how resources are deployed. Policies can
+    restrict deployment to specific regions, countries, or continents for compliance.
 
     Args:
         body (Policy): Rule that controls how a deployment is made and served (e.g. location
@@ -116,9 +118,10 @@ async def asyncio_detailed(
     client: Client,
     body: Policy,
 ) -> Response[Policy]:
-    """Create policy
+    """Create governance policy
 
-     Creates a policy.
+     Creates a new governance policy to control where and how resources are deployed. Policies can
+    restrict deployment to specific regions, countries, or continents for compliance.
 
     Args:
         body (Policy): Rule that controls how a deployment is made and served (e.g. location
@@ -146,9 +149,10 @@ async def asyncio(
     client: Client,
     body: Policy,
 ) -> Policy | None:
-    """Create policy
+    """Create governance policy
 
-     Creates a policy.
+     Creates a new governance policy to control where and how resources are deployed. Policies can
+    restrict deployment to specific regions, countries, or continents for compliance.
 
     Args:
         body (Policy): Rule that controls how a deployment is made and served (e.g. location

blaxel/core/client/api/policies/delete_policy.py

@@ -45,9 +45,10 @@ def sync_detailed(
     *,
     client: Client,
 ) -> Response[Policy]:
-    """Delete policy
+    """Delete governance policy
 
-     Deletes a policy by name.
+     Permanently deletes a governance policy. Resources using this policy will need to be updated to use
+    a different policy.
 
     Args:
         policy_name (str):
@@ -76,9 +77,10 @@ def sync(
     *,
     client: Client,
 ) -> Policy | None:
-    """Delete policy
+    """Delete governance policy
 
-     Deletes a policy by name.
+     Permanently deletes a governance policy. Resources using this policy will need to be updated to use
+    a different policy.
 
     Args:
         policy_name (str):
@@ -102,9 +104,10 @@ async def asyncio_detailed(
     *,
     client: Client,
 ) -> Response[Policy]:
-    """Delete policy
+    """Delete governance policy
 
-     Deletes a policy by name.
+     Permanently deletes a governance policy. Resources using this policy will need to be updated to use
+    a different policy.
 
     Args:
         policy_name (str):
@@ -131,9 +134,10 @@ async def asyncio(
     *,
     client: Client,
 ) -> Policy | None:
-    """Delete policy
+    """Delete governance policy
 
-     Deletes a policy by name.
+     Permanently deletes a governance policy. Resources using this policy will need to be updated to use
+    a different policy.
 
     Args:
         policy_name (str):

blaxel/core/client/api/policies/get_policy.py

@@ -45,9 +45,10 @@ def sync_detailed(
     *,
     client: Client,
 ) -> Response[Policy]:
-    """Get policy
+    """Get governance policy
 
-     Returns a policy by name.
+     Returns detailed information about a governance policy including its type (location, flavor, or
+    maxToken), restrictions, and which resource types it applies to.
 
     Args:
         policy_name (str):
@@ -76,9 +77,10 @@ def sync(
     *,
     client: Client,
 ) -> Policy | None:
-    """Get policy
+    """Get governance policy
 
-     Returns a policy by name.
+     Returns detailed information about a governance policy including its type (location, flavor, or
+    maxToken), restrictions, and which resource types it applies to.
 
     Args:
         policy_name (str):
@@ -102,9 +104,10 @@ async def asyncio_detailed(
     *,
     client: Client,
 ) -> Response[Policy]:
-    """Get policy
+    """Get governance policy
 
-     Returns a policy by name.
+     Returns detailed information about a governance policy including its type (location, flavor, or
+    maxToken), restrictions, and which resource types it applies to.
 
     Args:
         policy_name (str):
@@ -131,9 +134,10 @@ async def asyncio(
     *,
     client: Client,
 ) -> Policy | None:
-    """Get policy
+    """Get governance policy
 
-     Returns a policy by name.
+     Returns detailed information about a governance policy including its type (location, flavor, or
+    maxToken), restrictions, and which resource types it applies to.
 
     Args:
         policy_name (str):

blaxel/core/client/api/policies/list_policies.py

@@ -47,9 +47,10 @@ def sync_detailed(
     *,
     client: Client,
 ) -> Response[list["Policy"]]:
-    """List policies
+    """List governance policies
 
-     Returns a list of all policies in the workspace.
+     Returns all governance policies in the workspace. Policies control deployment locations, hardware
+    flavors, and token limits for agents, functions, and models.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -72,9 +73,10 @@ def sync(
     *,
     client: Client,
 ) -> list["Policy"] | None:
-    """List policies
+    """List governance policies
 
-     Returns a list of all policies in the workspace.
+     Returns all governance policies in the workspace. Policies control deployment locations, hardware
+    flavors, and token limits for agents, functions, and models.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -93,9 +95,10 @@ async def asyncio_detailed(
     *,
     client: Client,
 ) -> Response[list["Policy"]]:
-    """List policies
+    """List governance policies
 
-     Returns a list of all policies in the workspace.
+     Returns all governance policies in the workspace. Policies control deployment locations, hardware
+    flavors, and token limits for agents, functions, and models.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -116,9 +119,10 @@ async def asyncio(
     *,
     client: Client,
 ) -> list["Policy"] | None:
-    """List policies
+    """List governance policies
 
-     Returns a list of all policies in the workspace.
+     Returns all governance policies in the workspace. Policies control deployment locations, hardware
+    flavors, and token limits for agents, functions, and models.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

blaxel/core/client/api/policies/update_policy.py

@@ -59,9 +59,10 @@ def sync_detailed(
     client: Client,
     body: Policy,
 ) -> Response[Policy]:
-    """Update policy
+    """Update governance policy
 
-     Updates a policy.
+     Updates a governance policy's restrictions. Changes take effect on the next deployment of resources
+    using this policy.
 
     Args:
         policy_name (str):
@@ -94,9 +95,10 @@ def sync(
     client: Client,
     body: Policy,
 ) -> Policy | None:
-    """Update policy
+    """Update governance policy
 
-     Updates a policy.
+     Updates a governance policy's restrictions. Changes take effect on the next deployment of resources
+    using this policy.
 
     Args:
         policy_name (str):
@@ -124,9 +126,10 @@ async def asyncio_detailed(
     client: Client,
     body: Policy,
 ) -> Response[Policy]:
-    """Update policy
+    """Update governance policy
 
-     Updates a policy.
+     Updates a governance policy's restrictions. Changes take effect on the next deployment of resources
+    using this policy.
 
     Args:
         policy_name (str):
@@ -157,9 +160,10 @@ async def asyncio(
     client: Client,
     body: Policy,
 ) -> Policy | None:
-    """Update policy
+    """Update governance policy
 
-     Updates a policy.
+     Updates a governance policy's restrictions. Changes take effect on the next deployment of resources
+    using this policy.
 
     Args:
         policy_name (str):

blaxel/core/client/api/public_ipslist/list_public_ips.py

@@ -1,18 +1,28 @@
 from http import HTTPStatus
-from typing import Any
+from typing import Any, Union
 
 import httpx
 
 from ... import errors
 from ...client import Client
 from ...models.public_ips import PublicIps
-from ...types import Response
+from ...types import UNSET, Response, Unset
 
 
-def _get_kwargs() -> dict[str, Any]:
+def _get_kwargs(
+    *,
+    region: Union[Unset, str] = UNSET,
+) -> dict[str, Any]:
+    params: dict[str, Any] = {}
+
+    params["region"] = region
+
+    params = {k: v for k, v in params.items() if v is not UNSET and v is not None}
+
     _kwargs: dict[str, Any] = {
         "method": "get",
         "url": "/publicIps",
+        "params": params,
     }
 
     return _kwargs
@@ -41,11 +51,15 @@ def _build_response(*, client: Client, response: httpx.Response) -> Response[Pub
 def sync_detailed(
     *,
     client: Client,
+    region: Union[Unset, str] = UNSET,
 ) -> Response[PublicIps]:
     """List public ips
 
      Returns a list of all public ips used in Blaxel..
 
+    Args:
+        region (Union[Unset, str]):
+
     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.
@@ -54,7 +68,9 @@ def sync_detailed(
         Response[PublicIps]
     """
 
-    kwargs = _get_kwargs()
+    kwargs = _get_kwargs(
+        region=region,
+    )
 
     response = client.get_httpx_client().request(
         **kwargs,
@@ -66,11 +82,15 @@ def sync_detailed(
 def sync(
     *,
     client: Client,
+    region: Union[Unset, str] = UNSET,
 ) -> PublicIps | None:
     """List public ips
 
      Returns a list of all public ips used in Blaxel..
 
+    Args:
+        region (Union[Unset, str]):
+
     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.
@@ -81,17 +101,22 @@ def sync(
 
     return sync_detailed(
         client=client,
+        region=region,
     ).parsed
 
 
 async def asyncio_detailed(
     *,
     client: Client,
+    region: Union[Unset, str] = UNSET,
 ) -> Response[PublicIps]:
     """List public ips
 
      Returns a list of all public ips used in Blaxel..
 
+    Args:
+        region (Union[Unset, str]):
+
     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.
@@ -100,7 +125,9 @@ async def asyncio_detailed(
         Response[PublicIps]
     """
 
-    kwargs = _get_kwargs()
+    kwargs = _get_kwargs(
+        region=region,
+    )
 
     response = await client.get_async_httpx_client().request(**kwargs)
 
@@ -110,11 +137,15 @@ async def asyncio_detailed(
 async def asyncio(
     *,
     client: Client,
+    region: Union[Unset, str] = UNSET,
 ) -> PublicIps | None:
     """List public ips
 
      Returns a list of all public ips used in Blaxel..
 
+    Args:
+        region (Union[Unset, str]):
+
     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.
@@ -126,5 +157,6 @@ async def asyncio(
     return (
         await asyncio_detailed(
             client=client,
+            region=region,
         )
     ).parsed

blaxel/core/client/api/{default → sandboxhub}/list_sandbox_hub_definitions.py

@@ -51,7 +51,11 @@ def sync_detailed(
     *,
     client: Client,
 ) -> Response[list["SandboxDefinition"]]:
-    """
+    """List Sandbox Hub templates
+
+     Returns all pre-built sandbox templates available in the Blaxel Hub. These include popular
+    development environments with pre-installed tools and frameworks.
+
     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.
@@ -73,7 +77,11 @@ def sync(
     *,
     client: Client,
 ) -> list["SandboxDefinition"] | None:
-    """
+    """List Sandbox Hub templates
+
+     Returns all pre-built sandbox templates available in the Blaxel Hub. These include popular
+    development environments with pre-installed tools and frameworks.
+
     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.
@@ -91,7 +99,11 @@ async def asyncio_detailed(
     *,
     client: Client,
 ) -> Response[list["SandboxDefinition"]]:
-    """
+    """List Sandbox Hub templates
+
+     Returns all pre-built sandbox templates available in the Blaxel Hub. These include popular
+    development environments with pre-installed tools and frameworks.
+
     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.
@@ -111,7 +123,11 @@ async def asyncio(
     *,
     client: Client,
 ) -> list["SandboxDefinition"] | None:
-    """
+    """List Sandbox Hub templates
+
+     Returns all pre-built sandbox templates available in the Blaxel Hub. These include popular
+    development environments with pre-installed tools and frameworks.
+
     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.

blaxel/core/client/api/service_accounts/create_api_key_for_service_account.py

@@ -60,9 +60,10 @@ def sync_detailed(
     client: Client,
     body: CreateApiKeyForServiceAccountBody,
 ) -> Response[ApiKey]:
-    """Create API key for service account
+    """Create service account API key
 
-     Creates an API key for a service account.
+     Creates a new long-lived API key for a service account. The full key value is only returned once at
+    creation. API keys can have optional expiration dates.
 
     Args:
         client_id (str):
@@ -94,9 +95,10 @@ def sync(
     client: Client,
     body: CreateApiKeyForServiceAccountBody,
 ) -> ApiKey | None:
-    """Create API key for service account
+    """Create service account API key
 
-     Creates an API key for a service account.
+     Creates a new long-lived API key for a service account. The full key value is only returned once at
+    creation. API keys can have optional expiration dates.
 
     Args:
         client_id (str):
@@ -123,9 +125,10 @@ async def asyncio_detailed(
     client: Client,
     body: CreateApiKeyForServiceAccountBody,
 ) -> Response[ApiKey]:
-    """Create API key for service account
+    """Create service account API key
 
-     Creates an API key for a service account.
+     Creates a new long-lived API key for a service account. The full key value is only returned once at
+    creation. API keys can have optional expiration dates.
 
     Args:
         client_id (str):
@@ -155,9 +158,10 @@ async def asyncio(
     client: Client,
     body: CreateApiKeyForServiceAccountBody,
 ) -> ApiKey | None:
-    """Create API key for service account
+    """Create service account API key
 
-     Creates an API key for a service account.
+     Creates a new long-lived API key for a service account. The full key value is only returned once at
+    creation. API keys can have optional expiration dates.
 
     Args:
         client_id (str):