chore(api): update composite API spec

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 2283
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-a6c352830d1270d0abb5bb983058ea21815e1bb7d2e163965335dcb0e706f057.yml
-openapi_spec_hash: 04b1f0e3282f29a02a1d2c44c04b44f5
+openapi_spec_hash: e3e8d9353d8e69b02fa345a95abbe336
 config_hash: af64aebd155c327064f15fb62f55c6fc

src/cloudflare/resources/zones/holds.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Type, cast
+from typing import Type, Optional, cast
 
 import httpx
 
@@ -58,7 +58,7 @@ def create(
     ) -> ZoneHold:
         """
         Enforce a zone hold on the zone, blocking the creation and activation of zones
-        with this zone's hostname.
+        with this zone's hostname. Zone holds cannot be enabled on CDN-only zones.
 
         Args:
           zone_id: Identifier.
@@ -106,13 +106,17 @@ def delete(
         """
         Stop enforcement of a zone hold on the zone, permanently or temporarily,
         allowing the creation and activation of zones with this zone's hostname.
+        Existing zone holds can be removed from CDN-only zones when `hold_after` is not
+        provided. Active holds are automatically disabled when a zone transitions to
+        CDN-only mode.
 
         Args:
           zone_id: Identifier.
 
           hold_after: If `hold_after` is provided, the hold will be temporarily disabled, then
               automatically re-enabled by the system at the time specified in this
               RFC3339-formatted timestamp. Otherwise, the hold will be disabled indefinitely.
+              `hold_after` cannot be provided for CDN-only zones.
 
           extra_headers: Send extra headers
 
@@ -141,7 +145,7 @@ def edit(
         self,
         *,
         zone_id: str,
-        hold_after: str | Omit = omit,
+        hold_after: Optional[str] | Omit = omit,
         include_subdomains: bool | 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.
@@ -153,6 +157,9 @@ def edit(
         """
         Update the `hold_after` and/or `include_subdomains` values on an existing zone
         hold. The hold is enabled if the `hold_after` date-time value is in the past.
+        Existing zone holds can be removed from CDN-only zones by setting `hold_after`
+        to `null`. Other zone hold updates cannot be made on CDN-only zones. Active
+        holds are automatically disabled when a zone transitions to CDN-only mode.
 
         Args:
           zone_id: Identifier.
@@ -161,7 +168,7 @@ def edit(
               disabled, then automatically re-enabled by the system at the time specified in
               this RFC3339-formatted timestamp. A past-dated `hold_after` value will have no
               effect on an existing, enabled hold. Providing an empty string will set its
-              value to the current time.
+              value to the current time. Providing `null` will disable the hold indefinitely.
 
           include_subdomains: If `true`, the zone hold will extend to block any subdomain of the given zone,
               as well as SSL4SaaS Custom Hostnames. For example, a zone hold on a zone with
@@ -272,7 +279,7 @@ async def create(
     ) -> ZoneHold:
         """
         Enforce a zone hold on the zone, blocking the creation and activation of zones
-        with this zone's hostname.
+        with this zone's hostname. Zone holds cannot be enabled on CDN-only zones.
 
         Args:
           zone_id: Identifier.
@@ -322,13 +329,17 @@ async def delete(
         """
         Stop enforcement of a zone hold on the zone, permanently or temporarily,
         allowing the creation and activation of zones with this zone's hostname.
+        Existing zone holds can be removed from CDN-only zones when `hold_after` is not
+        provided. Active holds are automatically disabled when a zone transitions to
+        CDN-only mode.
 
         Args:
           zone_id: Identifier.
 
           hold_after: If `hold_after` is provided, the hold will be temporarily disabled, then
               automatically re-enabled by the system at the time specified in this
               RFC3339-formatted timestamp. Otherwise, the hold will be disabled indefinitely.
+              `hold_after` cannot be provided for CDN-only zones.
 
           extra_headers: Send extra headers
 
@@ -357,7 +368,7 @@ async def edit(
         self,
         *,
         zone_id: str,
-        hold_after: str | Omit = omit,
+        hold_after: Optional[str] | Omit = omit,
         include_subdomains: bool | 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.
@@ -369,6 +380,9 @@ async def edit(
         """
         Update the `hold_after` and/or `include_subdomains` values on an existing zone
         hold. The hold is enabled if the `hold_after` date-time value is in the past.
+        Existing zone holds can be removed from CDN-only zones by setting `hold_after`
+        to `null`. Other zone hold updates cannot be made on CDN-only zones. Active
+        holds are automatically disabled when a zone transitions to CDN-only mode.
 
         Args:
           zone_id: Identifier.
@@ -377,7 +391,7 @@ async def edit(
               disabled, then automatically re-enabled by the system at the time specified in
               this RFC3339-formatted timestamp. A past-dated `hold_after` value will have no
               effect on an existing, enabled hold. Providing an empty string will set its
-              value to the current time.
+              value to the current time. Providing `null` will disable the hold indefinitely.
 
           include_subdomains: If `true`, the zone hold will extend to block any subdomain of the given zone,
               as well as SSL4SaaS Custom Hostnames. For example, a zone hold on a zone with

src/cloudflare/types/zones/hold_delete_params.py

@@ -16,4 +16,5 @@ class HoldDeleteParams(TypedDict, total=False):
     If `hold_after` is provided, the hold will be temporarily disabled, then
     automatically re-enabled by the system at the time specified in this
     RFC3339-formatted timestamp. Otherwise, the hold will be disabled indefinitely.
+    `hold_after` cannot be provided for CDN-only zones.
     """

src/cloudflare/types/zones/hold_edit_params.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+from typing import Optional
 from typing_extensions import Required, TypedDict
 
 __all__ = ["HoldEditParams"]
@@ -11,13 +12,13 @@ class HoldEditParams(TypedDict, total=False):
     zone_id: Required[str]
     """Identifier."""
 
-    hold_after: str
+    hold_after: Optional[str]
     """
     If `hold_after` is provided and future-dated, the hold will be temporarily
     disabled, then automatically re-enabled by the system at the time specified in
     this RFC3339-formatted timestamp. A past-dated `hold_after` value will have no
     effect on an existing, enabled hold. Providing an empty string will set its
-    value to the current time.
+    value to the current time. Providing `null` will disable the hold indefinitely.
     """
 
     include_subdomains: bool