render 1.3.0__tar.gz → 1.4.0__tar.gz

{render-1.3.0 → render-1.4.0}/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [1.4.0] - 2026-10-21
+
+### Added
+
+- (Sandboxes) `sandboxes.create()` accepts `idle_timeout_seconds`; use `0` to disable automatic idle suspension. Returned `Sandbox` values expose the effective setting.
+- (Sandboxes) `sandboxes.create()` accepts any plan string.
+
+### Changed
+
+- (Sandboxes) `snapshots.create()` no longer defaults `kind` to `"filesystem"`. When `kind` is omitted the API picks the default, which is currently `runtime`. Pass `kind="filesystem"` to keep the previous behavior.
+- (Workflows) Idempotency keys are scoped to the workflow rather than a single workflow version, so the same key resolves to the original run across deploys. This is a documentation change; the SDK sends the key as before.
+- **Breaking:** (REST API) Removed the unused `update_sandbox_exec` endpoint and its request and response models. Error codes include `sandbox_group_suspended` and `sandbox_group_limit_reached`.
+
 ## [1.3.0] - 2026-10-17
 
 ### Added

{render-1.3.0 → render-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: render
-Version: 1.3.0
+Version: 1.4.0
 Summary: Python SDK for Render Workflows
 Author-email: Render <support@render.com>
 License-File: LICENSE
@@ -175,7 +175,7 @@ runs = render.workflows.list_task_runs(ListTaskRunsParams(limit=10))
 Pass an `idempotency_key` to make starting a run safe to retry. Repeating a call
 with the same key within 24 hours returns the run the first call started instead
 of starting another one, so a client that retries after a timeout does not run
-the task twice. Keys are scoped to a single workflow version.
+the task twice. Keys are scoped to a workflow.
 
 ```python
 task_run = render.workflows.start_task(

{render-1.3.0 → render-1.4.0}/README.md

@@ -150,7 +150,7 @@ runs = render.workflows.list_task_runs(ListTaskRunsParams(limit=10))
 Pass an `idempotency_key` to make starting a run safe to retry. Repeating a call
 with the same key within 24 hours returns the run the first call started instead
 of starting another one, so a client that retries after a timeout does not run
-the task twice. Keys are scoped to a single workflow version.
+the task twice. Keys are scoped to a workflow.
 
 ```python
 task_run = render.workflows.start_task(

{render-1.3.0 → render-1.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "render"
-version = "1.3.0"
+version = "1.4.0"
 description = "Python SDK for Render Workflows"
 authors = [{ name = "Render", email = "support@render.com" }]
 readme = "README.md"

{render-1.3.0 → render-1.4.0}/render/__init__.py

@@ -36,7 +36,7 @@ Async REST API access:
 # Must stay the first import: it records when SDK import began.
 from render import _startup
 
-__version__ = "1.3.0"
+__version__ = "1.4.0"
 
 # Render/RenderAsync are lazy-loaded so the workflow worker path stays fast.
 from typing import TYPE_CHECKING

{render-1.3.0 → render-1.4.0}/render/experimental/sandbox/api.py

@@ -94,7 +94,6 @@ from render.public_api.models.sandbox_network_policy_post import (
 from render.public_api.models.sandbox_network_policy_type import (
     SandboxNetworkPolicyType,
 )
-from render.public_api.models.sandbox_plan import SandboxPlan
 from render.public_api.models.sandbox_post import SandboxPOST
 from render.public_api.models.sandbox_post_env import SandboxPOSTEnv
 from render.public_api.models.sandbox_snapshot import (
@@ -176,10 +175,11 @@ def _to_sandbox(model: GeneratedSandbox) -> Sandbox:
     return Sandbox(
         id=model.id,
         status=model.status.value,
-        plan=model.plan.value,
+        plan=str(model.plan),
         network_policy=_to_network_policy(model.network_policy),
         region=model.region,
         timeout_seconds=model.timeout_seconds,
+        idle_timeout_seconds=model.idle_timeout_seconds,
         created_at=model.created_at,
         terminated_at=_set_or_none(model.terminated_at),
     )
@@ -206,7 +206,7 @@ def _to_snapshot(model: GeneratedSandboxSnapshot) -> Snapshot:
         source_sandbox_id=model.source_sandbox_id,
         kind=model.kind.value,
         status=model.status.value,
-        plan=model.plan.value,
+        plan=str(model.plan),
         requested_at=model.requested_at,
         name=_set_or_none(model.name),
         captured_at=_set_or_none(model.captured_at),
@@ -280,6 +280,7 @@ class SandboxApi:
         owner_id: str,
         plan: str | None,
         timeout_seconds: int | None,
+        idle_timeout_seconds: int | None,
         network_policy: NetworkPolicy | str | None,
         region: str | None,
         env: dict[str, str] | None,
@@ -288,9 +289,11 @@ class SandboxApi:
     ) -> Sandbox:
         body = SandboxPOST(owner_id=owner_id)
         if plan is not None:
-            body.plan = SandboxPlan(plan)
+            body.plan = plan
         if timeout_seconds is not None:
             body.timeout_seconds = timeout_seconds
+        if idle_timeout_seconds is not None:
+            body.idle_timeout_seconds = idle_timeout_seconds
         if region is not None:
             body.region = region
         if network_policy is not None:
@@ -391,13 +394,13 @@ class SandboxApi:
     async def create_snapshot(
         self,
         sandbox_id: str,
-        kind: str,
+        kind: str | None,
         name: str | None,
         expires_at: datetime | None,
         owner_id: str | Unset,
     ) -> Snapshot:
         body = SandboxSnapshotPOST(
-            kind=SandboxSnapshotKind(kind),
+            kind=SandboxSnapshotKind(kind) if kind is not None else UNSET,
             name=name if name is not None else UNSET,
             expires_at=expires_at if expires_at is not None else UNSET,
         )

{render-1.3.0 → render-1.4.0}/render/experimental/sandbox/api_sync.py

@@ -96,7 +96,6 @@ from render.public_api.models.sandbox_network_policy_post import (
 from render.public_api.models.sandbox_network_policy_type import (
     SandboxNetworkPolicyType,
 )
-from render.public_api.models.sandbox_plan import SandboxPlan
 from render.public_api.models.sandbox_post import SandboxPOST
 from render.public_api.models.sandbox_post_env import SandboxPOSTEnv
 from render.public_api.models.sandbox_snapshot import (
@@ -178,10 +177,11 @@ def _to_sandbox(model: GeneratedSandbox) -> Sandbox:
     return Sandbox(
         id=model.id,
         status=model.status.value,
-        plan=model.plan.value,
+        plan=str(model.plan),
         network_policy=_to_network_policy(model.network_policy),
         region=model.region,
         timeout_seconds=model.timeout_seconds,
+        idle_timeout_seconds=model.idle_timeout_seconds,
         created_at=model.created_at,
         terminated_at=_set_or_none(model.terminated_at),
     )
@@ -208,7 +208,7 @@ def _to_snapshot(model: GeneratedSandboxSnapshot) -> Snapshot:
         source_sandbox_id=model.source_sandbox_id,
         kind=model.kind.value,
         status=model.status.value,
-        plan=model.plan.value,
+        plan=str(model.plan),
         requested_at=model.requested_at,
         name=_set_or_none(model.name),
         captured_at=_set_or_none(model.captured_at),
@@ -282,6 +282,7 @@ class SyncSandboxApi:
         owner_id: str,
         plan: str | None,
         timeout_seconds: int | None,
+        idle_timeout_seconds: int | None,
         network_policy: NetworkPolicy | str | None,
         region: str | None,
         env: dict[str, str] | None,
@@ -290,9 +291,11 @@ class SyncSandboxApi:
     ) -> Sandbox:
         body = SandboxPOST(owner_id=owner_id)
         if plan is not None:
-            body.plan = SandboxPlan(plan)
+            body.plan = plan
         if timeout_seconds is not None:
             body.timeout_seconds = timeout_seconds
+        if idle_timeout_seconds is not None:
+            body.idle_timeout_seconds = idle_timeout_seconds
         if region is not None:
             body.region = region
         if network_policy is not None:
@@ -391,13 +394,13 @@ class SyncSandboxApi:
     def create_snapshot(
         self,
         sandbox_id: str,
-        kind: str,
+        kind: str | None,
         name: str | None,
         expires_at: datetime | None,
         owner_id: str | Unset,
     ) -> Snapshot:
         body = SandboxSnapshotPOST(
-            kind=SandboxSnapshotKind(kind),
+            kind=SandboxSnapshotKind(kind) if kind is not None else UNSET,
             name=name if name is not None else UNSET,
             expires_at=expires_at if expires_at is not None else UNSET,
         )

{render-1.3.0 → render-1.4.0}/render/experimental/sandbox/client.py

@@ -57,6 +57,7 @@ class SandboxClient:
         owner_id: str | None = None,
         plan: str | None = None,
         timeout_seconds: int | None = None,
+        idle_timeout_seconds: int | None = None,
         network_policy: NetworkPolicy | str | None = None,
         region: str | None = None,
         env: dict[str, str] | None = None,
@@ -66,8 +67,9 @@ class SandboxClient:
         """Create a sandbox and return its initial state.
 
         All parameters are optional. Unspecified fields fall back to the
-        workspace defaults enforced by the API (plan starter, 7200s timeout,
-        workspace default region and network policy).
+        workspace defaults enforced by the API (plan starter, 24-hour lifetime,
+        15-minute idle timeout, workspace default region and network policy).
+        Set idle_timeout_seconds to 0 to disable automatic idle suspension.
 
         network_policy is a NetworkPolicy, or a policy type string as a
         shorthand for one without rules. To restrict outbound traffic to
@@ -90,6 +92,7 @@ class SandboxClient:
             owner_id=resolved_owner_id,
             plan=plan,
             timeout_seconds=timeout_seconds,
+            idle_timeout_seconds=idle_timeout_seconds,
             network_policy=network_policy,
             region=resolved_region,
             env=env,
@@ -221,7 +224,7 @@ class SnapshotClient:
         self,
         sandbox_id: str,
         *,
-        kind: str = "filesystem",
+        kind: str | None = None,
         name: str | None = None,
         expires_at: datetime | None = None,
         owner_id: str | None = None,

{render-1.3.0 → render-1.4.0}/render/experimental/sandbox/client_sync.py

@@ -59,6 +59,7 @@ class SyncSandboxClient:
         owner_id: str | None = None,
         plan: str | None = None,
         timeout_seconds: int | None = None,
+        idle_timeout_seconds: int | None = None,
         network_policy: NetworkPolicy | str | None = None,
         region: str | None = None,
         env: dict[str, str] | None = None,
@@ -68,8 +69,9 @@ class SyncSandboxClient:
         """Create a sandbox and return its initial state.
 
         All parameters are optional. Unspecified fields fall back to the
-        workspace defaults enforced by the API (plan starter, 7200s timeout,
-        workspace default region and network policy).
+        workspace defaults enforced by the API (plan starter, 24-hour lifetime,
+        15-minute idle timeout, workspace default region and network policy).
+        Set idle_timeout_seconds to 0 to disable automatic idle suspension.
 
         network_policy is a NetworkPolicy, or a policy type string as a
         shorthand for one without rules. To restrict outbound traffic to
@@ -92,6 +94,7 @@ class SyncSandboxClient:
             owner_id=resolved_owner_id,
             plan=plan,
             timeout_seconds=timeout_seconds,
+            idle_timeout_seconds=idle_timeout_seconds,
             network_policy=network_policy,
             region=resolved_region,
             env=env,
@@ -223,7 +226,7 @@ class SyncSnapshotClient:
         self,
         sandbox_id: str,
         *,
-        kind: str = "filesystem",
+        kind: str | None = None,
         name: str | None = None,
         expires_at: datetime | None = None,
         owner_id: str | None = None,

{render-1.3.0 → render-1.4.0}/render/experimental/sandbox/tests/test_client.py

@@ -30,6 +30,7 @@ SANDBOX_JSON = {
     "networkPolicy": {"type": "deny-all"},
     "region": "oregon",
     "timeoutSeconds": 300,
+    "idleTimeoutSeconds": 900,
     "createdAt": "2026-07-17T00:00:00Z",
     "terminatedAt": None,
 }
@@ -68,21 +69,38 @@ async def test_create_sends_sandbox_post_and_returns_sandbox():
         return httpx.Response(201, json=SANDBOX_JSON)
 
     client = _sandbox_client(handler)
-    sandbox = await client.create(plan="standard", timeout_seconds=300)
+    sandbox = await client.create(
+        plan="standard", timeout_seconds=300, idle_timeout_seconds=0
+    )
 
     assert captured["method"] == "POST"
     assert captured["path"] == "/v1/sandboxes"
     assert captured["body"]["ownerId"] == "tea-test"
     assert captured["body"]["plan"] == "standard"
     assert captured["body"]["timeoutSeconds"] == 300
+    assert captured["body"]["idleTimeoutSeconds"] == 0
     assert "env" not in captured["body"]
     assert "networkPolicy" not in captured["body"]
     assert sandbox.id == "sbx-abc"
     assert sandbox.status == "running"
     assert sandbox.network_policy == NetworkPolicy(type="deny-all")
+    assert sandbox.idle_timeout_seconds == 900
     assert sandbox.terminated_at is None
 
 
+@pytest.mark.asyncio
+async def test_create_defaults_idle_timeout_for_older_api_response():
+    async def handler(request: httpx.Request) -> httpx.Response:
+        response = {**SANDBOX_JSON}
+        del response["idleTimeoutSeconds"]
+        return httpx.Response(201, json=response)
+
+    client = _sandbox_client(handler)
+    sandbox = await client.create()
+
+    assert sandbox.idle_timeout_seconds == 900
+
+
 @pytest.mark.asyncio
 @pytest.mark.parametrize("policy", ["allow-all", "deny-all"])
 async def test_create_sends_network_policy_type(policy):
@@ -118,6 +136,38 @@ def test_sync_create_sends_network_policy_type(policy):
     assert sandbox.network_policy == NetworkPolicy(type=policy)
 
 
+UNKNOWN_PLAN = "32c-64g"
+
+
+@pytest.mark.asyncio
+async def test_create_passes_a_plan_unknown_to_the_sdk_through():
+    captured = {}
+
+    async def handler(request: httpx.Request) -> httpx.Response:
+        captured["body"] = json.loads(request.content)
+        return httpx.Response(201, json={**SANDBOX_JSON, "plan": UNKNOWN_PLAN})
+
+    client = _sandbox_client(handler)
+    sandbox = await client.create(plan=UNKNOWN_PLAN)
+
+    assert captured["body"]["plan"] == UNKNOWN_PLAN
+    assert sandbox.plan == UNKNOWN_PLAN
+
+
+def test_sync_create_passes_a_plan_unknown_to_the_sdk_through():
+    captured = {}
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        captured["body"] = json.loads(request.content)
+        return httpx.Response(201, json={**SANDBOX_JSON, "plan": UNKNOWN_PLAN})
+
+    client = _sync_sandbox_client(handler)
+    sandbox = client.create(plan=UNKNOWN_PLAN)
+
+    assert captured["body"]["plan"] == UNKNOWN_PLAN
+    assert sandbox.plan == UNKNOWN_PLAN
+
+
 @pytest.mark.asyncio
 async def test_create_sends_env_in_post_body():
     captured = {}

{render-1.3.0 → render-1.4.0}/render/experimental/sandbox/tests/test_snapshots.py

@@ -21,6 +21,7 @@ SANDBOX_JSON = {
     "networkPolicy": {"type": "deny-all"},
     "region": "oregon",
     "timeoutSeconds": 300,
+    "idleTimeoutSeconds": 900,
     "createdAt": "2026-09-01T00:00:00Z",
     "terminatedAt": None,
 }
@@ -81,7 +82,7 @@ def test_sandbox_client_exposes_snapshots():
 
 
 @pytest.mark.asyncio
-async def test_create_posts_kind_and_returns_creating_snapshot():
+async def test_create_omits_kind_by_default_and_returns_creating_snapshot():
     captured = {}
 
     async def handler(request: httpx.Request) -> httpx.Response:
@@ -97,7 +98,7 @@ async def test_create_posts_kind_and_returns_creating_snapshot():
     assert captured["method"] == "POST"
     assert captured["path"] == "/v1/sandboxes/sbx-abc/snapshots"
     assert captured["query"]["ownerId"] == "tea-test"
-    assert captured["body"] == {"kind": "filesystem"}
+    assert captured["body"] == {}
     assert snapshot.id == "snp-abc"
     assert snapshot.sandbox_group_id == "sbg-abc"
     assert snapshot.source_sandbox_id == "sbx-abc"
@@ -139,7 +140,7 @@ async def test_create_sends_name_and_returns_it():
     client = _sandbox_client(handler)
     snapshot = await client.snapshots.create("sbx-abc", name="gold")
 
-    assert captured["body"] == {"kind": "filesystem", "name": "gold"}
+    assert captured["body"] == {"name": "gold"}
     assert snapshot.name == "gold"
 
 
@@ -207,6 +208,31 @@ async def test_create_surfaces_invalid_name_as_a_client_error_with_code():
     assert excinfo.value.code == "invalid_snapshot_name"
 
 
+@pytest.mark.asyncio
+async def test_from_id_reads_a_plan_unknown_to_the_sdk():
+    async def handler(request: httpx.Request) -> httpx.Response:
+        return httpx.Response(200, json={**AVAILABLE_SNAPSHOT_JSON, "plan": "32c-64g"})
+
+    client = _sandbox_client(handler)
+    snapshot = await client.snapshots.from_id(
+        sandbox_group_id="sbg-abc", snapshot_id="snp-abc"
+    )
+
+    assert snapshot.plan == "32c-64g"
+
+
+def test_sync_from_id_reads_a_plan_unknown_to_the_sdk():
+    def handler(request: httpx.Request) -> httpx.Response:
+        return httpx.Response(200, json={**AVAILABLE_SNAPSHOT_JSON, "plan": "32c-64g"})
+
+    client = _sync_sandbox_client(handler)
+    snapshot = client.snapshots.from_id(
+        sandbox_group_id="sbg-abc", snapshot_id="snp-abc"
+    )
+
+    assert snapshot.plan == "32c-64g"
+
+
 @pytest.mark.asyncio
 async def test_from_id_gets_the_snapshot_from_its_group():
     captured = {}
@@ -647,6 +673,19 @@ def test_sync_create_posts_kind_and_returns_snapshot():
     assert snapshot.name == "gold"
 
 
+def test_sync_create_omits_kind_by_default():
+    captured = {}
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        captured["body"] = json.loads(request.content)
+        return httpx.Response(202, json=CREATING_SNAPSHOT_JSON)
+
+    client = _sync_sandbox_client(handler)
+    client.snapshots.create("sbx-abc")
+
+    assert captured["body"] == {}
+
+
 def test_sync_list_by_group_returns_snapshots_and_cursor():
     captured = {}
 

{render-1.3.0 → render-1.4.0}/render/experimental/sandbox/tests/test_types.py

@@ -33,11 +33,13 @@ def test_sandbox_has_expected_fields():
         network_policy=NetworkPolicy(type="deny-all"),
         region="oregon",
         timeout_seconds=7200,
+        idle_timeout_seconds=900,
         created_at=datetime(2026, 7, 17),
     )
     assert sb.id == "sbx-1"
     assert sb.network_policy.type == "deny-all"
     assert sb.network_policy.rules == []
+    assert sb.idle_timeout_seconds == 900
     assert sb.terminated_at is None
 
 

{render-1.3.0 → render-1.4.0}/render/experimental/sandbox/types.py

@@ -41,6 +41,7 @@ class Sandbox:
     network_policy: NetworkPolicy
     region: str
     timeout_seconds: int
+    idle_timeout_seconds: int
     created_at: datetime
     terminated_at: datetime | None = None
 

{render-1.3.0 → render-1.4.0}/render/public_api/api/blueprints/update_blueprint.py

@@ -39,6 +39,11 @@ def _parse_response(
 
         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())
 

{render-1.3.0 → render-1.4.0}/render/public_api/api/sandboxes/connect_sandbox_files.py

@@ -116,6 +116,8 @@ def sync_detailed(
     token is bound to this sandbox, operation, and path, and expires
     shortly after issuance.
 
+    409 with `code: sandbox_group_suspended` if the sandbox group is suspended.
+
     Args:
         sandbox_id (str):  Example: sbx-1cd4gcph1rs3idesc73a2b2mg.
         operation (ConnectSandboxFilesOperation):
@@ -165,6 +167,8 @@ def sync(
     token is bound to this sandbox, operation, and path, and expires
     shortly after issuance.
 
+    409 with `code: sandbox_group_suspended` if the sandbox group is suspended.
+
     Args:
         sandbox_id (str):  Example: sbx-1cd4gcph1rs3idesc73a2b2mg.
         operation (ConnectSandboxFilesOperation):
@@ -209,6 +213,8 @@ async def asyncio_detailed(
     token is bound to this sandbox, operation, and path, and expires
     shortly after issuance.
 
+    409 with `code: sandbox_group_suspended` if the sandbox group is suspended.
+
     Args:
         sandbox_id (str):  Example: sbx-1cd4gcph1rs3idesc73a2b2mg.
         operation (ConnectSandboxFilesOperation):
@@ -256,6 +262,8 @@ async def asyncio(
     token is bound to this sandbox, operation, and path, and expires
     shortly after issuance.
 
+    409 with `code: sandbox_group_suspended` if the sandbox group is suspended.
+
     Args:
         sandbox_id (str):  Example: sbx-1cd4gcph1rs3idesc73a2b2mg.
         operation (ConnectSandboxFilesOperation):

{render-1.3.0 → render-1.4.0}/render/public_api/api/sandboxes/connect_sandbox_run.py

@@ -115,6 +115,8 @@ def sync_detailed(
     single run operation against the specified sandbox. The response contains
     the sandbox URI where the caller sends the command with the token as a bearer credential.
 
+    409 with `code: sandbox_group_suspended` if the sandbox group is suspended.
+
     Args:
         sandbox_id (str):  Example: sbx-1cd4gcph1rs3idesc73a2b2mg.
         operation (ConnectSandboxRunOperation):
@@ -160,6 +162,8 @@ def sync(
     single run operation against the specified sandbox. The response contains
     the sandbox URI where the caller sends the command with the token as a bearer credential.
 
+    409 with `code: sandbox_group_suspended` if the sandbox group is suspended.
+
     Args:
         sandbox_id (str):  Example: sbx-1cd4gcph1rs3idesc73a2b2mg.
         operation (ConnectSandboxRunOperation):
@@ -200,6 +204,8 @@ async def asyncio_detailed(
     single run operation against the specified sandbox. The response contains
     the sandbox URI where the caller sends the command with the token as a bearer credential.
 
+    409 with `code: sandbox_group_suspended` if the sandbox group is suspended.
+
     Args:
         sandbox_id (str):  Example: sbx-1cd4gcph1rs3idesc73a2b2mg.
         operation (ConnectSandboxRunOperation):
@@ -243,6 +249,8 @@ async def asyncio(
     single run operation against the specified sandbox. The response contains
     the sandbox URI where the caller sends the command with the token as a bearer credential.
 
+    409 with `code: sandbox_group_suspended` if the sandbox group is suspended.
+
     Args:
         sandbox_id (str):  Example: sbx-1cd4gcph1rs3idesc73a2b2mg.
         operation (ConnectSandboxRunOperation):

{render-1.3.0 → render-1.4.0}/render/public_api/api/sandboxes/create_sandbox.py

@@ -114,6 +114,11 @@ def sync_detailed(
     `code: snapshot_not_found` if no `available` snapshot in the group has the
     name. The 409 cases above apply to the resolved snapshot.
 
+    409 with `code: sandbox_group_suspended` if the sandbox group is suspended.
+
+    400 with `code: sandbox_group_limit_reached` if the owner has no default
+    sandbox group and is already at its sandbox group limit.
+
     Args:
         body (SandboxPOST):
 
@@ -155,6 +160,11 @@ def sync(
     `code: snapshot_not_found` if no `available` snapshot in the group has the
     name. The 409 cases above apply to the resolved snapshot.
 
+    409 with `code: sandbox_group_suspended` if the sandbox group is suspended.
+
+    400 with `code: sandbox_group_limit_reached` if the owner has no default
+    sandbox group and is already at its sandbox group limit.
+
     Args:
         body (SandboxPOST):
 
@@ -191,6 +201,11 @@ async def asyncio_detailed(
     `code: snapshot_not_found` if no `available` snapshot in the group has the
     name. The 409 cases above apply to the resolved snapshot.
 
+    409 with `code: sandbox_group_suspended` if the sandbox group is suspended.
+
+    400 with `code: sandbox_group_limit_reached` if the owner has no default
+    sandbox group and is already at its sandbox group limit.
+
     Args:
         body (SandboxPOST):
 
@@ -230,6 +245,11 @@ async def asyncio(
     `code: snapshot_not_found` if no `available` snapshot in the group has the
     name. The 409 cases above apply to the resolved snapshot.
 
+    409 with `code: sandbox_group_suspended` if the sandbox group is suspended.
+
+    400 with `code: sandbox_group_limit_reached` if the owner has no default
+    sandbox group and is already at its sandbox group limit.
+
     Args:
         body (SandboxPOST):