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

cloudflare · Oct 11, 2024 · 71587b0 · 71587b0
1 parent c5437db
commit 71587b0
Show file tree

Hide file tree

Showing 87 changed files with 518 additions and 676 deletions.
diff --git a/.stats.yml b/.stats.yml
@@ -1,2 +1,2 @@
 configured_endpoints: 1354
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-39295350486047cfc0c3c564fbab8fe2b70b669a1606489a18ba8fb166208a0b.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-eddf94a9b5ab27797b25f462c4eda2a682660f72521fb72713935c4d966a1a71.yml
diff --git a/api.md b/api.md
diff --git a/src/cloudflare/resources/argo/tiered_caching.py b/src/cloudflare/resources/argo/tiered_caching.py
@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Type, cast
+from typing import Type, Optional, cast
 from typing_extensions import Literal
 
 import httpx
@@ -60,7 +60,7 @@ def edit(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> TieredCachingEditResponse:
+    ) -> Optional[TieredCachingEditResponse]:
         """
         Updates enablement of Tiered Caching
 
@@ -87,9 +87,9 @@ def edit(
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                post_parser=ResultWrapper[TieredCachingEditResponse]._unwrapper,
+                post_parser=ResultWrapper[Optional[TieredCachingEditResponse]]._unwrapper,
             ),
-            cast_to=cast(Type[TieredCachingEditResponse], ResultWrapper[TieredCachingEditResponse]),
+            cast_to=cast(Type[Optional[TieredCachingEditResponse]], ResultWrapper[TieredCachingEditResponse]),
         )
 
     def get(
@@ -102,7 +102,7 @@ def get(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> TieredCachingGetResponse:
+    ) -> Optional[TieredCachingGetResponse]:
         """
         Get Tiered Caching setting
 
@@ -126,9 +126,9 @@ def get(
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                post_parser=ResultWrapper[TieredCachingGetResponse]._unwrapper,
+                post_parser=ResultWrapper[Optional[TieredCachingGetResponse]]._unwrapper,
             ),
-            cast_to=cast(Type[TieredCachingGetResponse], ResultWrapper[TieredCachingGetResponse]),
+            cast_to=cast(Type[Optional[TieredCachingGetResponse]], ResultWrapper[TieredCachingGetResponse]),
         )
 
 
@@ -163,7 +163,7 @@ async def edit(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> TieredCachingEditResponse:
+    ) -> Optional[TieredCachingEditResponse]:
         """
         Updates enablement of Tiered Caching
 
@@ -190,9 +190,9 @@ async def edit(
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                post_parser=ResultWrapper[TieredCachingEditResponse]._unwrapper,
+                post_parser=ResultWrapper[Optional[TieredCachingEditResponse]]._unwrapper,
             ),
-            cast_to=cast(Type[TieredCachingEditResponse], ResultWrapper[TieredCachingEditResponse]),
+            cast_to=cast(Type[Optional[TieredCachingEditResponse]], ResultWrapper[TieredCachingEditResponse]),
         )
 
     async def get(
@@ -205,7 +205,7 @@ async def get(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> TieredCachingGetResponse:
+    ) -> Optional[TieredCachingGetResponse]:
         """
         Get Tiered Caching setting
 
@@ -229,9 +229,9 @@ async def get(
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                post_parser=ResultWrapper[TieredCachingGetResponse]._unwrapper,
+                post_parser=ResultWrapper[Optional[TieredCachingGetResponse]]._unwrapper,
             ),
-            cast_to=cast(Type[TieredCachingGetResponse], ResultWrapper[TieredCachingGetResponse]),
+            cast_to=cast(Type[Optional[TieredCachingGetResponse]], ResultWrapper[TieredCachingGetResponse]),
         )
 
 

diff --git a/src/cloudflare/resources/cache/cache_reserve.py b/src/cloudflare/resources/cache/cache_reserve.py
@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Type, cast
+from typing import Type, Optional, cast
 from typing_extensions import Literal
 
 import httpx
@@ -62,7 +62,7 @@ def clear(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> CacheReserveClearResponse:
+    ) -> Optional[CacheReserveClearResponse]:
         """
         You can use Cache Reserve Clear to clear your Cache Reserve, but you must first
         disable Cache Reserve. In most cases, this will be accomplished within 24 hours.
@@ -90,9 +90,9 @@ def clear(
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                post_parser=ResultWrapper[CacheReserveClearResponse]._unwrapper,
+                post_parser=ResultWrapper[Optional[CacheReserveClearResponse]]._unwrapper,
             ),
-            cast_to=cast(Type[CacheReserveClearResponse], ResultWrapper[CacheReserveClearResponse]),
+            cast_to=cast(Type[Optional[CacheReserveClearResponse]], ResultWrapper[CacheReserveClearResponse]),
         )
 
     def edit(
@@ -106,7 +106,7 @@ def edit(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> CacheReserveEditResponse:
+    ) -> Optional[CacheReserveEditResponse]:
         """
         Increase cache lifetimes by automatically storing all cacheable files into
         Cloudflare's persistent object storage buckets. Requires Cache Reserve
@@ -138,9 +138,9 @@ def edit(
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                post_parser=ResultWrapper[CacheReserveEditResponse]._unwrapper,
+                post_parser=ResultWrapper[Optional[CacheReserveEditResponse]]._unwrapper,
             ),
-            cast_to=cast(Type[CacheReserveEditResponse], ResultWrapper[CacheReserveEditResponse]),
+            cast_to=cast(Type[Optional[CacheReserveEditResponse]], ResultWrapper[CacheReserveEditResponse]),
         )
 
     def get(
@@ -153,7 +153,7 @@ def get(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> CacheReserveGetResponse:
+    ) -> Optional[CacheReserveGetResponse]:
         """
         Increase cache lifetimes by automatically storing all cacheable files into
         Cloudflare's persistent object storage buckets. Requires Cache Reserve
@@ -182,9 +182,9 @@ def get(
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                post_parser=ResultWrapper[CacheReserveGetResponse]._unwrapper,
+                post_parser=ResultWrapper[Optional[CacheReserveGetResponse]]._unwrapper,
             ),
-            cast_to=cast(Type[CacheReserveGetResponse], ResultWrapper[CacheReserveGetResponse]),
+            cast_to=cast(Type[Optional[CacheReserveGetResponse]], ResultWrapper[CacheReserveGetResponse]),
         )
 
     def status(
@@ -197,7 +197,7 @@ def status(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> CacheReserveStatusResponse:
+    ) -> Optional[CacheReserveStatusResponse]:
         """
         You can use Cache Reserve Clear to clear your Cache Reserve, but you must first
         disable Cache Reserve. In most cases, this will be accomplished within 24 hours.
@@ -224,9 +224,9 @@ def status(
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                post_parser=ResultWrapper[CacheReserveStatusResponse]._unwrapper,
+                post_parser=ResultWrapper[Optional[CacheReserveStatusResponse]]._unwrapper,
             ),
-            cast_to=cast(Type[CacheReserveStatusResponse], ResultWrapper[CacheReserveStatusResponse]),
+            cast_to=cast(Type[Optional[CacheReserveStatusResponse]], ResultWrapper[CacheReserveStatusResponse]),
         )
 
 
@@ -261,7 +261,7 @@ async def clear(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> CacheReserveClearResponse:
+    ) -> Optional[CacheReserveClearResponse]:
         """
         You can use Cache Reserve Clear to clear your Cache Reserve, but you must first
         disable Cache Reserve. In most cases, this will be accomplished within 24 hours.
@@ -289,9 +289,9 @@ async def clear(
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                post_parser=ResultWrapper[CacheReserveClearResponse]._unwrapper,
+                post_parser=ResultWrapper[Optional[CacheReserveClearResponse]]._unwrapper,
             ),
-            cast_to=cast(Type[CacheReserveClearResponse], ResultWrapper[CacheReserveClearResponse]),
+            cast_to=cast(Type[Optional[CacheReserveClearResponse]], ResultWrapper[CacheReserveClearResponse]),
         )
 
     async def edit(
@@ -305,7 +305,7 @@ async def edit(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> CacheReserveEditResponse:
+    ) -> Optional[CacheReserveEditResponse]:
         """
         Increase cache lifetimes by automatically storing all cacheable files into
         Cloudflare's persistent object storage buckets. Requires Cache Reserve
@@ -337,9 +337,9 @@ async def edit(
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                post_parser=ResultWrapper[CacheReserveEditResponse]._unwrapper,
+                post_parser=ResultWrapper[Optional[CacheReserveEditResponse]]._unwrapper,
             ),
-            cast_to=cast(Type[CacheReserveEditResponse], ResultWrapper[CacheReserveEditResponse]),
+            cast_to=cast(Type[Optional[CacheReserveEditResponse]], ResultWrapper[CacheReserveEditResponse]),
         )
 
     async def get(
@@ -352,7 +352,7 @@ async def get(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> CacheReserveGetResponse:
+    ) -> Optional[CacheReserveGetResponse]:
         """
         Increase cache lifetimes by automatically storing all cacheable files into
         Cloudflare's persistent object storage buckets. Requires Cache Reserve
@@ -381,9 +381,9 @@ async def get(
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                post_parser=ResultWrapper[CacheReserveGetResponse]._unwrapper,
+                post_parser=ResultWrapper[Optional[CacheReserveGetResponse]]._unwrapper,
             ),
-            cast_to=cast(Type[CacheReserveGetResponse], ResultWrapper[CacheReserveGetResponse]),
+            cast_to=cast(Type[Optional[CacheReserveGetResponse]], ResultWrapper[CacheReserveGetResponse]),
         )
 
     async def status(
@@ -396,7 +396,7 @@ async def status(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> CacheReserveStatusResponse:
+    ) -> Optional[CacheReserveStatusResponse]:
         """
         You can use Cache Reserve Clear to clear your Cache Reserve, but you must first
         disable Cache Reserve. In most cases, this will be accomplished within 24 hours.
@@ -423,9 +423,9 @@ async def status(
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                post_parser=ResultWrapper[CacheReserveStatusResponse]._unwrapper,
+                post_parser=ResultWrapper[Optional[CacheReserveStatusResponse]]._unwrapper,
             ),
-            cast_to=cast(Type[CacheReserveStatusResponse], ResultWrapper[CacheReserveStatusResponse]),
+            cast_to=cast(Type[Optional[CacheReserveStatusResponse]], ResultWrapper[CacheReserveStatusResponse]),
         )
 
 

diff --git a/src/cloudflare/resources/cache/regional_tiered_cache.py b/src/cloudflare/resources/cache/regional_tiered_cache.py
@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Type, cast
+from typing import Type, Optional, cast
 from typing_extensions import Literal
 
 import httpx
@@ -60,7 +60,7 @@ def edit(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> RegionalTieredCacheEditResponse:
+    ) -> Optional[RegionalTieredCacheEditResponse]:
         """
         Instructs Cloudflare to check a regional hub data center on the way to your
         upper tier. This can help improve performance for smart and custom tiered cache
@@ -89,9 +89,11 @@ def edit(
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                post_parser=ResultWrapper[RegionalTieredCacheEditResponse]._unwrapper,
+                post_parser=ResultWrapper[Optional[RegionalTieredCacheEditResponse]]._unwrapper,
+            ),
+            cast_to=cast(
+                Type[Optional[RegionalTieredCacheEditResponse]], ResultWrapper[RegionalTieredCacheEditResponse]
             ),
-            cast_to=cast(Type[RegionalTieredCacheEditResponse], ResultWrapper[RegionalTieredCacheEditResponse]),
         )
 
     def get(
@@ -104,7 +106,7 @@ def get(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> RegionalTieredCacheGetResponse:
+    ) -> Optional[RegionalTieredCacheGetResponse]:
         """
         Instructs Cloudflare to check a regional hub data center on the way to your
         upper tier. This can help improve performance for smart and custom tiered cache
@@ -130,9 +132,9 @@ def get(
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                post_parser=ResultWrapper[RegionalTieredCacheGetResponse]._unwrapper,
+                post_parser=ResultWrapper[Optional[RegionalTieredCacheGetResponse]]._unwrapper,
             ),
-            cast_to=cast(Type[RegionalTieredCacheGetResponse], ResultWrapper[RegionalTieredCacheGetResponse]),
+            cast_to=cast(Type[Optional[RegionalTieredCacheGetResponse]], ResultWrapper[RegionalTieredCacheGetResponse]),
         )
 
 
@@ -167,7 +169,7 @@ async def edit(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> RegionalTieredCacheEditResponse:
+    ) -> Optional[RegionalTieredCacheEditResponse]:
         """
         Instructs Cloudflare to check a regional hub data center on the way to your
         upper tier. This can help improve performance for smart and custom tiered cache
@@ -198,9 +200,11 @@ async def edit(
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                post_parser=ResultWrapper[RegionalTieredCacheEditResponse]._unwrapper,
+                post_parser=ResultWrapper[Optional[RegionalTieredCacheEditResponse]]._unwrapper,
+            ),
+            cast_to=cast(
+                Type[Optional[RegionalTieredCacheEditResponse]], ResultWrapper[RegionalTieredCacheEditResponse]
             ),
-            cast_to=cast(Type[RegionalTieredCacheEditResponse], ResultWrapper[RegionalTieredCacheEditResponse]),
         )
 
     async def get(
@@ -213,7 +217,7 @@ async def get(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> RegionalTieredCacheGetResponse:
+    ) -> Optional[RegionalTieredCacheGetResponse]:
         """
         Instructs Cloudflare to check a regional hub data center on the way to your
         upper tier. This can help improve performance for smart and custom tiered cache
@@ -239,9 +243,9 @@ async def get(
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                post_parser=ResultWrapper[RegionalTieredCacheGetResponse]._unwrapper,
+                post_parser=ResultWrapper[Optional[RegionalTieredCacheGetResponse]]._unwrapper,
             ),
-            cast_to=cast(Type[RegionalTieredCacheGetResponse], ResultWrapper[RegionalTieredCacheGetResponse]),
+            cast_to=cast(Type[Optional[RegionalTieredCacheGetResponse]], ResultWrapper[RegionalTieredCacheGetResponse]),
         )