chore(api): update composite API spec

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 2185
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-8afbe34627bb47c62422bcfe82d49e1ab7e5ea8e2f0d655a6a0ba3e4648c5e47.yml
-openapi_spec_hash: 5a1a5d008c6f779c308ac0ae5a096de0
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-ea5d30bcded86d4f9fca4175a9bfdd0713e6dea3b9224506ebf03c104e652df7.yml
+openapi_spec_hash: 85e897c979f187c5170264420489e9f0
 config_hash: 95239e8fc62638979bc21e538307bbe3

src/cloudflare/resources/api_gateway/operations/operations.py

@@ -354,6 +354,7 @@ def get(
         *,
         zone_id: str,
         feature: List[Literal["thresholds", "parameter_schemas", "schema_info"]] | Omit = omit,
+        with_schemas: 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.
         extra_headers: Headers | None = None,
@@ -374,6 +375,10 @@ def get(
               to the resulting feature object. Have a look at the top-level object description
               for more details on the specific meaning.
 
+          with_schemas: When true, includes OpenAPI schemas (both uploaded and learned) for the
+              operation in the response. Due to the conversion overhead, this parameter is
+              only supported on single-operation retrieval.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -395,7 +400,13 @@ def get(
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                query=maybe_transform({"feature": feature}, operation_get_params.OperationGetParams),
+                query=maybe_transform(
+                    {
+                        "feature": feature,
+                        "with_schemas": with_schemas,
+                    },
+                    operation_get_params.OperationGetParams,
+                ),
                 post_parser=ResultWrapper[OperationGetResponse]._unwrapper,
             ),
             cast_to=cast(Type[OperationGetResponse], ResultWrapper[OperationGetResponse]),
@@ -704,6 +715,7 @@ async def get(
         *,
         zone_id: str,
         feature: List[Literal["thresholds", "parameter_schemas", "schema_info"]] | Omit = omit,
+        with_schemas: 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.
         extra_headers: Headers | None = None,
@@ -724,6 +736,10 @@ async def get(
               to the resulting feature object. Have a look at the top-level object description
               for more details on the specific meaning.
 
+          with_schemas: When true, includes OpenAPI schemas (both uploaded and learned) for the
+              operation in the response. Due to the conversion overhead, this parameter is
+              only supported on single-operation retrieval.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -745,7 +761,13 @@ async def get(
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                query=await async_maybe_transform({"feature": feature}, operation_get_params.OperationGetParams),
+                query=await async_maybe_transform(
+                    {
+                        "feature": feature,
+                        "with_schemas": with_schemas,
+                    },
+                    operation_get_params.OperationGetParams,
+                ),
                 post_parser=ResultWrapper[OperationGetResponse]._unwrapper,
             ),
             cast_to=cast(Type[OperationGetResponse], ResultWrapper[OperationGetResponse]),

src/cloudflare/resources/zero_trust/devices/policies/custom/custom.py

@@ -109,6 +109,7 @@ def create(
         support_url: str | Omit = omit,
         switch_locked: bool | Omit = omit,
         tunnel_protocol: str | Omit = omit,
+        virtual_networks: Optional[custom_create_params.VirtualNetworks] | 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.
         extra_headers: Headers | None = None,
@@ -178,6 +179,8 @@ def create(
 
           tunnel_protocol: Determines which tunnel protocol to use.
 
+          virtual_networks: Virtual network access settings for the device.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -214,6 +217,7 @@ def create(
                     "support_url": support_url,
                     "switch_locked": switch_locked,
                     "tunnel_protocol": tunnel_protocol,
+                    "virtual_networks": virtual_networks,
                 },
                 custom_create_params.CustomCreateParams,
             ),
@@ -329,6 +333,7 @@ def edit(
         support_url: str | Omit = omit,
         switch_locked: bool | Omit = omit,
         tunnel_protocol: str | Omit = omit,
+        virtual_networks: Optional[custom_edit_params.VirtualNetworks] | 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.
         extra_headers: Headers | None = None,
@@ -397,6 +402,8 @@ def edit(
 
           tunnel_protocol: Determines which tunnel protocol to use.
 
+          virtual_networks: Virtual network access settings for the device.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -437,6 +444,7 @@ def edit(
                     "support_url": support_url,
                     "switch_locked": switch_locked,
                     "tunnel_protocol": tunnel_protocol,
+                    "virtual_networks": virtual_networks,
                 },
                 custom_edit_params.CustomEditParams,
             ),
@@ -551,6 +559,7 @@ async def create(
         support_url: str | Omit = omit,
         switch_locked: bool | Omit = omit,
         tunnel_protocol: str | Omit = omit,
+        virtual_networks: Optional[custom_create_params.VirtualNetworks] | 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.
         extra_headers: Headers | None = None,
@@ -620,6 +629,8 @@ async def create(
 
           tunnel_protocol: Determines which tunnel protocol to use.
 
+          virtual_networks: Virtual network access settings for the device.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -656,6 +667,7 @@ async def create(
                     "support_url": support_url,
                     "switch_locked": switch_locked,
                     "tunnel_protocol": tunnel_protocol,
+                    "virtual_networks": virtual_networks,
                 },
                 custom_create_params.CustomCreateParams,
             ),
@@ -771,6 +783,7 @@ async def edit(
         support_url: str | Omit = omit,
         switch_locked: bool | Omit = omit,
         tunnel_protocol: str | Omit = omit,
+        virtual_networks: Optional[custom_edit_params.VirtualNetworks] | 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.
         extra_headers: Headers | None = None,
@@ -839,6 +852,8 @@ async def edit(
 
           tunnel_protocol: Determines which tunnel protocol to use.
 
+          virtual_networks: Virtual network access settings for the device.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -879,6 +894,7 @@ async def edit(
                     "support_url": support_url,
                     "switch_locked": switch_locked,
                     "tunnel_protocol": tunnel_protocol,
+                    "virtual_networks": virtual_networks,
                 },
                 custom_edit_params.CustomEditParams,
             ),

src/cloudflare/resources/zero_trust/devices/policies/default/default.py

@@ -116,6 +116,7 @@ def edit(
         support_url: str | Omit = omit,
         switch_locked: bool | Omit = omit,
         tunnel_protocol: str | Omit = omit,
+        virtual_networks: Optional[default_edit_params.VirtualNetworks] | 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.
         extra_headers: Headers | None = None,
@@ -170,6 +171,8 @@ def edit(
 
           tunnel_protocol: Determines which tunnel protocol to use.
 
+          virtual_networks: Virtual network access settings for the device.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -201,6 +204,7 @@ def edit(
                     "support_url": support_url,
                     "switch_locked": switch_locked,
                     "tunnel_protocol": tunnel_protocol,
+                    "virtual_networks": virtual_networks,
                 },
                 default_edit_params.DefaultEditParams,
             ),
@@ -309,6 +313,7 @@ async def edit(
         support_url: str | Omit = omit,
         switch_locked: bool | Omit = omit,
         tunnel_protocol: str | Omit = omit,
+        virtual_networks: Optional[default_edit_params.VirtualNetworks] | 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.
         extra_headers: Headers | None = None,
@@ -363,6 +368,8 @@ async def edit(
 
           tunnel_protocol: Determines which tunnel protocol to use.
 
+          virtual_networks: Virtual network access settings for the device.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -394,6 +401,7 @@ async def edit(
                     "support_url": support_url,
                     "switch_locked": switch_locked,
                     "tunnel_protocol": tunnel_protocol,
+                    "virtual_networks": virtual_networks,
                 },
                 default_edit_params.DefaultEditParams,
             ),

src/cloudflare/types/api_gateway/operation_create_response.py

@@ -1,9 +1,11 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import List, Union, Optional
+from typing import Dict, List, Union, Optional
 from datetime import datetime
 from typing_extensions import Literal, TypeAlias
 
+from pydantic import Field as FieldInfo
+
 from ..._models import BaseModel
 
 __all__ = [
@@ -26,6 +28,9 @@
     "FeaturesAPIShieldOperationFeatureSchemaInfo",
     "FeaturesAPIShieldOperationFeatureSchemaInfoSchemaInfo",
     "FeaturesAPIShieldOperationFeatureSchemaInfoSchemaInfoActiveSchema",
+    "Schemas",
+    "SchemasLearned",
+    "SchemasUploaded",
 ]
 
 
@@ -216,6 +221,50 @@ class FeaturesAPIShieldOperationFeatureSchemaInfo(BaseModel):
 ]
 
 
+class SchemasLearned(BaseModel):
+    """
+    An OpenAPI operation object fragment containing schema information for an operation. May include parameter definitions, request body specifications, and a component schema extension.
+    """
+
+    parameters: Optional[List[Dict[str, object]]] = None
+    """OpenAPI parameter objects describing path, query, header, or cookie parameters."""
+
+    request_body: Optional[Dict[str, object]] = FieldInfo(alias="requestBody", default=None)
+    """OpenAPI request body object describing the expected request payload."""
+
+
+class SchemasUploaded(BaseModel):
+    """
+    An OpenAPI operation object fragment containing schema information for an operation. May include parameter definitions, request body specifications, and a component schema extension.
+    """
+
+    parameters: Optional[List[Dict[str, object]]] = None
+    """OpenAPI parameter objects describing path, query, header, or cookie parameters."""
+
+    request_body: Optional[Dict[str, object]] = FieldInfo(alias="requestBody", default=None)
+    """OpenAPI request body object describing the expected request payload."""
+
+
+class Schemas(BaseModel):
+    """
+    OpenAPI JSON schemas for an operation, including both user-uploaded and Cloudflare-learned schemas.
+    """
+
+    learned: Optional[SchemasLearned] = None
+    """
+    An OpenAPI operation object fragment containing schema information for an
+    operation. May include parameter definitions, request body specifications, and a
+    component schema extension.
+    """
+
+    uploaded: Optional[SchemasUploaded] = None
+    """
+    An OpenAPI operation object fragment containing schema information for an
+    operation. May include parameter definitions, request body specifications, and a
+    component schema extension.
+    """
+
+
 class OperationCreateResponse(BaseModel):
     endpoint: str
     """
@@ -237,3 +286,9 @@ class OperationCreateResponse(BaseModel):
     """UUID."""
 
     features: Optional[Features] = None
+
+    schemas: Optional[Schemas] = None
+    """
+    OpenAPI JSON schemas for an operation, including both user-uploaded and
+    Cloudflare-learned schemas.
+    """

src/cloudflare/types/api_gateway/operation_get_params.py

@@ -19,3 +19,10 @@ class OperationGetParams(TypedDict, total=False):
     Have a look at the top-level object description for more details on the specific
     meaning.
     """
+
+    with_schemas: bool
+    """
+    When true, includes OpenAPI schemas (both uploaded and learned) for the
+    operation in the response. Due to the conversion overhead, this parameter is
+    only supported on single-operation retrieval.
+    """