chore(api): update composite API spec

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 2423
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare/cloudflare-f102c5ba1ae50994067ea9876a7d5e669ec366421f0ec7a74454f60fb0b4d78c.yml
-openapi_spec_hash: 23830b1f25fbe7f554b14a742b958536
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare/cloudflare-76a094c7339a3e10d15268d9a00db74f4ea9258cab6829b9dd3542bb0c887ee6.yml
+openapi_spec_hash: 85df1a77de03e8d8f5655c0ca4c8e12d
 config_hash: 87a3db059962c340822a760652737ce0

src/cloudflare/resources/zero_trust/gateway/configurations/configurations.py

@@ -118,9 +118,9 @@ def edit(
         """
         Update (PATCH) a single subcollection of settings such as `antivirus`,
         `tls_decrypt`, `activity_log`, `block_page`, `browser_isolation`, `fips`,
-        `body_scanning`, or `certificate` without updating the entire configuration
-        object. This endpoint returns an error if any settings collection lacks proper
-        configuration.
+        `body_scanning`, `certificate`, or `max_ttl_secs` without updating the entire
+        configuration object. This endpoint returns an error if any settings collection
+        lacks proper configuration.
 
         Args:
           settings: Specify account settings.
@@ -268,9 +268,9 @@ async def edit(
         """
         Update (PATCH) a single subcollection of settings such as `antivirus`,
         `tls_decrypt`, `activity_log`, `block_page`, `browser_isolation`, `fips`,
-        `body_scanning`, or `certificate` without updating the entire configuration
-        object. This endpoint returns an error if any settings collection lacks proper
-        configuration.
+        `body_scanning`, `certificate`, or `max_ttl_secs` without updating the entire
+        configuration object. This endpoint returns an error if any settings collection
+        lacks proper configuration.
 
         Args:
           settings: Specify account settings.

src/cloudflare/resources/zero_trust/gateway/locations.py

@@ -55,6 +55,7 @@ def create(
         dns_destination_ips_id: str | Omit = omit,
         ecs_support: bool | Omit = omit,
         endpoints: Optional[EndpointParam] | Omit = omit,
+        max_ttl: Optional[location_create_params.MaxTTL] | Omit = omit,
         networks: Optional[Iterable[location_create_params.Network]] | 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.
@@ -81,6 +82,10 @@ def create(
 
           endpoints: Configure the destination endpoints for this location.
 
+          max_ttl: Configure DNS response TTL behavior for this Gateway location. Gateway can
+              rewrite DNS responses to cap returned record TTLs using the account setting or a
+              location-specific value, or leave TTLs unchanged.
+
           networks: Specify the list of network ranges from which requests at this location
               originate. The list takes effect only if it is non-empty and the IPv4 endpoint
               is enabled for this location.
@@ -104,6 +109,7 @@ def create(
                     "dns_destination_ips_id": dns_destination_ips_id,
                     "ecs_support": ecs_support,
                     "endpoints": endpoints,
+                    "max_ttl": max_ttl,
                     "networks": networks,
                 },
                 location_create_params.LocationCreateParams,
@@ -128,6 +134,7 @@ def update(
         dns_destination_ips_id: str | Omit = omit,
         ecs_support: bool | Omit = omit,
         endpoints: Optional[EndpointParam] | Omit = omit,
+        max_ttl: Optional[location_update_params.MaxTTL] | Omit = omit,
         networks: Optional[Iterable[location_update_params.Network]] | 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.
@@ -154,6 +161,10 @@ def update(
 
           endpoints: Configure the destination endpoints for this location.
 
+          max_ttl: Configure DNS response TTL behavior for this Gateway location. Gateway can
+              rewrite DNS responses to cap returned record TTLs using the account setting or a
+              location-specific value, or leave TTLs unchanged.
+
           networks: Specify the list of network ranges from which requests at this location
               originate. The list takes effect only if it is non-empty and the IPv4 endpoint
               is enabled for this location.
@@ -181,6 +192,7 @@ def update(
                     "dns_destination_ips_id": dns_destination_ips_id,
                     "ecs_support": ecs_support,
                     "endpoints": endpoints,
+                    "max_ttl": max_ttl,
                     "networks": networks,
                 },
                 location_update_params.LocationUpdateParams,
@@ -343,6 +355,7 @@ async def create(
         dns_destination_ips_id: str | Omit = omit,
         ecs_support: bool | Omit = omit,
         endpoints: Optional[EndpointParam] | Omit = omit,
+        max_ttl: Optional[location_create_params.MaxTTL] | Omit = omit,
         networks: Optional[Iterable[location_create_params.Network]] | 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 +382,10 @@ async def create(
 
           endpoints: Configure the destination endpoints for this location.
 
+          max_ttl: Configure DNS response TTL behavior for this Gateway location. Gateway can
+              rewrite DNS responses to cap returned record TTLs using the account setting or a
+              location-specific value, or leave TTLs unchanged.
+
           networks: Specify the list of network ranges from which requests at this location
               originate. The list takes effect only if it is non-empty and the IPv4 endpoint
               is enabled for this location.
@@ -392,6 +409,7 @@ async def create(
                     "dns_destination_ips_id": dns_destination_ips_id,
                     "ecs_support": ecs_support,
                     "endpoints": endpoints,
+                    "max_ttl": max_ttl,
                     "networks": networks,
                 },
                 location_create_params.LocationCreateParams,
@@ -416,6 +434,7 @@ async def update(
         dns_destination_ips_id: str | Omit = omit,
         ecs_support: bool | Omit = omit,
         endpoints: Optional[EndpointParam] | Omit = omit,
+        max_ttl: Optional[location_update_params.MaxTTL] | Omit = omit,
         networks: Optional[Iterable[location_update_params.Network]] | 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.
@@ -442,6 +461,10 @@ async def update(
 
           endpoints: Configure the destination endpoints for this location.
 
+          max_ttl: Configure DNS response TTL behavior for this Gateway location. Gateway can
+              rewrite DNS responses to cap returned record TTLs using the account setting or a
+              location-specific value, or leave TTLs unchanged.
+
           networks: Specify the list of network ranges from which requests at this location
               originate. The list takes effect only if it is non-empty and the IPv4 endpoint
               is enabled for this location.
@@ -469,6 +492,7 @@ async def update(
                     "dns_destination_ips_id": dns_destination_ips_id,
                     "ecs_support": ecs_support,
                     "endpoints": endpoints,
+                    "max_ttl": max_ttl,
                     "networks": networks,
                 },
                 location_update_params.LocationUpdateParams,

src/cloudflare/types/zero_trust/gateway/gateway_configuration_settings.py

@@ -110,6 +110,13 @@ class GatewayConfigurationSettings(BaseModel):
     inspection: Optional[Inspection] = None
     """Define the proxy inspection mode."""
 
+    max_ttl_secs: Optional[int] = None
+    """Set the account-level DNS TTL cap, in seconds.
+
+    Gateway rewrites DNS responses so returned record TTLs do not exceed this value.
+    DNS locations can inherit, override, or disable this cap.
+    """
+
     protocol_detection: Optional[ProtocolDetection] = None
     """Specify whether to detect protocols from the initial bytes of client traffic."""
 

src/cloudflare/types/zero_trust/gateway/gateway_configuration_settings_param.py

@@ -111,6 +111,13 @@ class GatewayConfigurationSettingsParam(TypedDict, total=False):
     inspection: Optional[Inspection]
     """Define the proxy inspection mode."""
 
+    max_ttl_secs: Optional[int]
+    """Set the account-level DNS TTL cap, in seconds.
+
+    Gateway rewrites DNS responses so returned record TTLs do not exceed this value.
+    DNS locations can inherit, override, or disable this cap.
+    """
+
     protocol_detection: Optional[ProtocolDetectionParam]
     """Specify whether to detect protocols from the initial bytes of client traffic."""
 

src/cloudflare/types/zero_trust/gateway/location.py

@@ -2,11 +2,32 @@
 
 from typing import List, Optional
 from datetime import datetime
+from typing_extensions import Literal
 
 from .endpoint import Endpoint
 from ...._models import BaseModel
 
-__all__ = ["Location", "Network"]
+__all__ = ["Location", "MaxTTL", "Network"]
+
+
+class MaxTTL(BaseModel):
+    """Configure DNS response TTL behavior for this Gateway location.
+
+    Gateway can rewrite DNS responses to cap returned record TTLs using the account setting or a location-specific value, or leave TTLs unchanged.
+    """
+
+    mode: Literal["inherit", "override", "disabled"]
+    """
+    Specify how this location handles DNS response TTLs by using the account
+    setting, using a location-specific value, or leaving TTLs unchanged.
+    """
+
+    ttl_secs: Optional[int] = None
+    """Set the location-specific DNS TTL cap, in seconds.
+
+    Required when `mode` is `override`. Must be omitted when `mode` is `inherit` or
+    `disabled`.
+    """
 
 
 class Network(BaseModel):
@@ -65,6 +86,13 @@ class Location(BaseModel):
     dns_destination_ips_id. This field read-only.
     """
 
+    max_ttl: Optional[MaxTTL] = None
+    """Configure DNS response TTL behavior for this Gateway location.
+
+    Gateway can rewrite DNS responses to cap returned record TTLs using the account
+    setting or a location-specific value, or leave TTLs unchanged.
+    """
+
     name: Optional[str] = None
     """Specify the location name."""
 

src/cloudflare/types/zero_trust/gateway/location_create_params.py

@@ -3,11 +3,11 @@
 from __future__ import annotations
 
 from typing import Iterable, Optional
-from typing_extensions import Required, TypedDict
+from typing_extensions import Literal, Required, TypedDict
 
 from .endpoint_param import EndpointParam
 
-__all__ = ["LocationCreateParams", "Network"]
+__all__ = ["LocationCreateParams", "MaxTTL", "Network"]
 
 
 class LocationCreateParams(TypedDict, total=False):
@@ -34,6 +34,13 @@ class LocationCreateParams(TypedDict, total=False):
     endpoints: Optional[EndpointParam]
     """Configure the destination endpoints for this location."""
 
+    max_ttl: Optional[MaxTTL]
+    """Configure DNS response TTL behavior for this Gateway location.
+
+    Gateway can rewrite DNS responses to cap returned record TTLs using the account
+    setting or a location-specific value, or leave TTLs unchanged.
+    """
+
     networks: Optional[Iterable[Network]]
     """
     Specify the list of network ranges from which requests at this location
@@ -42,6 +49,26 @@ class LocationCreateParams(TypedDict, total=False):
     """
 
 
+class MaxTTL(TypedDict, total=False):
+    """Configure DNS response TTL behavior for this Gateway location.
+
+    Gateway can rewrite DNS responses to cap returned record TTLs using the account setting or a location-specific value, or leave TTLs unchanged.
+    """
+
+    mode: Required[Literal["inherit", "override", "disabled"]]
+    """
+    Specify how this location handles DNS response TTLs by using the account
+    setting, using a location-specific value, or leaving TTLs unchanged.
+    """
+
+    ttl_secs: Optional[int]
+    """Set the location-specific DNS TTL cap, in seconds.
+
+    Required when `mode` is `override`. Must be omitted when `mode` is `inherit` or
+    `disabled`.
+    """
+
+
 class Network(TypedDict, total=False):
     network: Required[str]
     """Specify the IPv4 address or IPv4 CIDR. Limit IPv4 CIDRs to a maximum of /24."""

src/cloudflare/types/zero_trust/gateway/location_update_params.py

@@ -3,11 +3,11 @@
 from __future__ import annotations
 
 from typing import Iterable, Optional
-from typing_extensions import Required, TypedDict
+from typing_extensions import Literal, Required, TypedDict
 
 from .endpoint_param import EndpointParam
 
-__all__ = ["LocationUpdateParams", "Network"]
+__all__ = ["LocationUpdateParams", "MaxTTL", "Network"]
 
 
 class LocationUpdateParams(TypedDict, total=False):
@@ -34,6 +34,13 @@ class LocationUpdateParams(TypedDict, total=False):
     endpoints: Optional[EndpointParam]
     """Configure the destination endpoints for this location."""
 
+    max_ttl: Optional[MaxTTL]
+    """Configure DNS response TTL behavior for this Gateway location.
+
+    Gateway can rewrite DNS responses to cap returned record TTLs using the account
+    setting or a location-specific value, or leave TTLs unchanged.
+    """
+
     networks: Optional[Iterable[Network]]
     """
     Specify the list of network ranges from which requests at this location
@@ -42,6 +49,26 @@ class LocationUpdateParams(TypedDict, total=False):
     """
 
 
+class MaxTTL(TypedDict, total=False):
+    """Configure DNS response TTL behavior for this Gateway location.
+
+    Gateway can rewrite DNS responses to cap returned record TTLs using the account setting or a location-specific value, or leave TTLs unchanged.
+    """
+
+    mode: Required[Literal["inherit", "override", "disabled"]]
+    """
+    Specify how this location handles DNS response TTLs by using the account
+    setting, using a location-specific value, or leaving TTLs unchanged.
+    """
+
+    ttl_secs: Optional[int]
+    """Set the location-specific DNS TTL cap, in seconds.
+
+    Required when `mode` is `override`. Must be omitted when `mode` is `inherit` or
+    `disabled`.
+    """
+
+
 class Network(TypedDict, total=False):
     network: Required[str]
     """Specify the IPv4 address or IPv4 CIDR. Limit IPv4 CIDRs to a maximum of /24."""

tests/api_resources/zero_trust/gateway/test_configurations.py

@@ -73,6 +73,7 @@ def test_method_update_with_all_params(self, client: Cloudflare) -> None:
                 "fips": {"tls": True},
                 "host_selector": {"enabled": False},
                 "inspection": {"mode": "static"},
+                "max_ttl_secs": 3600,
                 "protocol_detection": {"enabled": True},
                 "sandbox": {
                     "enabled": True,
@@ -166,6 +167,7 @@ def test_method_edit_with_all_params(self, client: Cloudflare) -> None:
                 "fips": {"tls": True},
                 "host_selector": {"enabled": False},
                 "inspection": {"mode": "static"},
+                "max_ttl_secs": 3600,
                 "protocol_detection": {"enabled": True},
                 "sandbox": {
                     "enabled": True,
@@ -303,6 +305,7 @@ async def test_method_update_with_all_params(self, async_client: AsyncCloudflare
                 "fips": {"tls": True},
                 "host_selector": {"enabled": False},
                 "inspection": {"mode": "static"},
+                "max_ttl_secs": 3600,
                 "protocol_detection": {"enabled": True},
                 "sandbox": {
                     "enabled": True,
@@ -396,6 +399,7 @@ async def test_method_edit_with_all_params(self, async_client: AsyncCloudflare)
                 "fips": {"tls": True},
                 "host_selector": {"enabled": False},
                 "inspection": {"mode": "static"},
+                "max_ttl_secs": 3600,
                 "protocol_detection": {"enabled": True},
                 "sandbox": {
                     "enabled": True,