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

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

@@ -64,9 +64,10 @@ def sync_detailed(
     client: Client,
     body: CreateWorkspaceServiceAccountBody,
 ) -> Response[CreateWorkspaceServiceAccountResponse200]:
-    """Create workspace service account
+    """Create service account
 
-     Creates a service account in the workspace.
+     Creates a new service account for machine-to-machine authentication. Returns client ID and secret
+    (secret is only shown once at creation). Use these credentials for OAuth client_credentials flow.
 
     Args:
         body (CreateWorkspaceServiceAccountBody):
@@ -95,9 +96,10 @@ def sync(
     client: Client,
     body: CreateWorkspaceServiceAccountBody,
 ) -> CreateWorkspaceServiceAccountResponse200 | None:
-    """Create workspace service account
+    """Create service account
 
-     Creates a service account in the workspace.
+     Creates a new service account for machine-to-machine authentication. Returns client ID and secret
+    (secret is only shown once at creation). Use these credentials for OAuth client_credentials flow.
 
     Args:
         body (CreateWorkspaceServiceAccountBody):
@@ -121,9 +123,10 @@ async def asyncio_detailed(
     client: Client,
     body: CreateWorkspaceServiceAccountBody,
 ) -> Response[CreateWorkspaceServiceAccountResponse200]:
-    """Create workspace service account
+    """Create service account
 
-     Creates a service account in the workspace.
+     Creates a new service account for machine-to-machine authentication. Returns client ID and secret
+    (secret is only shown once at creation). Use these credentials for OAuth client_credentials flow.
 
     Args:
         body (CreateWorkspaceServiceAccountBody):
@@ -150,9 +153,10 @@ async def asyncio(
     client: Client,
     body: CreateWorkspaceServiceAccountBody,
 ) -> CreateWorkspaceServiceAccountResponse200 | None:
-    """Create workspace service account
+    """Create service account
 
-     Creates a service account in the workspace.
+     Creates a new service account for machine-to-machine authentication. Returns client ID and secret
+    (secret is only shown once at creation). Use these credentials for OAuth client_credentials flow.
 
     Args:
         body (CreateWorkspaceServiceAccountBody):

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

@@ -44,9 +44,10 @@ def sync_detailed(
     *,
     client: Client,
 ) -> Response[Any]:
-    """Delete API key for service account
+    """Revoke service account API key
 
-     Deletes an API key for a service account.
+     Revokes an API key for a service account. The key becomes invalid immediately and any requests using
+    it will fail authentication.
 
     Args:
         client_id (str):
@@ -78,9 +79,10 @@ async def asyncio_detailed(
     *,
     client: Client,
 ) -> Response[Any]:
-    """Delete API key for service account
+    """Revoke service account API key
 
-     Deletes an API key for a service account.
+     Revokes an API key for a service account. The key becomes invalid immediately and any requests using
+    it will fail authentication.
 
     Args:
         client_id (str):

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

@@ -51,9 +51,10 @@ def sync_detailed(
     *,
     client: Client,
 ) -> Response[DeleteWorkspaceServiceAccountResponse200]:
-    """Delete workspace service account
+    """Delete service account
 
-     Deletes a service account.
+     Permanently deletes a service account and invalidates all its credentials. Any systems using this
+    service account will lose access immediately.
 
     Args:
         client_id (str):
@@ -82,9 +83,10 @@ def sync(
     *,
     client: Client,
 ) -> DeleteWorkspaceServiceAccountResponse200 | None:
-    """Delete workspace service account
+    """Delete service account
 
-     Deletes a service account.
+     Permanently deletes a service account and invalidates all its credentials. Any systems using this
+    service account will lose access immediately.
 
     Args:
         client_id (str):
@@ -108,9 +110,10 @@ async def asyncio_detailed(
     *,
     client: Client,
 ) -> Response[DeleteWorkspaceServiceAccountResponse200]:
-    """Delete workspace service account
+    """Delete service account
 
-     Deletes a service account.
+     Permanently deletes a service account and invalidates all its credentials. Any systems using this
+    service account will lose access immediately.
 
     Args:
         client_id (str):
@@ -137,9 +140,10 @@ async def asyncio(
     *,
     client: Client,
 ) -> DeleteWorkspaceServiceAccountResponse200 | None:
-    """Delete workspace service account
+    """Delete service account
 
-     Deletes a service account.
+     Permanently deletes a service account and invalidates all its credentials. Any systems using this
+    service account will lose access immediately.
 
     Args:
         client_id (str):

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

@@ -55,9 +55,10 @@ def sync_detailed(
     *,
     client: Client,
 ) -> Response[list["GetWorkspaceServiceAccountsResponse200Item"]]:
-    """Get workspace service accounts
+    """List service accounts
 
-     Returns a list of all service accounts in the workspace.
+     Returns all service accounts in the workspace. Service accounts are machine identities for external
+    systems to authenticate with Blaxel via OAuth or API keys.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -80,9 +81,10 @@ def sync(
     *,
     client: Client,
 ) -> list["GetWorkspaceServiceAccountsResponse200Item"] | None:
-    """Get workspace service accounts
+    """List service accounts
 
-     Returns a list of all service accounts in the workspace.
+     Returns all service accounts in the workspace. Service accounts are machine identities for external
+    systems to authenticate with Blaxel via OAuth or API keys.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -101,9 +103,10 @@ async def asyncio_detailed(
     *,
     client: Client,
 ) -> Response[list["GetWorkspaceServiceAccountsResponse200Item"]]:
-    """Get workspace service accounts
+    """List service accounts
 
-     Returns a list of all service accounts in the workspace.
+     Returns all service accounts in the workspace. Service accounts are machine identities for external
+    systems to authenticate with Blaxel via OAuth or API keys.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -124,9 +127,10 @@ async def asyncio(
     *,
     client: Client,
 ) -> list["GetWorkspaceServiceAccountsResponse200Item"] | None:
-    """Get workspace service accounts
+    """List service accounts
 
-     Returns a list of all service accounts in the workspace.
+     Returns all service accounts in the workspace. Service accounts are machine identities for external
+    systems to authenticate with Blaxel via OAuth or API keys.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

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

@@ -50,9 +50,10 @@ def sync_detailed(
     *,
     client: Client,
 ) -> Response[list["ApiKey"]]:
-    """List API keys for service account
+    """List service account API keys
 
-     Returns a list of all API keys for a service account.
+     Returns all long-lived API keys created for a service account. API keys provide an alternative to
+    OAuth for simpler authentication scenarios.
 
     Args:
         client_id (str):
@@ -81,9 +82,10 @@ def sync(
     *,
     client: Client,
 ) -> list["ApiKey"] | None:
-    """List API keys for service account
+    """List service account API keys
 
-     Returns a list of all API keys for a service account.
+     Returns all long-lived API keys created for a service account. API keys provide an alternative to
+    OAuth for simpler authentication scenarios.
 
     Args:
         client_id (str):
@@ -107,9 +109,10 @@ async def asyncio_detailed(
     *,
     client: Client,
 ) -> Response[list["ApiKey"]]:
-    """List API keys for service account
+    """List service account API keys
 
-     Returns a list of all API keys for a service account.
+     Returns all long-lived API keys created for a service account. API keys provide an alternative to
+    OAuth for simpler authentication scenarios.
 
     Args:
         client_id (str):
@@ -136,9 +139,10 @@ async def asyncio(
     *,
     client: Client,
 ) -> list["ApiKey"] | None:
-    """List API keys for service account
+    """List service account API keys
 
-     Returns a list of all API keys for a service account.
+     Returns all long-lived API keys created for a service account. API keys provide an alternative to
+    OAuth for simpler authentication scenarios.
 
     Args:
         client_id (str):

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

@@ -66,9 +66,9 @@ def sync_detailed(
     client: Client,
     body: UpdateWorkspaceServiceAccountBody,
 ) -> Response[UpdateWorkspaceServiceAccountResponse200]:
-    """Update workspace service account
+    """Update service account
 
-     Updates a service account.
+     Updates a service account's name or description. Credentials (client ID/secret) cannot be changed.
 
     Args:
         client_id (str):
@@ -100,9 +100,9 @@ def sync(
     client: Client,
     body: UpdateWorkspaceServiceAccountBody,
 ) -> UpdateWorkspaceServiceAccountResponse200 | None:
-    """Update workspace service account
+    """Update service account
 
-     Updates a service account.
+     Updates a service account's name or description. Credentials (client ID/secret) cannot be changed.
 
     Args:
         client_id (str):
@@ -129,9 +129,9 @@ async def asyncio_detailed(
     client: Client,
     body: UpdateWorkspaceServiceAccountBody,
 ) -> Response[UpdateWorkspaceServiceAccountResponse200]:
-    """Update workspace service account
+    """Update service account
 
-     Updates a service account.
+     Updates a service account's name or description. Credentials (client ID/secret) cannot be changed.
 
     Args:
         client_id (str):
@@ -161,9 +161,9 @@ async def asyncio(
     client: Client,
     body: UpdateWorkspaceServiceAccountBody,
 ) -> UpdateWorkspaceServiceAccountResponse200 | None:
-    """Update workspace service account
+    """Update service account
 
-     Updates a service account.
+     Updates a service account's name or description. Credentials (client ID/secret) cannot be changed.
 
     Args:
         client_id (str):

blaxel/core/client/api/templates/list_templates.py

@@ -47,9 +47,10 @@ def sync_detailed(
     *,
     client: Client,
 ) -> Response[list["Template"]]:
-    """List templates
+    """List deployment templates
 
-     Returns a list of all templates.
+     Returns all deployment templates available for creating agents, functions, and other resources with
+    pre-configured settings and code.
 
     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["Template"] | None:
-    """List templates
+    """List deployment templates
 
-     Returns a list of all templates.
+     Returns all deployment templates available for creating agents, functions, and other resources with
+    pre-configured settings and code.
 
     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["Template"]]:
-    """List templates
+    """List deployment templates
 
-     Returns a list of all templates.
+     Returns all deployment templates available for creating agents, functions, and other resources with
+    pre-configured settings and code.
 
     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["Template"] | None:
-    """List templates
+    """List deployment templates
 
-     Returns a list of all templates.
+     Returns all deployment templates available for creating agents, functions, and other resources with
+    pre-configured settings and code.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

blaxel/core/client/api/volume_templates/create_volume_template.py

@@ -72,7 +72,8 @@ def sync_detailed(
 ) -> Response[VolumeTemplate]:
     """Create volume template
 
-     Creates a volume template.
+     Creates a new volume template for initializing volumes with pre-configured filesystem contents.
+    Optionally returns a presigned URL for uploading the template archive.
 
     Args:
         upload (Union[Unset, bool]):
@@ -109,7 +110,8 @@ def sync(
 ) -> VolumeTemplate | None:
     """Create volume template
 
-     Creates a volume template.
+     Creates a new volume template for initializing volumes with pre-configured filesystem contents.
+    Optionally returns a presigned URL for uploading the template archive.
 
     Args:
         upload (Union[Unset, bool]):
@@ -141,7 +143,8 @@ async def asyncio_detailed(
 ) -> Response[VolumeTemplate]:
     """Create volume template
 
-     Creates a volume template.
+     Creates a new volume template for initializing volumes with pre-configured filesystem contents.
+    Optionally returns a presigned URL for uploading the template archive.
 
     Args:
         upload (Union[Unset, bool]):
@@ -176,7 +179,8 @@ async def asyncio(
 ) -> VolumeTemplate | None:
     """Create volume template
 
-     Creates a volume template.
+     Creates a new volume template for initializing volumes with pre-configured filesystem contents.
+    Optionally returns a presigned URL for uploading the template archive.
 
     Args:
         upload (Union[Unset, bool]):

blaxel/core/client/api/volume_templates/list_volume_templates.py

@@ -51,7 +51,8 @@ def sync_detailed(
 ) -> Response[list["VolumeTemplate"]]:
     """List volume templates
 
-     Returns a list of all volume templates.
+     Returns all volume templates in the workspace. Volume templates contain pre-configured filesystem
+    snapshots that can be used to initialize new volumes.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -76,7 +77,8 @@ def sync(
 ) -> list["VolumeTemplate"] | None:
     """List volume templates
 
-     Returns a list of all volume templates.
+     Returns all volume templates in the workspace. Volume templates contain pre-configured filesystem
+    snapshots that can be used to initialize new volumes.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -97,7 +99,8 @@ async def asyncio_detailed(
 ) -> Response[list["VolumeTemplate"]]:
     """List volume templates
 
-     Returns a list of all volume templates.
+     Returns all volume templates in the workspace. Volume templates contain pre-configured filesystem
+    snapshots that can be used to initialize new volumes.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -120,7 +123,8 @@ async def asyncio(
 ) -> list["VolumeTemplate"] | None:
     """List volume templates
 
-     Returns a list of all volume templates.
+     Returns all volume templates in the workspace. Volume templates contain pre-configured filesystem
+    snapshots that can be used to initialize new volumes.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

blaxel/core/client/api/volumes/create_volume.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.volume import Volume
 from ...types import Response
 
@@ -32,18 +33,38 @@ def _get_kwargs(
     return _kwargs
 
 
-def _parse_response(*, client: Client, response: httpx.Response) -> Volume | None:
+def _parse_response(*, client: Client, response: httpx.Response) -> Union[Error, Volume] | None:
     if response.status_code == 200:
         response_200 = Volume.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 == 409:
+        response_409 = Error.from_dict(response.json())
+
+        return response_409
+    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[Volume]:
+def _build_response(*, client: Client, response: httpx.Response) -> Response[Union[Error, Volume]]:
     return Response(
         status_code=HTTPStatus(response.status_code),
         content=response.content,
@@ -56,20 +77,23 @@ def sync_detailed(
     *,
     client: Client,
     body: Volume,
-) -> Response[Volume]:
-    """Create volume
+) -> Response[Union[Error, Volume]]:
+    """Create persistent volume
 
-     Creates a volume.
+     Creates a new persistent storage volume that can be attached to sandboxes. Volumes must be created
+    in a specific region and can only attach to sandboxes in the same region.
 
     Args:
-        body (Volume): Volume resource for persistent storage
+        body (Volume): Persistent storage volume that can be attached to sandboxes for durable
+            file storage across sessions. Volumes survive sandbox deletion and can be reattached to
+            new sandboxes.
 
     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[Volume]
+        Response[Union[Error, Volume]]
     """
 
     kwargs = _get_kwargs(
@@ -87,20 +111,23 @@ def sync(
     *,
     client: Client,
     body: Volume,
-) -> Volume | None:
-    """Create volume
+) -> Union[Error, Volume] | None:
+    """Create persistent volume
 
-     Creates a volume.
+     Creates a new persistent storage volume that can be attached to sandboxes. Volumes must be created
+    in a specific region and can only attach to sandboxes in the same region.
 
     Args:
-        body (Volume): Volume resource for persistent storage
+        body (Volume): Persistent storage volume that can be attached to sandboxes for durable
+            file storage across sessions. Volumes survive sandbox deletion and can be reattached to
+            new sandboxes.
 
     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:
-        Volume
+        Union[Error, Volume]
     """
 
     return sync_detailed(
@@ -113,20 +140,23 @@ async def asyncio_detailed(
     *,
     client: Client,
     body: Volume,
-) -> Response[Volume]:
-    """Create volume
+) -> Response[Union[Error, Volume]]:
+    """Create persistent volume
 
-     Creates a volume.
+     Creates a new persistent storage volume that can be attached to sandboxes. Volumes must be created
+    in a specific region and can only attach to sandboxes in the same region.
 
     Args:
-        body (Volume): Volume resource for persistent storage
+        body (Volume): Persistent storage volume that can be attached to sandboxes for durable
+            file storage across sessions. Volumes survive sandbox deletion and can be reattached to
+            new sandboxes.
 
     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[Volume]
+        Response[Union[Error, Volume]]
     """
 
     kwargs = _get_kwargs(
@@ -142,20 +172,23 @@ async def asyncio(
     *,
     client: Client,
     body: Volume,
-) -> Volume | None:
-    """Create volume
+) -> Union[Error, Volume] | None:
+    """Create persistent volume
 
-     Creates a volume.
+     Creates a new persistent storage volume that can be attached to sandboxes. Volumes must be created
+    in a specific region and can only attach to sandboxes in the same region.
 
     Args:
-        body (Volume): Volume resource for persistent storage
+        body (Volume): Persistent storage volume that can be attached to sandboxes for durable
+            file storage across sessions. Volumes survive sandbox deletion and can be reattached to
+            new sandboxes.
 
     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:
-        Volume
+        Union[Error, Volume]
     """
 
     return (