Close the async HTTP client.

Create a sandbox and return an AsyncSandbox instance.

This is the primary method for creating sandboxes. Use it as an async context manager for automatic cleanup:

async with await client.sandbox(snapshot_id="<uuid>") as sandbox:
    result = await sandbox.run("echo hello")

# Resolve by snapshot name instead of ID:
async with await client.sandbox(snapshot_name="my-snap") as sandbox:
    result = await sandbox.run("echo hello")

The sandbox is automatically deleted when exiting the context manager. For sandboxes with manual lifecycle management, use create_sandbox().

Create a new Sandbox.

The sandbox is NOT automatically deleted. Use delete_sandbox() for cleanup, or use sandbox() for automatic cleanup with a context manager.

Get a Sandbox by name.

The sandbox is NOT automatically deleted. Use delete_sandbox() for cleanup.

List all Sandboxes.

Update a sandbox's properties.

Delete a Sandbox.

Get the provisioning status of a sandbox.

This is a lightweight endpoint designed for high-frequency polling during sandbox provisioning. It returns only the status fields without full sandbox data.

Get an authenticated URL for a service running inside a sandbox.

Returns an :class:AsyncServiceURL whose async accessors auto-refresh the token transparently before it expires. The object also provides async HTTP helper methods (.get, .post, etc.) that inject the authentication header automatically.

Poll until a sandbox reaches "ready" or "failed" status.

Uses the lightweight status endpoint for polling, then fetches the full sandbox data once ready.

Start a stopped sandbox and wait until ready.

Stop a running sandbox (preserves sandbox files for later restart).

Build a snapshot from a Docker image.

Blocks until the snapshot is ready (polls with 2s interval).

Capture a snapshot from a running sandbox.

Blocks until the snapshot is ready (polls with 2s interval).

Get a snapshot by ID.

List snapshots.

The backend always paginates this endpoint. When limit is omitted the server applies a default page size (currently 50), so a single call is not guaranteed to return every snapshot. To iterate through all results, repeat the call with increasing offset values (or an explicit limit) until fewer than limit snapshots come back.

Delete a snapshot.

Poll until a snapshot reaches "ready" or "failed" status.