chore(api): update composite API spec

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 2184
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-95d8075980561cae9cc6ce09b5f930b84eae6f0864cb155abe47db94df2ee294.yml
-openapi_spec_hash: 056ce7b95f00677a933e6da00b21c37c
+configured_endpoints: 2185
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-8afbe34627bb47c62422bcfe82d49e1ab7e5ea8e2f0d655a6a0ba3e4648c5e47.yml
+openapi_spec_hash: 5a1a5d008c6f779c308ac0ae5a096de0
 config_hash: 95239e8fc62638979bc21e538307bbe3

src/cloudflare/resources/browser_rendering/api.md

@@ -160,6 +160,7 @@ from cloudflare.types.browser_rendering.devtools.browser import (
     TargetCreateResponse,
     TargetListResponse,
     TargetActivateResponse,
+    TargetCloseResponse,
     TargetGetResponse,
 )
 ```
@@ -169,4 +170,5 @@ Methods:
 - <code title="put /accounts/{account_id}/browser-rendering/devtools/browser/{session_id}/json/new">client.browser_rendering.devtools.browser.targets.<a href="./src/cloudflare/resources/browser_rendering/devtools/browser/targets.py">create</a>(session_id, \*, account_id, \*\*<a href="src/cloudflare/types/browser_rendering/devtools/browser/target_create_params.py">params</a>) -> <a href="./src/cloudflare/types/browser_rendering/devtools/browser/target_create_response.py">TargetCreateResponse</a></code>
 - <code title="get /accounts/{account_id}/browser-rendering/devtools/browser/{session_id}/json/list">client.browser_rendering.devtools.browser.targets.<a href="./src/cloudflare/resources/browser_rendering/devtools/browser/targets.py">list</a>(session_id, \*, account_id) -> <a href="./src/cloudflare/types/browser_rendering/devtools/browser/target_list_response.py">TargetListResponse</a></code>
 - <code title="get /accounts/{account_id}/browser-rendering/devtools/browser/{session_id}/json/activate/{target_id}">client.browser_rendering.devtools.browser.targets.<a href="./src/cloudflare/resources/browser_rendering/devtools/browser/targets.py">activate</a>(target_id, \*, account_id, session_id) -> <a href="./src/cloudflare/types/browser_rendering/devtools/browser/target_activate_response.py">TargetActivateResponse</a></code>
+- <code title="get /accounts/{account_id}/browser-rendering/devtools/browser/{session_id}/json/close/{target_id}">client.browser_rendering.devtools.browser.targets.<a href="./src/cloudflare/resources/browser_rendering/devtools/browser/targets.py">close</a>(target_id, \*, account_id, session_id) -> <a href="./src/cloudflare/types/browser_rendering/devtools/browser/target_close_response.py">TargetCloseResponse</a></code>
 - <code title="get /accounts/{account_id}/browser-rendering/devtools/browser/{session_id}/json/list/{target_id}">client.browser_rendering.devtools.browser.targets.<a href="./src/cloudflare/resources/browser_rendering/devtools/browser/targets.py">get</a>(target_id, \*, account_id, session_id) -> <a href="./src/cloudflare/types/browser_rendering/devtools/browser/target_get_response.py">TargetGetResponse</a></code>

src/cloudflare/resources/browser_rendering/devtools/browser/targets.py

@@ -18,6 +18,7 @@
 from .....types.browser_rendering.devtools.browser import target_create_params
 from .....types.browser_rendering.devtools.browser.target_get_response import TargetGetResponse
 from .....types.browser_rendering.devtools.browser.target_list_response import TargetListResponse
+from .....types.browser_rendering.devtools.browser.target_close_response import TargetCloseResponse
 from .....types.browser_rendering.devtools.browser.target_create_response import TargetCreateResponse
 from .....types.browser_rendering.devtools.browser.target_activate_response import TargetActivateResponse
 
@@ -189,6 +190,58 @@ def activate(
             cast_to=TargetActivateResponse,
         )
 
+    def close(
+        self,
+        target_id: str,
+        *,
+        account_id: str,
+        session_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,
+    ) -> TargetCloseResponse:
+        """Closes a specific browser target (tab, page, etc.) by its ID.
+
+        Returns 'Target is
+        closing' on success or an error if the target is not found.
+
+        Args:
+          account_id: Account ID.
+
+          session_id: Browser session ID.
+
+          target_id: Target ID to close.
+
+          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 account_id:
+            raise ValueError(f"Expected a non-empty value for `account_id` but received {account_id!r}")
+        if not session_id:
+            raise ValueError(f"Expected a non-empty value for `session_id` but received {session_id!r}")
+        if not target_id:
+            raise ValueError(f"Expected a non-empty value for `target_id` but received {target_id!r}")
+        return self._get(
+            path_template(
+                "/accounts/{account_id}/browser-rendering/devtools/browser/{session_id}/json/close/{target_id}",
+                account_id=account_id,
+                session_id=session_id,
+                target_id=target_id,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=TargetCloseResponse,
+        )
+
     def get(
         self,
         target_id: str,
@@ -405,6 +458,58 @@ async def activate(
             cast_to=TargetActivateResponse,
         )
 
+    async def close(
+        self,
+        target_id: str,
+        *,
+        account_id: str,
+        session_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,
+    ) -> TargetCloseResponse:
+        """Closes a specific browser target (tab, page, etc.) by its ID.
+
+        Returns 'Target is
+        closing' on success or an error if the target is not found.
+
+        Args:
+          account_id: Account ID.
+
+          session_id: Browser session ID.
+
+          target_id: Target ID to close.
+
+          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 account_id:
+            raise ValueError(f"Expected a non-empty value for `account_id` but received {account_id!r}")
+        if not session_id:
+            raise ValueError(f"Expected a non-empty value for `session_id` but received {session_id!r}")
+        if not target_id:
+            raise ValueError(f"Expected a non-empty value for `target_id` but received {target_id!r}")
+        return await self._get(
+            path_template(
+                "/accounts/{account_id}/browser-rendering/devtools/browser/{session_id}/json/close/{target_id}",
+                account_id=account_id,
+                session_id=session_id,
+                target_id=target_id,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=TargetCloseResponse,
+        )
+
     async def get(
         self,
         target_id: str,
@@ -469,6 +574,9 @@ def __init__(self, targets: TargetsResource) -> None:
         self.activate = to_raw_response_wrapper(
             targets.activate,
         )
+        self.close = to_raw_response_wrapper(
+            targets.close,
+        )
         self.get = to_raw_response_wrapper(
             targets.get,
         )
@@ -487,6 +595,9 @@ def __init__(self, targets: AsyncTargetsResource) -> None:
         self.activate = async_to_raw_response_wrapper(
             targets.activate,
         )
+        self.close = async_to_raw_response_wrapper(
+            targets.close,
+        )
         self.get = async_to_raw_response_wrapper(
             targets.get,
         )
@@ -505,6 +616,9 @@ def __init__(self, targets: TargetsResource) -> None:
         self.activate = to_streamed_response_wrapper(
             targets.activate,
         )
+        self.close = to_streamed_response_wrapper(
+            targets.close,
+        )
         self.get = to_streamed_response_wrapper(
             targets.get,
         )
@@ -523,6 +637,9 @@ def __init__(self, targets: AsyncTargetsResource) -> None:
         self.activate = async_to_streamed_response_wrapper(
             targets.activate,
         )
+        self.close = async_to_streamed_response_wrapper(
+            targets.close,
+        )
         self.get = async_to_streamed_response_wrapper(
             targets.get,
         )

src/cloudflare/types/browser_rendering/devtools/browser/__init__.py

@@ -5,5 +5,6 @@
 from .target_get_response import TargetGetResponse as TargetGetResponse
 from .target_create_params import TargetCreateParams as TargetCreateParams
 from .target_list_response import TargetListResponse as TargetListResponse
+from .target_close_response import TargetCloseResponse as TargetCloseResponse
 from .target_create_response import TargetCreateResponse as TargetCreateResponse
 from .target_activate_response import TargetActivateResponse as TargetActivateResponse

src/cloudflare/types/browser_rendering/devtools/browser/target_close_response.py

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from ....._models import BaseModel
+
+__all__ = ["TargetCloseResponse"]
+
+
+class TargetCloseResponse(BaseModel):
+    message: str
+    """Target is closing."""

tests/api_resources/browser_rendering/devtools/browser/test_targets.py

@@ -12,6 +12,7 @@
 from cloudflare.types.browser_rendering.devtools.browser import (
     TargetGetResponse,
     TargetListResponse,
+    TargetCloseResponse,
     TargetCreateResponse,
     TargetActivateResponse,
 )
@@ -187,6 +188,66 @@ def test_path_params_activate(self, client: Cloudflare) -> None:
                 session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
             )
 
+    @parametrize
+    def test_method_close(self, client: Cloudflare) -> None:
+        target = client.browser_rendering.devtools.browser.targets.close(
+            target_id="target_id",
+            account_id="account_id",
+            session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+        )
+        assert_matches_type(TargetCloseResponse, target, path=["response"])
+
+    @parametrize
+    def test_raw_response_close(self, client: Cloudflare) -> None:
+        response = client.browser_rendering.devtools.browser.targets.with_raw_response.close(
+            target_id="target_id",
+            account_id="account_id",
+            session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        target = response.parse()
+        assert_matches_type(TargetCloseResponse, target, path=["response"])
+
+    @parametrize
+    def test_streaming_response_close(self, client: Cloudflare) -> None:
+        with client.browser_rendering.devtools.browser.targets.with_streaming_response.close(
+            target_id="target_id",
+            account_id="account_id",
+            session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            target = response.parse()
+            assert_matches_type(TargetCloseResponse, target, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    def test_path_params_close(self, client: Cloudflare) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `account_id` but received ''"):
+            client.browser_rendering.devtools.browser.targets.with_raw_response.close(
+                target_id="target_id",
+                account_id="",
+                session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            )
+
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `session_id` but received ''"):
+            client.browser_rendering.devtools.browser.targets.with_raw_response.close(
+                target_id="target_id",
+                account_id="account_id",
+                session_id="",
+            )
+
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `target_id` but received ''"):
+            client.browser_rendering.devtools.browser.targets.with_raw_response.close(
+                target_id="",
+                account_id="account_id",
+                session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            )
+
     @parametrize
     def test_method_get(self, client: Cloudflare) -> None:
         target = client.browser_rendering.devtools.browser.targets.get(
@@ -418,6 +479,66 @@ async def test_path_params_activate(self, async_client: AsyncCloudflare) -> None
                 session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
             )
 
+    @parametrize
+    async def test_method_close(self, async_client: AsyncCloudflare) -> None:
+        target = await async_client.browser_rendering.devtools.browser.targets.close(
+            target_id="target_id",
+            account_id="account_id",
+            session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+        )
+        assert_matches_type(TargetCloseResponse, target, path=["response"])
+
+    @parametrize
+    async def test_raw_response_close(self, async_client: AsyncCloudflare) -> None:
+        response = await async_client.browser_rendering.devtools.browser.targets.with_raw_response.close(
+            target_id="target_id",
+            account_id="account_id",
+            session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        target = await response.parse()
+        assert_matches_type(TargetCloseResponse, target, path=["response"])
+
+    @parametrize
+    async def test_streaming_response_close(self, async_client: AsyncCloudflare) -> None:
+        async with async_client.browser_rendering.devtools.browser.targets.with_streaming_response.close(
+            target_id="target_id",
+            account_id="account_id",
+            session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            target = await response.parse()
+            assert_matches_type(TargetCloseResponse, target, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    async def test_path_params_close(self, async_client: AsyncCloudflare) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `account_id` but received ''"):
+            await async_client.browser_rendering.devtools.browser.targets.with_raw_response.close(
+                target_id="target_id",
+                account_id="",
+                session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            )
+
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `session_id` but received ''"):
+            await async_client.browser_rendering.devtools.browser.targets.with_raw_response.close(
+                target_id="target_id",
+                account_id="account_id",
+                session_id="",
+            )
+
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `target_id` but received ''"):
+            await async_client.browser_rendering.devtools.browser.targets.with_raw_response.close(
+                target_id="",
+                account_id="account_id",
+                session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            )
+
     @parametrize
     async def test_method_get(self, async_client: AsyncCloudflare) -> None:
         target = await async_client.browser_rendering.devtools.browser.targets.get(

tests/api_resources/browser_rendering/test_content.py

@@ -29,7 +29,7 @@ def test_method_create_with_all_params_overload_1(self, client: Cloudflare) -> N
         content = client.browser_rendering.content.create(
             account_id="account_id",
             url="https://example.com/",
-            cache_ttl=86400,
+            cache_ttl=0,
             action_timeout=120000,
             add_script_tag=[
                 {
@@ -147,7 +147,7 @@ def test_method_create_with_all_params_overload_2(self, client: Cloudflare) -> N
         content = client.browser_rendering.content.create(
             account_id="account_id",
             html="<h1>Hello World!</h1>",
-            cache_ttl=86400,
+            cache_ttl=0,
             action_timeout=120000,
             add_script_tag=[
                 {
@@ -271,7 +271,7 @@ async def test_method_create_with_all_params_overload_1(self, async_client: Asyn
         content = await async_client.browser_rendering.content.create(
             account_id="account_id",
             url="https://example.com/",
-            cache_ttl=86400,
+            cache_ttl=0,
             action_timeout=120000,
             add_script_tag=[
                 {
@@ -389,7 +389,7 @@ async def test_method_create_with_all_params_overload_2(self, async_client: Asyn
         content = await async_client.browser_rendering.content.create(
             account_id="account_id",
             html="<h1>Hello World!</h1>",
-            cache_ttl=86400,
+            cache_ttl=0,
             action_timeout=120000,
             add_script_tag=[
                 {