feat: docs: WC-4152 Expose subdomain delete for workers

* docs: WC-4152 Expose subdomain delete for workers

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 1886
+configured_endpoints: 1887
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-ffb103f5eee9b32861f01358666cd5ca83d8c5b17eb87398652b6b1512a4a830.yml
 openapi_spec_hash: 748e21d73949bb766db229a1c3ecf8ce
-config_hash: feb968146b5a84697390fed70d260f68
+config_hash: da15c53ae7de30af9d9aa523b32f6559

api.md

@@ -2582,6 +2582,7 @@ from cloudflare.types.workers import SubdomainUpdateResponse, SubdomainGetRespon
 Methods:
 
 - <code title="put /accounts/{account_id}/workers/subdomain">client.workers.subdomains.<a href="./src/cloudflare/resources/workers/subdomains.py">update</a>(\*, account_id, \*\*<a href="src/cloudflare/types/workers/subdomain_update_params.py">params</a>) -> <a href="./src/cloudflare/types/workers/subdomain_update_response.py">SubdomainUpdateResponse</a></code>
+- <code title="delete /accounts/{account_id}/workers/subdomain">client.workers.subdomains.<a href="./src/cloudflare/resources/workers/subdomains.py">delete</a>(\*, account_id) -> None</code>
 - <code title="get /accounts/{account_id}/workers/subdomain">client.workers.subdomains.<a href="./src/cloudflare/resources/workers/subdomains.py">get</a>(\*, account_id) -> <a href="./src/cloudflare/types/workers/subdomain_get_response.py">SubdomainGetResponse</a></code>
 
 ## Observability

src/cloudflare/resources/workers/subdomains.py

@@ -6,7 +6,7 @@
 
 import httpx
 
-from ..._types import Body, Query, Headers, NotGiven, not_given
+from ..._types import Body, Query, Headers, NoneType, NotGiven, not_given
 from ..._utils import maybe_transform, async_maybe_transform
 from ..._compat import cached_property
 from ..._resource import SyncAPIResource, AsyncAPIResource
@@ -86,6 +86,42 @@ def update(
             cast_to=cast(Type[SubdomainUpdateResponse], ResultWrapper[SubdomainUpdateResponse]),
         )
 
+    def delete(
+        self,
+        *,
+        account_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:
+        """
+        Deletes a Workers subdomain for an account.
+
+        Args:
+          account_id: Identifier.
+
+          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}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return self._delete(
+            f"/accounts/{account_id}/workers/subdomain",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
     def get(
         self,
         *,
@@ -187,6 +223,42 @@ async def update(
             cast_to=cast(Type[SubdomainUpdateResponse], ResultWrapper[SubdomainUpdateResponse]),
         )
 
+    async def delete(
+        self,
+        *,
+        account_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:
+        """
+        Deletes a Workers subdomain for an account.
+
+        Args:
+          account_id: Identifier.
+
+          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}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return await self._delete(
+            f"/accounts/{account_id}/workers/subdomain",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
     async def get(
         self,
         *,
@@ -234,6 +306,9 @@ def __init__(self, subdomains: SubdomainsResource) -> None:
         self.update = to_raw_response_wrapper(
             subdomains.update,
         )
+        self.delete = to_raw_response_wrapper(
+            subdomains.delete,
+        )
         self.get = to_raw_response_wrapper(
             subdomains.get,
         )
@@ -246,6 +321,9 @@ def __init__(self, subdomains: AsyncSubdomainsResource) -> None:
         self.update = async_to_raw_response_wrapper(
             subdomains.update,
         )
+        self.delete = async_to_raw_response_wrapper(
+            subdomains.delete,
+        )
         self.get = async_to_raw_response_wrapper(
             subdomains.get,
         )
@@ -258,6 +336,9 @@ def __init__(self, subdomains: SubdomainsResource) -> None:
         self.update = to_streamed_response_wrapper(
             subdomains.update,
         )
+        self.delete = to_streamed_response_wrapper(
+            subdomains.delete,
+        )
         self.get = to_streamed_response_wrapper(
             subdomains.get,
         )
@@ -270,6 +351,9 @@ def __init__(self, subdomains: AsyncSubdomainsResource) -> None:
         self.update = async_to_streamed_response_wrapper(
             subdomains.update,
         )
+        self.delete = async_to_streamed_response_wrapper(
+            subdomains.delete,
+        )
         self.get = async_to_streamed_response_wrapper(
             subdomains.get,
         )

tests/api_resources/workers/test_subdomains.py

@@ -59,6 +59,44 @@ def test_path_params_update(self, client: Cloudflare) -> None:
                 subdomain="my-subdomain",
             )
 
+    @parametrize
+    def test_method_delete(self, client: Cloudflare) -> None:
+        subdomain = client.workers.subdomains.delete(
+            account_id="023e105f4ecef8ad9ca31a8372d0c353",
+        )
+        assert subdomain is None
+
+    @parametrize
+    def test_raw_response_delete(self, client: Cloudflare) -> None:
+        response = client.workers.subdomains.with_raw_response.delete(
+            account_id="023e105f4ecef8ad9ca31a8372d0c353",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        subdomain = response.parse()
+        assert subdomain is None
+
+    @parametrize
+    def test_streaming_response_delete(self, client: Cloudflare) -> None:
+        with client.workers.subdomains.with_streaming_response.delete(
+            account_id="023e105f4ecef8ad9ca31a8372d0c353",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            subdomain = response.parse()
+            assert subdomain is None
+
+        assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    def test_path_params_delete(self, client: Cloudflare) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `account_id` but received ''"):
+            client.workers.subdomains.with_raw_response.delete(
+                account_id="",
+            )
+
     @parametrize
     def test_method_get(self, client: Cloudflare) -> None:
         subdomain = client.workers.subdomains.get(
@@ -145,6 +183,44 @@ async def test_path_params_update(self, async_client: AsyncCloudflare) -> None:
                 subdomain="my-subdomain",
             )
 
+    @parametrize
+    async def test_method_delete(self, async_client: AsyncCloudflare) -> None:
+        subdomain = await async_client.workers.subdomains.delete(
+            account_id="023e105f4ecef8ad9ca31a8372d0c353",
+        )
+        assert subdomain is None
+
+    @parametrize
+    async def test_raw_response_delete(self, async_client: AsyncCloudflare) -> None:
+        response = await async_client.workers.subdomains.with_raw_response.delete(
+            account_id="023e105f4ecef8ad9ca31a8372d0c353",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        subdomain = await response.parse()
+        assert subdomain is None
+
+    @parametrize
+    async def test_streaming_response_delete(self, async_client: AsyncCloudflare) -> None:
+        async with async_client.workers.subdomains.with_streaming_response.delete(
+            account_id="023e105f4ecef8ad9ca31a8372d0c353",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            subdomain = await response.parse()
+            assert subdomain is None
+
+        assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    async def test_path_params_delete(self, async_client: AsyncCloudflare) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `account_id` but received ''"):
+            await async_client.workers.subdomains.with_raw_response.delete(
+                account_id="",
+            )
+
     @parametrize
     async def test_method_get(self, async_client: AsyncCloudflare) -> None:
         subdomain = await async_client.workers.subdomains.get(