feat: [AI-1972] - Move fetch v2 handler into /v1/fetch

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 21
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/browserbase-1821faac6d1422fea15b3ba1f88c0f5f00c43464524e17d3fd1efd1ea148b7c4.yml
-openapi_spec_hash: 1e3fba074314f557dc6973cf97ea6a69
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/browserbase-3032c74460ad9c1c4b0a1b2d9107c556f292974a8ce12d525660a9cf31f10bc1.yml
+openapi_spec_hash: 8ac1c673ce4e72b88bbbf30100b95e8f
 config_hash: cf04ecfb8dad5fbd8b85be25d6e9ec55

src/browserbase/resources/fetch_api.py

@@ -2,6 +2,9 @@
 
 from __future__ import annotations
 
+from typing import Dict
+from typing_extensions import Literal
+
 import httpx
 
 from ..types import fetch_api_create_params
@@ -47,7 +50,9 @@ def create(
         url: str,
         allow_insecure_ssl: bool | Omit = omit,
         allow_redirects: bool | Omit = omit,
+        format: Literal["raw", "json", "markdown"] | Omit = omit,
         proxies: bool | Omit = omit,
+        schema: Dict[str, object] | Omit = omit,
         # 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,
@@ -65,8 +70,15 @@ def create(
 
           allow_redirects: Whether to follow HTTP redirects
 
+          format: Output format for the response content. `raw` (default) returns the response
+              body unchanged; `json` returns structured data (requires `schema`); `markdown`
+              returns the page as markdown.
+
           proxies: Whether to enable proxy support for the request
 
+          schema: JSON Schema describing the desired structure of the response. Only used when
+              `format` is `json`.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -82,7 +94,9 @@ def create(
                     "url": url,
                     "allow_insecure_ssl": allow_insecure_ssl,
                     "allow_redirects": allow_redirects,
+                    "format": format,
                     "proxies": proxies,
+                    "schema": schema,
                 },
                 fetch_api_create_params.FetchAPICreateParams,
             ),
@@ -119,7 +133,9 @@ async def create(
         url: str,
         allow_insecure_ssl: bool | Omit = omit,
         allow_redirects: bool | Omit = omit,
+        format: Literal["raw", "json", "markdown"] | Omit = omit,
         proxies: bool | Omit = omit,
+        schema: Dict[str, object] | Omit = omit,
         # 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,
@@ -137,8 +153,15 @@ async def create(
 
           allow_redirects: Whether to follow HTTP redirects
 
+          format: Output format for the response content. `raw` (default) returns the response
+              body unchanged; `json` returns structured data (requires `schema`); `markdown`
+              returns the page as markdown.
+
           proxies: Whether to enable proxy support for the request
 
+          schema: JSON Schema describing the desired structure of the response. Only used when
+              `format` is `json`.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -154,7 +177,9 @@ async def create(
                     "url": url,
                     "allow_insecure_ssl": allow_insecure_ssl,
                     "allow_redirects": allow_redirects,
+                    "format": format,
                     "proxies": proxies,
+                    "schema": schema,
                 },
                 fetch_api_create_params.FetchAPICreateParams,
             ),

src/browserbase/types/fetch_api_create_params.py

@@ -2,7 +2,8 @@
 
 from __future__ import annotations
 
-from typing_extensions import Required, Annotated, TypedDict
+from typing import Dict
+from typing_extensions import Literal, Required, Annotated, TypedDict
 
 from .._utils import PropertyInfo
 
@@ -19,5 +20,18 @@ class FetchAPICreateParams(TypedDict, total=False):
     allow_redirects: Annotated[bool, PropertyInfo(alias="allowRedirects")]
     """Whether to follow HTTP redirects"""
 
+    format: Literal["raw", "json", "markdown"]
+    """Output format for the response content.
+
+    `raw` (default) returns the response body unchanged; `json` returns structured
+    data (requires `schema`); `markdown` returns the page as markdown.
+    """
+
     proxies: bool
     """Whether to enable proxy support for the request"""
+
+    schema: Dict[str, object]
+    """JSON Schema describing the desired structure of the response.
+
+    Only used when `format` is `json`.
+    """

tests/api_resources/test_fetch_api.py

@@ -30,7 +30,9 @@ def test_method_create_with_all_params(self, client: Browserbase) -> None:
             url="https://example.com",
             allow_insecure_ssl=True,
             allow_redirects=True,
+            format="raw",
             proxies=True,
+            schema={"foo": "bar"},
         )
         assert_matches_type(FetchAPICreateResponse, fetch_api, path=["response"])
 
@@ -77,7 +79,9 @@ async def test_method_create_with_all_params(self, async_client: AsyncBrowserbas
             url="https://example.com",
             allow_insecure_ssl=True,
             allow_redirects=True,
+            format="raw",
             proxies=True,
+            schema={"foo": "bar"},
         )
         assert_matches_type(FetchAPICreateResponse, fetch_api, path=["response"])