chore(api): update composite API spec

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 2284
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-a6c352830d1270d0abb5bb983058ea21815e1bb7d2e163965335dcb0e706f057.yml
-openapi_spec_hash: 2c07c63ba9f657089ed5fed8c92bc09c
+openapi_spec_hash: de25714eb2cb4cd5f9a5803ac1b921dc
 config_hash: 3504379ebb14928a9890a391899a2e10

src/cloudflare/resources/zero_trust/api.md

@@ -1715,15 +1715,9 @@ Methods:
 
 #### Items
 
-Types:
-
-```python
-from cloudflare.types.zero_trust.gateway.lists import ItemListResponse
-```
-
 Methods:
 
-- <code title="get /accounts/{account_id}/gateway/lists/{list_id}/items">client.zero_trust.gateway.lists.items.<a href="./src/cloudflare/resources/zero_trust/gateway/lists/items.py">list</a>(list_id, \*, account_id) -> <a href="./src/cloudflare/types/zero_trust/gateway/lists/item_list_response.py">SyncSinglePage[ItemListResponse]</a></code>
+- <code title="get /accounts/{account_id}/gateway/lists/{list_id}/items">client.zero_trust.gateway.lists.items.<a href="./src/cloudflare/resources/zero_trust/gateway/lists/items.py">list</a>(list_id, \*, account_id) -> <a href="./src/cloudflare/types/zero_trust/gateway/gateway_item.py">SyncSinglePage[GatewayItem]</a></code>
 
 ### Locations
 

src/cloudflare/resources/zero_trust/gateway/lists/items.py

@@ -16,7 +16,7 @@
 )
 from .....pagination import SyncSinglePage, AsyncSinglePage
 from ....._base_client import AsyncPaginator, make_request_options
-from .....types.zero_trust.gateway.lists.item_list_response import ItemListResponse
+from .....types.zero_trust.gateway.gateway_item import GatewayItem
 
 __all__ = ["ItemsResource", "AsyncItemsResource"]
 
@@ -52,7 +52,7 @@ def list(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> SyncSinglePage[ItemListResponse]:
+    ) -> SyncSinglePage[GatewayItem]:
         """
         Fetch all items in a single Zero Trust list.
 
@@ -75,11 +75,11 @@ def list(
             path_template(
                 "/accounts/{account_id}/gateway/lists/{list_id}/items", account_id=account_id, list_id=list_id
             ),
-            page=SyncSinglePage[ItemListResponse],
+            page=SyncSinglePage[GatewayItem],
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            model=ItemListResponse,
+            model=GatewayItem,
         )
 
 
@@ -114,7 +114,7 @@ def list(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> AsyncPaginator[ItemListResponse, AsyncSinglePage[ItemListResponse]]:
+    ) -> AsyncPaginator[GatewayItem, AsyncSinglePage[GatewayItem]]:
         """
         Fetch all items in a single Zero Trust list.
 
@@ -137,11 +137,11 @@ def list(
             path_template(
                 "/accounts/{account_id}/gateway/lists/{list_id}/items", account_id=account_id, list_id=list_id
             ),
-            page=AsyncSinglePage[ItemListResponse],
+            page=AsyncSinglePage[GatewayItem],
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            model=ItemListResponse,
+            model=GatewayItem,
         )
 
 

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_secs: Optional[int] | 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_secs: Specify the maximum TTL, in seconds, applied to DNS response records. Records
+              whose upstream TTL exceeds this value are served with the capped value. When
+              null or absent, no cap is applied at this tier.
+
           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_secs": max_ttl_secs,
                     "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_secs: Optional[int] | 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_secs: Specify the maximum TTL, in seconds, applied to DNS response records. Records
+              whose upstream TTL exceeds this value are served with the capped value. When
+              null or absent, no cap is applied at this tier.
+
           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_secs": max_ttl_secs,
                     "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_secs: Optional[int] | 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_secs: Specify the maximum TTL, in seconds, applied to DNS response records. Records
+              whose upstream TTL exceeds this value are served with the capped value. When
+              null or absent, no cap is applied at this tier.
+
           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_secs": max_ttl_secs,
                     "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_secs: Optional[int] | 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_secs: Specify the maximum TTL, in seconds, applied to DNS response records. Records
+              whose upstream TTL exceeds this value are served with the capped value. When
+              null or absent, no cap is applied at this tier.
+
           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_secs": max_ttl_secs,
                     "networks": networks,
                 },
                 location_update_params.LocationUpdateParams,

src/cloudflare/types/zero_trust/gateway/lists/__init__.py

@@ -1,5 +1,3 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 from __future__ import annotations
-
-from .item_list_response import ItemListResponse as ItemListResponse

src/cloudflare/types/zero_trust/gateway/lists/item_list_response.py

@@ -65,6 +65,13 @@ class Location(BaseModel):
     dns_destination_ips_id. This field read-only.
     """
 
+    max_ttl_secs: Optional[int] = None
+    """
+    Specify the maximum TTL, in seconds, applied to DNS response records. Records
+    whose upstream TTL exceeds this value are served with the capped value. When
+    null or absent, no cap is applied at this tier.
+    """
+
     name: Optional[str] = None
     """Specify the location name."""
 

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

@@ -34,6 +34,13 @@ class LocationCreateParams(TypedDict, total=False):
     endpoints: Optional[EndpointParam]
     """Configure the destination endpoints for this location."""
 
+    max_ttl_secs: Optional[int]
+    """
+    Specify the maximum TTL, in seconds, applied to DNS response records. Records
+    whose upstream TTL exceeds this value are served with the capped value. When
+    null or absent, no cap is applied at this tier.
+    """
+
     networks: Optional[Iterable[Network]]
     """
     Specify the list of network ranges from which requests at this location

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

@@ -34,6 +34,13 @@ class LocationUpdateParams(TypedDict, total=False):
     endpoints: Optional[EndpointParam]
     """Configure the destination endpoints for this location."""
 
+    max_ttl_secs: Optional[int]
+    """
+    Specify the maximum TTL, in seconds, applied to DNS response records. Records
+    whose upstream TTL exceeds this value are served with the capped value. When
+    null or absent, no cap is applied at this tier.
+    """
+
     networks: Optional[Iterable[Network]]
     """
     Specify the list of network ranges from which requests at this location

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

@@ -10,7 +10,7 @@
 from cloudflare import Cloudflare, AsyncCloudflare
 from tests.utils import assert_matches_type
 from cloudflare.pagination import SyncSinglePage, AsyncSinglePage
-from cloudflare.types.zero_trust.gateway.lists import ItemListResponse
+from cloudflare.types.zero_trust.gateway import GatewayItem
 
 base_url = os.environ.get("TEST_API_BASE_URL", "http://127.0.0.1:4010")
 
@@ -24,7 +24,7 @@ def test_method_list(self, client: Cloudflare) -> None:
             list_id="f174e90a-fafe-4643-bbbc-4a0ed4fc8415",
             account_id="699d98642c564d2e855e9661899b7252",
         )
-        assert_matches_type(SyncSinglePage[ItemListResponse], item, path=["response"])
+        assert_matches_type(SyncSinglePage[GatewayItem], item, path=["response"])
 
     @parametrize
     def test_raw_response_list(self, client: Cloudflare) -> None:
@@ -36,7 +36,7 @@ def test_raw_response_list(self, client: Cloudflare) -> None:
         assert response.is_closed is True
         assert response.http_request.headers.get("X-Stainless-Lang") == "python"
         item = response.parse()
-        assert_matches_type(SyncSinglePage[ItemListResponse], item, path=["response"])
+        assert_matches_type(SyncSinglePage[GatewayItem], item, path=["response"])
 
     @parametrize
     def test_streaming_response_list(self, client: Cloudflare) -> None:
@@ -48,7 +48,7 @@ def test_streaming_response_list(self, client: Cloudflare) -> None:
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
 
             item = response.parse()
-            assert_matches_type(SyncSinglePage[ItemListResponse], item, path=["response"])
+            assert_matches_type(SyncSinglePage[GatewayItem], item, path=["response"])
 
         assert cast(Any, response.is_closed) is True
 
@@ -78,7 +78,7 @@ async def test_method_list(self, async_client: AsyncCloudflare) -> None:
             list_id="f174e90a-fafe-4643-bbbc-4a0ed4fc8415",
             account_id="699d98642c564d2e855e9661899b7252",
         )
-        assert_matches_type(AsyncSinglePage[ItemListResponse], item, path=["response"])
+        assert_matches_type(AsyncSinglePage[GatewayItem], item, path=["response"])
 
     @parametrize
     async def test_raw_response_list(self, async_client: AsyncCloudflare) -> None:
@@ -90,7 +90,7 @@ async def test_raw_response_list(self, async_client: AsyncCloudflare) -> None:
         assert response.is_closed is True
         assert response.http_request.headers.get("X-Stainless-Lang") == "python"
         item = await response.parse()
-        assert_matches_type(AsyncSinglePage[ItemListResponse], item, path=["response"])
+        assert_matches_type(AsyncSinglePage[GatewayItem], item, path=["response"])
 
     @parametrize
     async def test_streaming_response_list(self, async_client: AsyncCloudflare) -> None:
@@ -102,7 +102,7 @@ async def test_streaming_response_list(self, async_client: AsyncCloudflare) -> N
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
 
             item = await response.parse()
-            assert_matches_type(AsyncSinglePage[ItemListResponse], item, path=["response"])
+            assert_matches_type(AsyncSinglePage[GatewayItem], item, path=["response"])
 
         assert cast(Any, response.is_closed) is True