release: 3.20.0

Author: stainless-app[bot]

.env.example

@@ -1,3 +1,2 @@
 BROWSERBASE_API_KEY=bb_live_your_api_key_here
-BROWSERBASE_PROJECT_ID=your-bb-project-uuid-here
-MODEL_API_KEY=sk-proj-your-llm-api-key-here
+MODEL_API_KEY=sk-proj-your-llm-api-key-here

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "3.19.5"
+  ".": "3.20.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 8
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-b969ce378479c79ee64c05127c0ed6c6ce2edbee017ecd037242fb618a5ebc9f.yml
-openapi_spec_hash: a24aabaa5214effb679808b7f2be0ad4
-config_hash: 0cc516caf1432087f40654336e0fa8cd
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/stagehand-6f6bfb81d092f30a5e2005328c97d61b9ea36132bb19e9e79e55294b9534ce20.yml
+openapi_spec_hash: f3fc1e3688a38dc2c28f7178f7d534e5
+config_hash: 1fb12ae9b478488bc1e56bfbdc210b01

CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## 3.20.0 (2026-05-06)
+
+Full Changelog: [v3.19.5...v3.20.0](https://github.com/browserbase/stagehand-python/compare/v3.19.5...v3.20.0)
+
+### Features
+
+* [feat]: add `ignoreSelectors` to `extract()` ([f11a102](https://github.com/browserbase/stagehand-python/commit/f11a102884344ddefd2dd0b98f22fea687a12e6e))
+* [STG-1798] feat: support Browserbase verified sessions ([078ab5c](https://github.com/browserbase/stagehand-python/commit/078ab5c76f13beee16e44d7eed5e3018f1cc5bd8))
+* [STG-1808] Deprecate Browserbase project ID ([bfe505c](https://github.com/browserbase/stagehand-python/commit/bfe505cb1c3c1c6a85d7873ee05860476d71a9d6))
+* Bedrock auth passthrough ([9463fa4](https://github.com/browserbase/stagehand-python/commit/9463fa49cb839abbb2c6a1adb0d053e5006216a7))
+* remove experimental requirement on agent variables ([#2079](https://github.com/browserbase/stagehand-python/issues/2079)) ([92ed1e1](https://github.com/browserbase/stagehand-python/commit/92ed1e1d43e89d92ffc4c3aa30c7f1a521f5d0e6))
+* Revert "[STG-1573] Add providerOptions for extensible model auth ([#1822](https://github.com/browserbase/stagehand-python/issues/1822))" ([3c04086](https://github.com/browserbase/stagehand-python/commit/3c0408675154c9f7d241c4e92e9cb82f0419d6b3))
+* support setting headers via env ([b1c6127](https://github.com/browserbase/stagehand-python/commit/b1c61276ff9cecf89c078e1d97a6b927d8d308e1))
+
+
+### Bug Fixes
+
+* **client:** preserve hardcoded query params when merging with user params ([feac39d](https://github.com/browserbase/stagehand-python/commit/feac39d88a841ff710d672b622f3280037589f66))
+* ensure file data are only sent as 1 parameter ([b870657](https://github.com/browserbase/stagehand-python/commit/b8706575ab0f95b9e6781ee3685f9b79e0fe6036))
+* use correct field name format for multipart file arrays ([852600a](https://github.com/browserbase/stagehand-python/commit/852600a4c6169df6497fc4d77a06abae8812e375))
+
+
+### Performance Improvements
+
+* **client:** optimize file structure copying in multipart requests ([69d396f](https://github.com/browserbase/stagehand-python/commit/69d396fa404d0ad3905786dcf6f56be8be7ab9b2))
+
+
+### Chores
+
+* **internal:** more robust bootstrap script ([9bc61e1](https://github.com/browserbase/stagehand-python/commit/9bc61e12f1599b14dd8b2a0c38a50c089512e9c7))
+* **internal:** reformat pyproject.toml ([03f4dbe](https://github.com/browserbase/stagehand-python/commit/03f4dbe5ef6e230f3e96302ba8e5f4064edda10f))
+
 ## 3.19.5 (2026-04-03)
 
 Full Changelog: [v3.19.4...v3.19.5](https://github.com/browserbase/stagehand-python/compare/v3.19.4...v3.19.5)

README.md

@@ -87,10 +87,8 @@ Python 3.9 or higher.
 
 Set your environment variables (from `examples/.env.example`):
 
-- `STAGEHAND_API_URL`
 - `MODEL_API_KEY`
 - `BROWSERBASE_API_KEY`
-- `BROWSERBASE_PROJECT_ID`
 
 ```bash
 cp examples/.env.example examples/.env
@@ -139,7 +137,6 @@ def main() -> None:
     with Stagehand(
         server="remote",
         browserbase_api_key=os.environ.get("BROWSERBASE_API_KEY"),
-        browserbase_project_id=os.environ.get("BROWSERBASE_PROJECT_ID"),
         model_api_key=os.environ.get("MODEL_API_KEY"),
     ) as client:
         session = client.sessions.start(
@@ -234,7 +231,6 @@ from stagehand import AsyncStagehand
 
 client = AsyncStagehand(
     browserbase_api_key="My Browserbase API Key",
-    browserbase_project_id="My Browserbase Project ID",
     model_api_key="My Model API Key",
 )
 ```
@@ -255,9 +251,11 @@ See this table for the available options:
 | Keyword argument         | Environment variable     | Required | Default value                             |
 | ------------------------ | ------------------------ | -------- | ----------------------------------------- |
 | `browserbase_api_key`    | `BROWSERBASE_API_KEY`    | true     | -                                         |
-| `browserbase_project_id` | `BROWSERBASE_PROJECT_ID` | true     | -                                         |
+| `browserbase_project_id` | -                        | false    | -                                         |
 | `model_api_key`          | `MODEL_API_KEY`          | true     | -                                         |
-| `base_url`               | `STAGEHAND_BASE_URL`     | false    | `"https://api.stagehand.browserbase.com"` |
+| `base_url`               | `STAGEHAND_API_URL`      | false    | `"https://api.stagehand.browserbase.com"` |
+
+`browserbase_project_id` is deprecated, accepted for backwards compatibility, and ignored. `STAGEHAND_BASE_URL` remains supported as a deprecated fallback when `STAGEHAND_API_URL` is unset.
 
 Keyword arguments take precedence over environment variables.
 
@@ -662,7 +660,7 @@ import httpx
 from stagehand import Stagehand, DefaultHttpxClient
 
 client = Stagehand(
-    # Or use the `STAGEHAND_BASE_URL` env var
+    # Or use the `STAGEHAND_API_URL` env var, with `STAGEHAND_BASE_URL` as a fallback
     base_url="http://my.test.server.example.com:8083",
     http_client=DefaultHttpxClient(
         proxy="http://my.test.proxy.example.com",

examples/.env.example

@@ -1,4 +1,2 @@
-STAGEHAND_API_URL=https://api.stagehand.browserbase.com
 MODEL_API_KEY=sk-proj-your-llm-api-key-here
 BROWSERBASE_API_KEY=bb_live_your_api_key_here
-BROWSERBASE_PROJECT_ID=your-bb-project-uuid-here

examples/act_example.py

@@ -10,7 +10,6 @@
 
 Required environment variables:
 - BROWSERBASE_API_KEY: Your Browserbase API key
-- BROWSERBASE_PROJECT_ID: Your Browserbase project ID
 - MODEL_API_KEY: Your OpenAI API key
 """
 
@@ -45,10 +44,9 @@ async def main() -> None:
     load_example_env()
     load_example_env()
     # Create client using environment variables
-    # BROWSERBASE_API_KEY, BROWSERBASE_PROJECT_ID, MODEL_API_KEY
+    # BROWSERBASE_API_KEY and MODEL_API_KEY
     async with AsyncStagehand(
         browserbase_api_key=os.environ.get("BROWSERBASE_API_KEY"),
-        browserbase_project_id=os.environ.get("BROWSERBASE_PROJECT_ID"),
         model_api_key=os.environ.get("MODEL_API_KEY"),
     ) as client:
         # Start a new browser session

examples/agent_execute.py

@@ -3,7 +3,6 @@
 
 Required environment variables:
 - BROWSERBASE_API_KEY
-- BROWSERBASE_PROJECT_ID
 - MODEL_API_KEY
 
 Optional:

examples/byob_example.py

@@ -6,7 +6,6 @@
 
 Required environment variables:
 - BROWSERBASE_API_KEY
-- BROWSERBASE_PROJECT_ID
 - MODEL_API_KEY
 
 Usage:
@@ -52,7 +51,6 @@ async def main() -> None:
     load_example_env()
     async with AsyncStagehand(
         browserbase_api_key=os.environ.get("BROWSERBASE_API_KEY"),
-        browserbase_project_id=os.environ.get("BROWSERBASE_PROJECT_ID"),
         model_api_key=os.environ.get("MODEL_API_KEY"),
     ) as client, async_playwright() as playwright:
         browser = await playwright.chromium.launch(headless=True)

examples/env.py

@@ -4,10 +4,8 @@
 from pathlib import Path
 
 REQUIRED_KEYS = {
-    "STAGEHAND_API_URL",
     "MODEL_API_KEY",
     "BROWSERBASE_API_KEY",
-    "BROWSERBASE_PROJECT_ID",
 }
 
 
@@ -44,9 +42,6 @@ def load_example_env() -> None:
             + " (from examples/.env)"
         )
 
-    # Normalize for SDKs that expect STAGEHAND_BASE_URL
-    os.environ.setdefault("STAGEHAND_BASE_URL", os.environ["STAGEHAND_API_URL"])
-
     # Use the repo-local SEA binary when available (avoid global installs).
     sea_binary = env_path.parent.parent / "bin" / "sea" / "stagehand-darwin-arm64"
     if sea_binary.exists():