feat: api: support per-acquire start_url override on browser pool acquire

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 122
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-7cde13c82c71b7a5fd64b592f853a7c999c0e0c02dce161e6126d0e99df3412b.yml
-openapi_spec_hash: 52cda226c70a248cbea3af6c52822b44
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-d9b82fc5346c9be1bf9c2b18792fdcdec6a80a86153ca765c9e93e597b46fa24.yml
+openapi_spec_hash: 9cbaab975acfa421b795d11aa635c57e
 config_hash: 99b2b2a25e8067ad9c9214e38e01d64c

src/kernel/resources/browser_pools.py

@@ -427,6 +427,7 @@ def acquire(
         *,
         acquire_timeout_seconds: int | Omit = omit,
         name: str | Omit = omit,
+        start_url: str | Omit = omit,
         tags: TagsParam | 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.
@@ -452,6 +453,10 @@ def acquire(
               project. Applies to this lease only and is cleared when the browser is released
               back to the pool.
 
+          start_url: Optional URL to navigate the acquired browser to. Overrides the pool's start_url
+              for this acquire only. Best-effort: failures to navigate do not fail the
+              acquire.
+
           tags: Optional user-defined key-value tags for the acquired browser session, used to
               find and group sessions later. Applies to this lease only and are cleared when
               the browser is released back to the pool. Up to 50 pairs.
@@ -472,6 +477,7 @@ def acquire(
                 {
                     "acquire_timeout_seconds": acquire_timeout_seconds,
                     "name": name,
+                    "start_url": start_url,
                     "tags": tags,
                 },
                 browser_pool_acquire_params.BrowserPoolAcquireParams,
@@ -956,6 +962,7 @@ async def acquire(
         *,
         acquire_timeout_seconds: int | Omit = omit,
         name: str | Omit = omit,
+        start_url: str | Omit = omit,
         tags: TagsParam | 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.
@@ -981,6 +988,10 @@ async def acquire(
               project. Applies to this lease only and is cleared when the browser is released
               back to the pool.
 
+          start_url: Optional URL to navigate the acquired browser to. Overrides the pool's start_url
+              for this acquire only. Best-effort: failures to navigate do not fail the
+              acquire.
+
           tags: Optional user-defined key-value tags for the acquired browser session, used to
               find and group sessions later. Applies to this lease only and are cleared when
               the browser is released back to the pool. Up to 50 pairs.
@@ -1001,6 +1012,7 @@ async def acquire(
                 {
                     "acquire_timeout_seconds": acquire_timeout_seconds,
                     "name": name,
+                    "start_url": start_url,
                     "tags": tags,
                 },
                 browser_pool_acquire_params.BrowserPoolAcquireParams,

src/kernel/types/browser_pool_acquire_params.py

@@ -25,6 +25,13 @@ class BrowserPoolAcquireParams(TypedDict, total=False):
     back to the pool.
     """
 
+    start_url: str
+    """Optional URL to navigate the acquired browser to.
+
+    Overrides the pool's start_url for this acquire only. Best-effort: failures to
+    navigate do not fail the acquire.
+    """
+
     tags: TagsParam
     """
     Optional user-defined key-value tags for the acquired browser session, used to

tests/api_resources/test_browser_pools.py

@@ -311,6 +311,7 @@ def test_method_acquire_with_all_params(self, client: Kernel) -> None:
             id_or_name="id_or_name",
             acquire_timeout_seconds=0,
             name="checkout-flow-1",
+            start_url="https://example.com",
             tags={
                 "team": "backend",
                 "env": "staging",
@@ -746,6 +747,7 @@ async def test_method_acquire_with_all_params(self, async_client: AsyncKernel) -
             id_or_name="id_or_name",
             acquire_timeout_seconds=0,
             name="checkout-flow-1",
+            start_url="https://example.com",
             tags={
                 "team": "backend",
                 "env": "staging",