> ## Documentation Index
> Fetch the complete documentation index at: https://browseruse-0aece648-codex-clarify-browser-infrastructure.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# All Parameters

> Sandbox configuration reference

## Reference

| Parameter                  | Type       | Description                                                                   | Default  |
| -------------------------- | ---------- | ----------------------------------------------------------------------------- | -------- |
| `BROWSER_USE_API_KEY`      | `str`      | API key (or env var)                                                          | Required |
| `cloud_profile_id`         | `str`      | Browser profile UUID                                                          | `None`   |
| `cloud_proxy_country_code` | `str`      | Supported proxy country code                                                  | `None`   |
| `cloud_timeout`            | `int`      | Requested session timeout in minutes (1–240; service default 60 when omitted) | `None`   |
| `on_browser_created`       | `Callable` | Live URL callback                                                             | `None`   |
| `on_log`                   | `Callable` | Log event callback                                                            | `None`   |
| `on_result`                | `Callable` | Success callback                                                              | `None`   |
| `on_error`                 | `Callable` | Error callback                                                                | `None`   |

## Example

```python theme={null}
@sandbox(
    cloud_profile_id='550e8400-e29b-41d4-a716-446655440000',
    cloud_proxy_country_code='us',
    cloud_timeout=60,
    on_browser_created=lambda data: print(f'Live: {data.live_url}'),
)
async def task(browser: Browser):
    agent = Agent(task="your task", browser=browser, llm=ChatBrowserUse())
    await agent.run()
```

See the [Browser Infrastructure reference](/cloud/browser/quickstart) for
maintained browser settings and [pricing](https://browser-use.com/pricing) for
current commercial terms.