feat(api): OpenAPI spec update via Stainless API (#1200)

Author: stainless-app[bot]

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 1258
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-0ac180c47ed9fe592a3b6dd8635623b4419a73968e580eacd342734e0a383fb7.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-90a35461612450a99cbc7456efed147532b3bbd683a18535b759d9c02742c835.yml

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

@@ -130,8 +130,10 @@ def delete(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Optional[CertificateDeleteResponse]:
-        """
-        Deletes a gateway-managed Zero Trust certificate.
+        """Deletes a gateway-managed Zero Trust certificate.
+
+        A certificate must be
+        deactivated from the edge (inactive) before it is deleted.
 
         Args:
           certificate_id: Certificate UUID tag.
@@ -302,8 +304,10 @@ async def delete(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Optional[CertificateDeleteResponse]:
-        """
-        Deletes a gateway-managed Zero Trust certificate.
+        """Deletes a gateway-managed Zero Trust certificate.
+
+        A certificate must be
+        deactivated from the edge (inactive) before it is deleted.
 
         Args:
           certificate_id: Certificate UUID tag.

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

@@ -46,6 +46,7 @@ def create(
         client_default: bool | NotGiven = NOT_GIVEN,
         dns_destination_ips_id: str | NotGiven = NOT_GIVEN,
         ecs_support: bool | NotGiven = NOT_GIVEN,
+        endpoints: location_create_params.Endpoints | NotGiven = NOT_GIVEN,
         networks: Iterable[location_create_params.Network] | NotGiven = NOT_GIVEN,
         # 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.
@@ -70,6 +71,10 @@ def create(
 
           ecs_support: True if the location needs to resolve EDNS queries.
 
+          endpoints: The destination endpoints configured for this location. When updating a
+              location, if this field is absent or set with null, the endpoints configuration
+              remains unchanged.
+
           networks: A list of network ranges that requests from this location would originate from.
               A non-empty list is only effective if the ipv4 endpoint is enabled for this
               location.
@@ -92,6 +97,7 @@ def create(
                     "client_default": client_default,
                     "dns_destination_ips_id": dns_destination_ips_id,
                     "ecs_support": ecs_support,
+                    "endpoints": endpoints,
                     "networks": networks,
                 },
                 location_create_params.LocationCreateParams,
@@ -115,6 +121,7 @@ def update(
         client_default: bool | NotGiven = NOT_GIVEN,
         dns_destination_ips_id: str | NotGiven = NOT_GIVEN,
         ecs_support: bool | NotGiven = NOT_GIVEN,
+        endpoints: location_update_params.Endpoints | NotGiven = NOT_GIVEN,
         networks: Iterable[location_update_params.Network] | NotGiven = NOT_GIVEN,
         # 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.
@@ -139,6 +146,10 @@ def update(
 
           ecs_support: True if the location needs to resolve EDNS queries.
 
+          endpoints: The destination endpoints configured for this location. When updating a
+              location, if this field is absent or set with null, the endpoints configuration
+              remains unchanged.
+
           networks: A list of network ranges that requests from this location would originate from.
               A non-empty list is only effective if the ipv4 endpoint is enabled for this
               location.
@@ -163,6 +174,7 @@ def update(
                     "client_default": client_default,
                     "dns_destination_ips_id": dns_destination_ips_id,
                     "ecs_support": ecs_support,
+                    "endpoints": endpoints,
                     "networks": networks,
                 },
                 location_update_params.LocationUpdateParams,
@@ -314,6 +326,7 @@ async def create(
         client_default: bool | NotGiven = NOT_GIVEN,
         dns_destination_ips_id: str | NotGiven = NOT_GIVEN,
         ecs_support: bool | NotGiven = NOT_GIVEN,
+        endpoints: location_create_params.Endpoints | NotGiven = NOT_GIVEN,
         networks: Iterable[location_create_params.Network] | NotGiven = NOT_GIVEN,
         # 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.
@@ -338,6 +351,10 @@ async def create(
 
           ecs_support: True if the location needs to resolve EDNS queries.
 
+          endpoints: The destination endpoints configured for this location. When updating a
+              location, if this field is absent or set with null, the endpoints configuration
+              remains unchanged.
+
           networks: A list of network ranges that requests from this location would originate from.
               A non-empty list is only effective if the ipv4 endpoint is enabled for this
               location.
@@ -360,6 +377,7 @@ async def create(
                     "client_default": client_default,
                     "dns_destination_ips_id": dns_destination_ips_id,
                     "ecs_support": ecs_support,
+                    "endpoints": endpoints,
                     "networks": networks,
                 },
                 location_create_params.LocationCreateParams,
@@ -383,6 +401,7 @@ async def update(
         client_default: bool | NotGiven = NOT_GIVEN,
         dns_destination_ips_id: str | NotGiven = NOT_GIVEN,
         ecs_support: bool | NotGiven = NOT_GIVEN,
+        endpoints: location_update_params.Endpoints | NotGiven = NOT_GIVEN,
         networks: Iterable[location_update_params.Network] | NotGiven = NOT_GIVEN,
         # 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.
@@ -407,6 +426,10 @@ async def update(
 
           ecs_support: True if the location needs to resolve EDNS queries.
 
+          endpoints: The destination endpoints configured for this location. When updating a
+              location, if this field is absent or set with null, the endpoints configuration
+              remains unchanged.
+
           networks: A list of network ranges that requests from this location would originate from.
               A non-empty list is only effective if the ipv4 endpoint is enabled for this
               location.
@@ -431,6 +454,7 @@ async def update(
                     "client_default": client_default,
                     "dns_destination_ips_id": dns_destination_ips_id,
                     "ecs_support": ecs_support,
+                    "endpoints": endpoints,
                     "networks": networks,
                 },
                 location_update_params.LocationUpdateParams,

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

@@ -14,7 +14,10 @@ class CertificateCreateResponse(BaseModel):
     """Certificate UUID tag."""
 
     binding_status: Optional[Literal["pending_deployment", "active", "pending_deletion", "inactive"]] = None
-    """The deployment status of the certificate on Cloudflare's edge."""
+    """The deployment status of the certificate on Cloudflare's edge.
+
+    Certificates in the 'active' state may be used for Gateway TLS interception.
+    """
 
     created_at: Optional[datetime] = None
 

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

@@ -14,7 +14,10 @@ class CertificateDeleteResponse(BaseModel):
     """Certificate UUID tag."""
 
     binding_status: Optional[Literal["pending_deployment", "active", "pending_deletion", "inactive"]] = None
-    """The deployment status of the certificate on Cloudflare's edge."""
+    """The deployment status of the certificate on Cloudflare's edge.
+
+    Certificates in the 'active' state may be used for Gateway TLS interception.
+    """
 
     created_at: Optional[datetime] = None
 

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

@@ -14,7 +14,10 @@ class CertificateGetResponse(BaseModel):
     """Certificate UUID tag."""
 
     binding_status: Optional[Literal["pending_deployment", "active", "pending_deletion", "inactive"]] = None
-    """The deployment status of the certificate on Cloudflare's edge."""
+    """The deployment status of the certificate on Cloudflare's edge.
+
+    Certificates in the 'active' state may be used for Gateway TLS interception.
+    """
 
     created_at: Optional[datetime] = None
 

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

@@ -14,7 +14,10 @@ class CertificateListResponse(BaseModel):
     """Certificate UUID tag."""
 
     binding_status: Optional[Literal["pending_deployment", "active", "pending_deletion", "inactive"]] = None
-    """The deployment status of the certificate on Cloudflare's edge."""
+    """The deployment status of the certificate on Cloudflare's edge.
+
+    Certificates in the 'active' state may be used for Gateway TLS interception.
+    """
 
     created_at: Optional[datetime] = None
 

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

@@ -19,7 +19,10 @@
 
 class Certificate(BaseModel):
     id: str
-    """UUID of certificate to be used for interception."""
+    """UUID of certificate to be used for interception.
+
+    Certificate must be active on the edge.
+    """
 
 
 class GatewayConfigurationSettings(BaseModel):

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

@@ -20,7 +20,10 @@
 
 class Certificate(TypedDict, total=False):
     id: Required[str]
-    """UUID of certificate to be used for interception."""
+    """UUID of certificate to be used for interception.
+
+    Certificate must be active on the edge.
+    """
 
 
 class GatewayConfigurationSettingsParam(TypedDict, total=False):

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

@@ -5,7 +5,18 @@
 from typing import Iterable
 from typing_extensions import Required, TypedDict
 
-__all__ = ["LocationCreateParams", "Network"]
+__all__ = [
+    "LocationCreateParams",
+    "Endpoints",
+    "EndpointsDOH",
+    "EndpointsDOHNetwork",
+    "EndpointsDOT",
+    "EndpointsDOTNetwork",
+    "EndpointsIPV4",
+    "EndpointsIPV6",
+    "EndpointsIPV6Network",
+    "Network",
+]
 
 
 class LocationCreateParams(TypedDict, total=False):
@@ -29,6 +40,13 @@ class LocationCreateParams(TypedDict, total=False):
     ecs_support: bool
     """True if the location needs to resolve EDNS queries."""
 
+    endpoints: Endpoints
+    """The destination endpoints configured for this location.
+
+    When updating a location, if this field is absent or set with null, the
+    endpoints configuration remains unchanged.
+    """
+
     networks: Iterable[Network]
     """A list of network ranges that requests from this location would originate from.
 
@@ -37,6 +55,79 @@ class LocationCreateParams(TypedDict, total=False):
     """
 
 
+class EndpointsDOHNetwork(TypedDict, total=False):
+    network: Required[str]
+    """The IP address or IP CIDR."""
+
+
+class EndpointsDOH(TypedDict, total=False):
+    enabled: bool
+    """True if the endpoint is enabled for this location."""
+
+    networks: Iterable[EndpointsDOHNetwork]
+    """A list of allowed source IP network ranges for this endpoint.
+
+    When empty, all source IPs are allowed. A non-empty list is only effective if
+    the endpoint is enabled for this location.
+    """
+
+    require_token: bool
+    """
+    True if the endpoint requires
+    [user identity](https://developers.cloudflare.com/cloudflare-one/connections/connect-devices/agentless/dns/dns-over-https/#filter-doh-requests-by-user)
+    authentication.
+    """
+
+
+class EndpointsDOTNetwork(TypedDict, total=False):
+    network: Required[str]
+    """The IP address or IP CIDR."""
+
+
+class EndpointsDOT(TypedDict, total=False):
+    enabled: bool
+    """True if the endpoint is enabled for this location."""
+
+    networks: Iterable[EndpointsDOTNetwork]
+    """A list of allowed source IP network ranges for this endpoint.
+
+    When empty, all source IPs are allowed. A non-empty list is only effective if
+    the endpoint is enabled for this location.
+    """
+
+
+class EndpointsIPV4(TypedDict, total=False):
+    enabled: bool
+    """True if the endpoint is enabled for this location."""
+
+
+class EndpointsIPV6Network(TypedDict, total=False):
+    network: Required[str]
+    """The IPv6 address or IPv6 CIDR."""
+
+
+class EndpointsIPV6(TypedDict, total=False):
+    enabled: bool
+    """True if the endpoint is enabled for this location."""
+
+    networks: Iterable[EndpointsIPV6Network]
+    """A list of allowed source IPv6 network ranges for this endpoint.
+
+    When empty, all source IPs are allowed. A non-empty list is only effective if
+    the endpoint is enabled for this location.
+    """
+
+
+class Endpoints(TypedDict, total=False):
+    doh: EndpointsDOH
+
+    dot: EndpointsDOT
+
+    ipv4: EndpointsIPV4
+
+    ipv6: EndpointsIPV6
+
+
 class Network(TypedDict, total=False):
     network: Required[str]
     """The IPv4 address or IPv4 CIDR. IPv4 CIDRs are limited to a maximum of /24."""