feat(api): manual updates

stainless-app[bot] · stainless-app[bot] · commit 074f06d0dfb0 · 2025-09-04T08:52:56.000Z
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
-configured_endpoints: 18
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fbrowserbase-c14a7d6b23a7fd42a26a7c55a668d1dcd2e4b58354b878e696bc959d808c71c9.yml
-openapi_spec_hash: a0878bab95e435f9ce0d2418f0784d06
-config_hash: b3ca4ec5b02e5333af51ebc2e9fdef1b
+configured_endpoints: 20
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fbrowserbase-be7a4aeebb1605262935b4b3ab446a95b1fad8a7d18098943dd548c8a486ef13.yml
+openapi_spec_hash: 047517d5a996009459c04f2fe3b0d3f9
+config_hash: 5a44f3aad0ead6985fbdf0294c79286b
diff --git a/api.md b/api.md
@@ -11,6 +11,7 @@ Methods:
 - <code title="post /v1/contexts">client.contexts.<a href="./src/browserbase/resources/contexts.py">create</a>(\*\*<a href="src/browserbase/types/context_create_params.py">params</a>) -> <a href="./src/browserbase/types/context_create_response.py">ContextCreateResponse</a></code>
 - <code title="get /v1/contexts/{id}">client.contexts.<a href="./src/browserbase/resources/contexts.py">retrieve</a>(id) -> <a href="./src/browserbase/types/context_retrieve_response.py">ContextRetrieveResponse</a></code>
 - <code title="put /v1/contexts/{id}">client.contexts.<a href="./src/browserbase/resources/contexts.py">update</a>(id) -> <a href="./src/browserbase/types/context_update_response.py">ContextUpdateResponse</a></code>
+- <code title="delete /v1/contexts/{id}">client.contexts.<a href="./src/browserbase/resources/contexts.py">delete</a>(id) -> None</code>
 
 # Extensions
 
@@ -67,6 +68,7 @@ Methods:
 Methods:
 
 - <code title="get /v1/sessions/{id}/downloads">client.sessions.downloads.<a href="./src/browserbase/resources/sessions/downloads.py">list</a>(id) -> BinaryAPIResponse</code>
+- <code title="delete /v1/sessions/{id}/downloads">client.sessions.downloads.<a href="./src/browserbase/resources/sessions/downloads.py">delete</a>(id) -> None</code>
 
 ## Logs
 
diff --git a/src/browserbase/resources/contexts.py b/src/browserbase/resources/contexts.py
@@ -5,7 +5,7 @@
 import httpx
 
 from ..types import context_create_params
-from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from .._types import NOT_GIVEN, Body, Query, Headers, NoneType, NotGiven
 from .._utils import maybe_transform, async_maybe_transform
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
@@ -145,6 +145,40 @@ def update(
             cast_to=ContextUpdateResponse,
         )
 
+    def delete(
+        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,
+    ) -> None:
+        """
+        Delete a Context
+
+        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}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return self._delete(
+            f"/v1/contexts/{id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
 
 class AsyncContextsResource(AsyncAPIResource):
     @cached_property
@@ -268,6 +302,40 @@ async def update(
             cast_to=ContextUpdateResponse,
         )
 
+    async def delete(
+        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,
+    ) -> None:
+        """
+        Delete a Context
+
+        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}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return await self._delete(
+            f"/v1/contexts/{id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
 
 class ContextsResourceWithRawResponse:
     def __init__(self, contexts: ContextsResource) -> None:
@@ -282,6 +350,9 @@ def __init__(self, contexts: ContextsResource) -> None:
         self.update = to_raw_response_wrapper(
             contexts.update,
         )
+        self.delete = to_raw_response_wrapper(
+            contexts.delete,
+        )
 
 
 class AsyncContextsResourceWithRawResponse:
@@ -297,6 +368,9 @@ def __init__(self, contexts: AsyncContextsResource) -> None:
         self.update = async_to_raw_response_wrapper(
             contexts.update,
         )
+        self.delete = async_to_raw_response_wrapper(
+            contexts.delete,
+        )
 
 
 class ContextsResourceWithStreamingResponse:
@@ -312,6 +386,9 @@ def __init__(self, contexts: ContextsResource) -> None:
         self.update = to_streamed_response_wrapper(
             contexts.update,
         )
+        self.delete = to_streamed_response_wrapper(
+            contexts.delete,
+        )
 
 
 class AsyncContextsResourceWithStreamingResponse:
@@ -327,3 +404,6 @@ def __init__(self, contexts: AsyncContextsResource) -> None:
         self.update = async_to_streamed_response_wrapper(
             contexts.update,
         )
+        self.delete = async_to_streamed_response_wrapper(
+            contexts.delete,
+        )
diff --git a/src/browserbase/resources/sessions/downloads.py b/src/browserbase/resources/sessions/downloads.py
@@ -4,15 +4,19 @@
 
 import httpx
 
-from ..._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from ..._types import NOT_GIVEN, Body, Query, Headers, NoneType, NotGiven
 from ..._compat import cached_property
 from ..._resource import SyncAPIResource, AsyncAPIResource
 from ..._response import (
     BinaryAPIResponse,
     AsyncBinaryAPIResponse,
     StreamedBinaryAPIResponse,
     AsyncStreamedBinaryAPIResponse,
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
     to_custom_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
     to_custom_streamed_response_wrapper,
     async_to_custom_raw_response_wrapper,
     async_to_custom_streamed_response_wrapper,
@@ -76,6 +80,40 @@ def list(
             cast_to=BinaryAPIResponse,
         )
 
+    def delete(
+        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,
+    ) -> None:
+        """
+        Delete Session Downloads
+
+        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}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return self._delete(
+            f"/v1/sessions/{id}/downloads",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
 
 class AsyncDownloadsResource(AsyncAPIResource):
     @cached_property
@@ -131,6 +169,40 @@ async def list(
             cast_to=AsyncBinaryAPIResponse,
         )
 
+    async def delete(
+        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,
+    ) -> None:
+        """
+        Delete Session Downloads
+
+        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}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return await self._delete(
+            f"/v1/sessions/{id}/downloads",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
 
 class DownloadsResourceWithRawResponse:
     def __init__(self, downloads: DownloadsResource) -> None:
@@ -140,6 +212,9 @@ def __init__(self, downloads: DownloadsResource) -> None:
             downloads.list,
             BinaryAPIResponse,
         )
+        self.delete = to_raw_response_wrapper(
+            downloads.delete,
+        )
 
 
 class AsyncDownloadsResourceWithRawResponse:
@@ -150,6 +225,9 @@ def __init__(self, downloads: AsyncDownloadsResource) -> None:
             downloads.list,
             AsyncBinaryAPIResponse,
         )
+        self.delete = async_to_raw_response_wrapper(
+            downloads.delete,
+        )
 
 
 class DownloadsResourceWithStreamingResponse:
@@ -160,6 +238,9 @@ def __init__(self, downloads: DownloadsResource) -> None:
             downloads.list,
             StreamedBinaryAPIResponse,
         )
+        self.delete = to_streamed_response_wrapper(
+            downloads.delete,
+        )
 
 
 class AsyncDownloadsResourceWithStreamingResponse:
@@ -170,3 +251,6 @@ def __init__(self, downloads: AsyncDownloadsResource) -> None:
             downloads.list,
             AsyncStreamedBinaryAPIResponse,
         )
+        self.delete = async_to_streamed_response_wrapper(
+            downloads.delete,
+        )
diff --git a/src/browserbase/types/session_create_params.py b/src/browserbase/types/session_create_params.py
@@ -144,6 +144,12 @@ class BrowserSettings(TypedDict, total=False):
     log_session: Annotated[bool, PropertyInfo(alias="logSession")]
     """Enable or disable session logging. Defaults to `true`."""
 
+    os: Literal["windows", "mac", "linux", "mobile", "tablet"]
+    """Operating system for stealth mode.
+
+    Valid values: windows, mac, linux, mobile, tablet
+    """
+
     record_session: Annotated[bool, PropertyInfo(alias="recordSession")]
     """Enable or disable session recording. Defaults to `true`."""
 
diff --git a/tests/api_resources/sessions/test_downloads.py b/tests/api_resources/sessions/test_downloads.py
@@ -73,6 +73,44 @@ def test_path_params_list(self, client: Browserbase) -> None:
                 "",
             )
 
+    @parametrize
+    def test_method_delete(self, client: Browserbase) -> None:
+        download = client.sessions.downloads.delete(
+            "id",
+        )
+        assert download is None
+
+    @parametrize
+    def test_raw_response_delete(self, client: Browserbase) -> None:
+        response = client.sessions.downloads.with_raw_response.delete(
+            "id",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        download = response.parse()
+        assert download is None
+
+    @parametrize
+    def test_streaming_response_delete(self, client: Browserbase) -> None:
+        with client.sessions.downloads.with_streaming_response.delete(
+            "id",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            download = response.parse()
+            assert download is None
+
+        assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    def test_path_params_delete(self, client: Browserbase) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `id` but received ''"):
+            client.sessions.downloads.with_raw_response.delete(
+                "",
+            )
+
 
 class TestAsyncDownloads:
     parametrize = pytest.mark.parametrize(
@@ -128,3 +166,41 @@ async def test_path_params_list(self, async_client: AsyncBrowserbase) -> None:
             await async_client.sessions.downloads.with_raw_response.list(
                 "",
             )
+
+    @parametrize
+    async def test_method_delete(self, async_client: AsyncBrowserbase) -> None:
+        download = await async_client.sessions.downloads.delete(
+            "id",
+        )
+        assert download is None
+
+    @parametrize
+    async def test_raw_response_delete(self, async_client: AsyncBrowserbase) -> None:
+        response = await async_client.sessions.downloads.with_raw_response.delete(
+            "id",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        download = await response.parse()
+        assert download is None
+
+    @parametrize
+    async def test_streaming_response_delete(self, async_client: AsyncBrowserbase) -> None:
+        async with async_client.sessions.downloads.with_streaming_response.delete(
+            "id",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            download = await response.parse()
+            assert download is None
+
+        assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    async def test_path_params_delete(self, async_client: AsyncBrowserbase) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `id` but received ''"):
+            await async_client.sessions.downloads.with_raw_response.delete(
+                "",
+            )
diff --git a/tests/api_resources/test_contexts.py b/tests/api_resources/test_contexts.py
diff --git a/tests/api_resources/test_sessions.py b/tests/api_resources/test_sessions.py
