release: 1.15.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.14.0"
+  ".": "1.15.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 36
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/browserbase-e82c289d3d3aabd936a476cf81630587ffe46ab9e9bdebced4b31b8c2f9bc08f.yml
-openapi_spec_hash: 473121b283812a3dfd866afe9b61dc7d
-config_hash: 1b24ea9fa13645b16b74aa794dbc8190
+configured_endpoints: 38
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/browserbase-98cc68ad9afa71355baf2b31f305a5e2f3a315fd311c96659405eff96b8f2b1e.yml
+openapi_spec_hash: 71dfbc1021a33dd7fc9d82844965b1b3
+config_hash: 6209a285dd5980f5c418fe6575723aef

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 1.15.0 (2026-07-14)
+
+Full Changelog: [v1.14.0...v1.15.0](https://github.com/browserbase/sdk-python/compare/v1.14.0...v1.15.0)
+
+### Features
+
+* **api:** manual updates ([39fee02](https://github.com/browserbase/sdk-python/commit/39fee028ec9f64b472dcbe2cac94f044bed79a4b))
+
 ## 1.14.0 (2026-07-02)
 
 Full Changelog: [v1.13.0...v1.14.0](https://github.com/browserbase/sdk-python/compare/v1.13.0...v1.14.0)

api.md

@@ -130,7 +130,24 @@ from browserbase.types.sessions import SessionRecording, RecordingRetrieveRespon
 
 Methods:
 
-- <code title="get /v1/sessions/{id}/recording">client.sessions.recording.<a href="./src/browserbase/resources/sessions/recording.py">retrieve</a>(id) -> <a href="./src/browserbase/types/sessions/recording_retrieve_response.py">RecordingRetrieveResponse</a></code>
+- <code title="get /v1/sessions/{id}/recording">client.sessions.recording.<a href="./src/browserbase/resources/sessions/recording/recording.py">retrieve</a>(id) -> <a href="./src/browserbase/types/sessions/recording_retrieve_response.py">RecordingRetrieveResponse</a></code>
+
+### Downloads
+
+Types:
+
+```python
+from browserbase.types.sessions.recording import (
+    RecordingDownload,
+    DownloadCreateResponse,
+    DownloadListResponse,
+)
+```
+
+Methods:
+
+- <code title="post /v1/sessions/{id}/recording/downloads">client.sessions.recording.downloads.<a href="./src/browserbase/resources/sessions/recording/downloads.py">create</a>(id) -> <a href="./src/browserbase/types/sessions/recording/download_create_response.py">DownloadCreateResponse</a></code>
+- <code title="get /v1/sessions/{id}/recording/downloads">client.sessions.recording.downloads.<a href="./src/browserbase/resources/sessions/recording/downloads.py">list</a>(id) -> <a href="./src/browserbase/types/sessions/recording/download_list_response.py">DownloadListResponse</a></code>
 
 ## Uploads
 

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "browserbase"
-version = "1.14.0"
+version = "1.15.0"
 description = "The official Python library for the Browserbase API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/browserbase/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "browserbase"
-__version__ = "1.14.0"  # x-release-please-version
+__version__ = "1.15.0"  # x-release-please-version

src/browserbase/resources/sessions/recording/__init__.py

@@ -0,0 +1,33 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .downloads import (
+    DownloadsResource,
+    AsyncDownloadsResource,
+    DownloadsResourceWithRawResponse,
+    AsyncDownloadsResourceWithRawResponse,
+    DownloadsResourceWithStreamingResponse,
+    AsyncDownloadsResourceWithStreamingResponse,
+)
+from .recording import (
+    RecordingResource,
+    AsyncRecordingResource,
+    RecordingResourceWithRawResponse,
+    AsyncRecordingResourceWithRawResponse,
+    RecordingResourceWithStreamingResponse,
+    AsyncRecordingResourceWithStreamingResponse,
+)
+
+__all__ = [
+    "DownloadsResource",
+    "AsyncDownloadsResource",
+    "DownloadsResourceWithRawResponse",
+    "AsyncDownloadsResourceWithRawResponse",
+    "DownloadsResourceWithStreamingResponse",
+    "AsyncDownloadsResourceWithStreamingResponse",
+    "RecordingResource",
+    "AsyncRecordingResource",
+    "RecordingResourceWithRawResponse",
+    "AsyncRecordingResourceWithRawResponse",
+    "RecordingResourceWithStreamingResponse",
+    "AsyncRecordingResourceWithStreamingResponse",
+]

src/browserbase/resources/sessions/recording/downloads.py

@@ -0,0 +1,253 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+import httpx
+
+from ...._types import Body, Query, Headers, NotGiven, not_given
+from ...._utils import path_template
+from ...._compat import cached_property
+from ...._resource import SyncAPIResource, AsyncAPIResource
+from ...._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from ...._base_client import make_request_options
+from ....types.sessions.recording.download_list_response import DownloadListResponse
+from ....types.sessions.recording.download_create_response import DownloadCreateResponse
+
+__all__ = ["DownloadsResource", "AsyncDownloadsResource"]
+
+
+class DownloadsResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> DownloadsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/browserbase/sdk-python#accessing-raw-response-data-eg-headers
+        """
+        return DownloadsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> DownloadsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/browserbase/sdk-python#with_streaming_response
+        """
+        return DownloadsResourceWithStreamingResponse(self)
+
+    def create(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> DownloadCreateResponse:
+        """Requests one downloadable MP4 per recorded page of a session.
+
+        Assembly runs
+        asynchronously and every page returns as `PENDING`. Re-posting re-enqueues all
+        pages and retries any that failed. Poll the GET endpoint for per-page status
+        and, on standard (non-BYOS) projects, download URLs.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._post(
+            path_template("/v1/sessions/{id}/recording/downloads", id=id),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=DownloadCreateResponse,
+        )
+
+    def list(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> DownloadListResponse:
+        """
+        Returns the per-page download status for a session, with a short-lived signed
+        URL for each completed page on standard (non-BYOS) projects.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._get(
+            path_template("/v1/sessions/{id}/recording/downloads", id=id),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=DownloadListResponse,
+        )
+
+
+class AsyncDownloadsResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncDownloadsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/browserbase/sdk-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncDownloadsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncDownloadsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/browserbase/sdk-python#with_streaming_response
+        """
+        return AsyncDownloadsResourceWithStreamingResponse(self)
+
+    async def create(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> DownloadCreateResponse:
+        """Requests one downloadable MP4 per recorded page of a session.
+
+        Assembly runs
+        asynchronously and every page returns as `PENDING`. Re-posting re-enqueues all
+        pages and retries any that failed. Poll the GET endpoint for per-page status
+        and, on standard (non-BYOS) projects, download URLs.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._post(
+            path_template("/v1/sessions/{id}/recording/downloads", id=id),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=DownloadCreateResponse,
+        )
+
+    async def list(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> DownloadListResponse:
+        """
+        Returns the per-page download status for a session, with a short-lived signed
+        URL for each completed page on standard (non-BYOS) projects.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._get(
+            path_template("/v1/sessions/{id}/recording/downloads", id=id),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=DownloadListResponse,
+        )
+
+
+class DownloadsResourceWithRawResponse:
+    def __init__(self, downloads: DownloadsResource) -> None:
+        self._downloads = downloads
+
+        self.create = to_raw_response_wrapper(
+            downloads.create,
+        )
+        self.list = to_raw_response_wrapper(
+            downloads.list,
+        )
+
+
+class AsyncDownloadsResourceWithRawResponse:
+    def __init__(self, downloads: AsyncDownloadsResource) -> None:
+        self._downloads = downloads
+
+        self.create = async_to_raw_response_wrapper(
+            downloads.create,
+        )
+        self.list = async_to_raw_response_wrapper(
+            downloads.list,
+        )
+
+
+class DownloadsResourceWithStreamingResponse:
+    def __init__(self, downloads: DownloadsResource) -> None:
+        self._downloads = downloads
+
+        self.create = to_streamed_response_wrapper(
+            downloads.create,
+        )
+        self.list = to_streamed_response_wrapper(
+            downloads.list,
+        )
+
+
+class AsyncDownloadsResourceWithStreamingResponse:
+    def __init__(self, downloads: AsyncDownloadsResource) -> None:
+        self._downloads = downloads
+
+        self.create = async_to_streamed_response_wrapper(
+            downloads.create,
+        )
+        self.list = async_to_streamed_response_wrapper(
+            downloads.list,
+        )