browserbase

1.18.1 (2026-09-03)

Chores

• api: spec sync from core (73c0fd3)

1.18.0 (2026-08-25)

Features

• sessions: support expiresIn for debug URLs (349a658)

Bug Fixes

• client: omit Content-Type on bodyless DELETE requests (#4) (24602da)

Chores

• add CODEOWNERS — core-browser owns this repo (#174) (530eb39)
• add CODEOWNERS — core-browser owns this repo (#3) (857be9b)
• reconcile trunk fork from independently-added CODEOWNERS (0cb3b5d)

1.17.0 (2026-08-14)

Features

• stlc workspace + generate workflow (146f1a0)

Bug Fixes

• api: document session timeout bounds in create-session description (d597f3c)

Chores

• sync production releases back into staging (6d0d634)

1.16.0 (2026-08-10)

Full Changelog: v1.15.0...v1.16.0

Features

• [AI-2679] Deprecate presigned-url context uploads (72cc359)
• [CORE-2365] Add optional name to create and get Context API (b2f4057)
• [STG-2717] Pass-thru proxy config for session creation in /v1/agents/runs (37ac241)
• stlc: configurable CI runner and private-production-repo support in workflow templates (c9098bb)

1.15.0 (2026-07-14)

Full Changelog: v1.14.0...v1.15.0

Features

• api: manual updates (39fee02)

1.14.0 (2026-07-02)

Full Changelog: v1.13.0...v1.14.0

Features

• [CORE-000][apps/sdk] Add agents to SDK (580ec55)

Documentation

• document and un-gate allowedDomains session setting (126cf6d)

1.13.0 (2026-06-08)

Full Changelog: v1.12.0...v1.13.0

Features

• [AI-2206][apps/api] Surface proxySettings.caCertificates in public SDK & docs (0cf47ff)

1.12.0 (2026-06-05)

Full Changelog: v1.11.0...v1.12.0

Features

• [CORE-2194][apps/api] Add BYOC (cert) CRUD to SDKs (5ed9746)

1.11.0 (2026-05-20)

Full Changelog: v1.10.0...v1.11.0

Features

• [AI-1748][apps/api] Obtain custom certificates in API during session reservation (9c0b78d)
• [AI-1972] - Move fetch v2 handler into /v1/fetch (de76605)
• [AI-1993] - Surface structured JSON content on /v2/fetch (97f1c02)
• api: manual updates (1d7beb8)
• api: manual updates (23a3a2f)

1.10.0 (2026-05-13)

Full Changelog: v1.9.0...v1.10.0

Features

• Cast replay page start/end times as integer (ef3642a)

1.9.0 (2026-05-13)

Full Changelog: v1.8.0...v1.9.0

Features

• [CORE-1928][apps/api] Add PENDING as a valid session state (4f1248d)
• [CORE-1979] [apps/api] Regenerate OpenAPI spec to match current routes (0e366a6)
• api: add replays (58e18df)
• internal/types: support eagerly validating pydantic iterators (9d56949)
• support setting headers via env (308d35e)

Bug Fixes

• client: add missing f-string prefix in file type error message (e01f048)
• client: preserve hardcoded query params when merging with user params (953fd3e)
• ensure file data are only sent as 1 parameter (a837357)
• use correct field name format for multipart file arrays (9488fb3)

Performance Improvements

• client: optimize file structure copying in multipart requests (4146f22)

Chores

• internal: more robust bootstrap script (83d1f68)
• internal: reformat pyproject.toml (979436a)
• tests: bump steady to v0.22.1 (bafb680)

1.8.0 (2026-04-06)

Full Changelog: v1.7.0...v1.8.0

Features

• [CORE-000][apps/api] Add verified to SDK (1579bf9)
• internal: implement indices array format for query and form serialization (17a85d5)
• Update search docs by removing description from typebox schemas (7913112)

Bug Fixes

• deps: bump minimum typing-extensions version (962e72a)
• pydantic: do not pass by_alias unless set (3e6a912)
• sanitize endpoint path params (8a63eb5)

Chores

• ci: skip lint on metadata-only changes (80a6a3c)
• internal: tweak CI branches (9901c59)
• internal: update gitignore (2e3ba9b)
• tests: bump steady to v0.19.4 (f81180d)
• tests: bump steady to v0.19.5 (10d0b70)
• tests: bump steady to v0.19.6 (f9d4f90)
• tests: bump steady to v0.19.7 (27c797d)
• tests: bump steady to v0.20.1 (17f2e35)
• tests: bump steady to v0.20.2 (85ef397)

Refactors

• tests: switch from prism to steady (39217ea)

1.7.0 (2026-03-16)

Full Changelog: v1.6.0...v1.7.0

Features

• [CORE-1796][apps/api] Update Node.js SDK (ecafbb5)
• [GRO-000] docs: Add guide + docs for search api (55e2d0d)

1.6.0 (2026-03-11)

Full Changelog: v1.5.0...v1.6.0

Features

• [CORE-1804][apps/api] Add fetch API schema (a56673c)
• api: api update (#39) (8c98d9e)
• api: api update (#41) (0557ee5)
• api: api update (#44) (718ef11)
• api: update via SDK Studio (#10) (712cb9f)
• api: update via SDK Studio (#13) (ec90079)
• api: update via SDK Studio (#16) (3739129)
• api: update via SDK Studio (#18) (c8ff679)
• api: update via SDK Studio (#19) (1556b70)
• api: update via SDK Studio (#20) (8876008)
• api: update via SDK Studio (#21) (8f22de1)
• api: update via SDK Studio (#27) (b1facb8)
• api: update via SDK Studio (#28) (0735db2)
• api: update via SDK Studio (#29) (c1e0eb9)
• api: update via SDK Studio (#32) (54a7ed4)
• api: update via SDK Studio (#35) (cdc05f9)
• api: update via SDK Studio (#7) (90f80c7)
• various codegen changes (a70c78e)

Chores

• ci: skip uploading artifacts on stainless-internal branches (99d0409)
• test: do not count install time for mock server timeout (b19e21b)
• update placeholder string (8ff9f32)
• update SDK settings (#1) (dc1e229)

1.5.0-alpha.2 (2026-03-03)

Full Changelog: v1.5.0-alpha.1...v1.5.0-alpha.2

Features

• [CORE-] Restore models and components in SDK (49f2dab)
• api: api update (1c149cb)
• api: api update (72aa790)
• api: api update (a0edac2)
• api: api update (0b8da8a)
• api: api update (20dcbdc)
• api: api update (97edfd0)
• api: manual updates (892fe71)
• api: manual updates (32e4d51)
• api: manual updates (3bf8100)
• api: manual updates (f46e475)
• api: manual updates (7ace939)
• api: manual updates (94d9db6)
• api: manual updates (e281b89)
• api: manual updates (f0ba58f)
• client: add custom JSON encoder for extended type support (da8ce14)
• client: add support for binary request streaming (972c837)

Bug Fixes

• client: close streams without requiring full consumption (bb617be)
• compat with Python 3.14 (8f4df7c)
• compat: update signatures of model_dump and model_dump_json for Pydantic v1 (135104e)
• ensure streams are always closed (588f8f4)
• pydantic: ignore model extras in pydantic v2 (#156) (9cae18c)
• types: allow pyright to infer TypedDict types within SequenceNotStr (6e13710)
• use async_to_httpx_files in patch method (4370dab)

Chores

• add missing docstrings (0332edf)
• add Python 3.14 classifier and testing (ec88bf3)
• bump httpx-aiohttp version to 0.1.9 (42685a1)
• ci: upgrade actions/github-script (9363c3d)
• deps: mypy 1.18.1 has a regression, pin to 1.17 (b0d4efb)
• docs: use environment variables for authentication in code snippets (97a777f)
• format all api.md files (36b3fc5)
• internal/tests: avoid race condition with implicit client cleanup (6ca21dc)
• internal: add --fix argument to lint script (b96137c)
• internal: add missing files argument to base client (851f268)
• internal: add request options to SSE classes (0451d35)
• internal: bump dependencies (b0c3306)
• internal: codegen related update (5dad097)
• internal: detect missing future annotations with ruff (ea60157)
• internal: fix lint error on Python 3.14 (ba06a3e)
• internal: grammar fix (it's -> its) (1d6aebd)
• internal: make test_proxy_environment_variables more resilient (b768b4f)
• internal: make test_proxy_environment_variables more resilient to env (976c1fb)
• internal: update actions/checkout version (7b01d95)
• package: drop Python 3.8 support (e36cf2b)
• speedup initial import (ca27085)
• update lockfile (738e9be)
• update mock server docs (9c92875)

1.5.0-alpha.1 (2025-10-07)

Full Changelog: v1.5.0-alpha.0...v1.5.0-alpha.1

Features

• api: api update (3bdf24e)
• api: manual updates (99b1cfb)

Chores

• do not install brew dependencies in ./scripts/bootstrap by default (6915700)
• internal: move mypy configurations to pyproject.toml file (545938f)
• internal: update pydantic dependency (4dcad8e)
• tests: simplify get_platform test (6421017)
• types: change optional parameter type from NotGiven to Omit (a46d293)

1.5.0-alpha.0 (2025-09-05)

Full Changelog: v1.4.0...v1.5.0-alpha.0

Features

• api: api update (e94ddbd)
• api: api update (28115fb)
• api: api update (3209287)
• api: api update (f38e029)
• api: api update (1d9f769)
• api: api update (d72f39f)
• api: api update (6d449b3)
• api: api update (8bd5f8b)
• api: api update (1ce99ef)
• api: api update (1cbb849)
• api: manual updates (5893fc6)
• api: manual updates (074f06d)
• clean up environment call outs (82c38c4)
• client: add follow_redirects request option (a8b0b5e)
• client: add support for aiohttp (3516092)
• client: support file upload requests (2f338f0)
• improve future compat with pydantic v3 (8b5256c)
• types: replace List[str] with SequenceNotStr in params (55083f6)

Bug Fixes

• avoid newer type syntax (85f597b)
• ci: correct conditional (a36b873)
• ci: release-doctor — report correct token name (61b97ff)
• client: correctly parse binary response | stream (9614c4c)
• client: don't send Content-Type header on GET requests (c4c4185)
• fix extension types in playwright_extensions (8b652e7)
• parsing: correctly handle nested discriminated unions (d020678)
• parsing: ignore empty metadata (118c4d4)
• parsing: parse extra field types (c7ef875)
• tests: fix: tests which call HTTP endpoints directly with the example parameters (e298407)

Chores

• ci: change upload type (e42da7c)
• ci: enable for pull requests (03a6db7)
• ci: only run for pushes and fork pull requests (c8cb51f)
• docs: grammar improvements (f32a9e2)
• docs: remove reference to rye shell (07d129a)
• docs: remove unnecessary param examples (62209dc)
• internal: add Sequence related utils (34b0dd6)
• internal: bump pinned h11 dep (5e3270d)
• internal: change ci workflow machines (14c0ac4)
• internal: codegen related update (f979aff)
• internal: codegen related update (12de9f3)
• internal: codegen related update (c4157cb)
• internal: codegen related update (ccb2c95)
• internal: fix ruff target version (e6a3df4)
• internal: update comment in script (a7aec17)
• internal: update conftest.py (5d3a2b1)
• internal: update pyright exclude list (33ba4b4)
• package: mark python 3.13 as supported (2450b8e)
• project: add settings file for vscode (a406241)
• readme: fix version rendering on pypi (a8afe1a)
• readme: update badges (869a3f4)
• tests: add tests for httpx client instantiation & proxies (9c5d88c)
• tests: run tests in parallel (94308de)
• tests: skip some failing tests on the latest python versions (7bc40f0)
• update @stainless-api/prism-cli to v5.15.0 (b48933b)
• update github action (d57dc03)

Documentation

• client: fix httpx.Timeout documentation reference (4bbda56)

1.4.0 (2025-05-16)

Full Changelog: v1.3.0...v1.4.0

Features

• api: api update (d3b2ee1)

Bug Fixes

• package: support direct resource imports (8feb502)
• pydantic v1: more robust ModelField.annotation check (5292730)

Chores

• broadly detect json family of content-type headers (ffe29f8)
• ci: add timeout thresholds for CI jobs (3ca4458)
• ci: fix installation instructions (99a7328)
• ci: only use depot for staging repos (646f7d8)
• ci: upload sdks to package manager (ff18efd)
• internal: avoid errors for isinstance checks on proxies (b33d222)
• internal: base client updates (44f575e)
• internal: bump pyright version (bb6bbd3)
• internal: codegen related update (9f4f8d1)
• internal: fix list file params (74b3df7)
• internal: import reformatting (bba19e4)
• internal: minor formatting changes (0c58843)
• internal: refactor retries to not use recursion (4161fdb)
• internal: update models test (5e5dc11)

1.3.0 (2025-04-15)

Full Changelog: v1.2.0...v1.3.0

Features

• api: api update (#131) (1be828d)
• api: api update (#133) (2a08d98)
• api: api update (#140) (134049e)
• api: api update (#141) (145e5cb)
• api: api update (#143) (d55e411)
• client: allow passing NotGiven for body (#125) (6cdee1b)

Bug Fixes

• asyncify on non-asyncio runtimes (#123) (c8b2cd7)
• ci: ensure pip is always available (#138) (173fdde)
• ci: remove publishing patch (#139) (bd66d56)
• client: mark some request bodies as optional (6cdee1b)
• perf: optimize some hot paths (042f048)
• perf: skip traversing types for NotGiven values (5cc6c58)
• types: handle more discriminated union shapes (#137) (d9e09e3)

Chores

• client: minor internal fixes (47df6f5)
• docs: update client docstring (#129) (b2201f1)
• fix typos (#142) (0157632)
• internal: bump rye to 0.44.0 (#136) (9aeac01)
• internal: codegen related update (#124) (0678102)
• internal: codegen related update (#132) (3248d7e)
• internal: expand CI branch coverage (4494839)
• internal: fix devcontainers setup (#126) (eaf577b)
• internal: properly set pydantic_private (#127) (5236106)
• internal: reduce CI branch coverage (1bd4d8b)
• internal: remove extra empty newlines (#134) (2206050)
• internal: remove trailing character (#145) (2b055d7)
• internal: remove unused http client options forwarding (#130) (c63a3bd)
• internal: slight transform perf improvement (#147) (2d46582)
• internal: update client tests (#121) (862cd7e)
• internal: update pyright settings (0f0e110)
• slight wording improvement in README (#148) (c40603c)

Documentation

• update URLs from stainlessapi.com to stainless.com (#128) (5e2932f)

1.2.0 (2025-02-11)

Full Changelog: v1.1.0...v1.2.0

Features

• client: send X-Stainless-Read-Timeout header (#117) (e53c47a)

Chores

• internal: bummp ruff dependency (#115) (f687590)
• internal: change default timeout to an int (#113) (081bb21)
• internal: fix type traversing dictionary params (#118) (cc59fe8)
• internal: minor type handling changes (#119) (7be3940)

1.1.0 (2025-01-28)

Full Changelog: v1.0.5...v1.1.0

Features

• api: api update (#101) (5be14e9)
• api: api update (#104) (c13b2f9)
• api: api update (#105) (fc3b82f)
• api: api update (#109) (faca7e9)
• api: api update (#111) (42ae774)

Bug Fixes

• client: only call .close() when needed (#97) (01d5bd5)
• correctly handle deserialising cls fields (#100) (b617b85)

Chores

• add missing isclass check (#94) (de5856d)
• internal: add support for TypeAliasType (#85) (64448c6)
• internal: bump httpx dependency (#95) (d592266)
• internal: bump pydantic dependency (#81) (e35a0d8)
• internal: bump pyright (#83) (894b4c4)
• internal: codegen related update (#102) (f648bbb)
• internal: codegen related update (#106) (3fc9cde)
• internal: codegen related update (#107) (c97e138)
• internal: codegen related update (#86) (ab76578)
• internal: codegen related update (#87) (f7f189e)
• internal: codegen related update (#88) (85f1492)
• internal: codegen related update (#93) (57f0977)
• internal: codegen related update (#99) (f817bcb)
• internal: fix some typos (#92) (51d9f42)
• internal: minor formatting changes (#110) (195c595)
• internal: remove some duplicated imports (#89) (a82ae7d)
• internal: updated imports (#90) (dc6e187)
• make the Omit type public (#78) (a7bdc57)

Documentation

• fix typos (#98) (d4f4bae)
• readme: example snippet for client context manager (#91) (950c8af)
• readme: fix http client proxies example (#82) (cc67c77)

1.0.5 (2024-12-03)

Full Changelog: v1.0.4...v1.0.5

Chores

• internal: bump pyright (#73) (d5f9711)

1.0.4 (2024-11-29)

Full Changelog: v1.0.3...v1.0.4

Bug Fixes

• client: compat with new httpx 0.28.0 release (#71) (7b87947)

Chores

• internal: codegen related update (#68) (3e4372e)
• internal: exclude mypy from running on tests (#70) (edd3628)

1.0.3 (2024-11-22)

Full Changelog: v1.0.2...v1.0.3

Chores

• internal: fix compat model_dump method when warnings are passed (#65) (4e999de)

1.0.2 (2024-11-19)

Full Changelog: v1.0.1...v1.0.2

Chores

• rebuild project due to codegen change (#59) (bd52098)

1.0.1 (2024-11-18)

Full Changelog: v1.0.0...v1.0.1

Features

• api: api update (#48) (b17a3b8)
• api: api update (#51) (dc2da25)

Chores

• rebuild project due to codegen change (#53) (b1684fa)
• rebuild project due to codegen change (#54) (e6a41da)
• rebuild project due to codegen change (#55) (ff17087)
• rebuild project due to codegen change (#57) (dfd0e19)
• rebuild project due to codegen change (#58) (f3be0be)

1.0.0 (2024-10-29)

Full Changelog: v1.0.0-alpha.0...v1.0.0

Features

• api: api update (#44) (46621f6)

1.0.0-alpha.0 (2024-10-29)

Full Changelog: v0.1.0-alpha.7...v1.0.0-alpha.0

Features

• api: api update (#39) (8c98d9e)
• api: api update (#41) (0557ee5)