feat(api): api update

stainless-app[bot] · stainless-app[bot] · commit caeddffdfe57 · 2025-08-27T14:40:56.000Z
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
-configured_endpoints: 1807
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-b4f59cfea0b2c860c73a18dedb59b1db72f7cd3e5af10e0eaba00e86f82825f1.yml
-openapi_spec_hash: 55d9a4a7e10e6cf329fd360b59655098
+configured_endpoints: 1809
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-4290680d78c08aae05658ff30e1e58d1106c9292a66c8dabec7dc5b7f495104a.yml
+openapi_spec_hash: 8ce6ddb5177fb007f75abbfbdb3f0733
 config_hash: 9f61e9f02b675e373b140471d52b670c
diff --git a/api.md b/api.md
@@ -4797,8 +4797,16 @@ Methods:
 
 ## Downloads
 
+Types:
+
+```python
+from cloudflare.types.stream import DownloadDeleteResponse
+```
+
 Methods:
 
+- <code title="post /accounts/{account_id}/stream/{identifier}/downloads">client.stream.downloads.<a href="./src/cloudflare/resources/stream/downloads.py">create</a>(identifier, \*, account_id, \*\*<a href="src/cloudflare/types/stream/download_create_params.py">params</a>) -> object</code>
+- <code title="delete /accounts/{account_id}/stream/{identifier}/downloads">client.stream.downloads.<a href="./src/cloudflare/resources/stream/downloads.py">delete</a>(identifier, \*, account_id) -> <a href="./src/cloudflare/types/stream/download_delete_response.py">str</a></code>
 - <code title="get /accounts/{account_id}/stream/{identifier}/downloads">client.stream.downloads.<a href="./src/cloudflare/resources/stream/downloads.py">get</a>(identifier, \*, account_id) -> object</code>
 
 ## Embed
diff --git a/src/cloudflare/resources/stream/downloads.py b/src/cloudflare/resources/stream/downloads.py
@@ -7,6 +7,7 @@
 import httpx
 
 from ..._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from ..._utils import maybe_transform, async_maybe_transform
 from ..._compat import cached_property
 from ..._resource import SyncAPIResource, AsyncAPIResource
 from ..._response import (
@@ -17,6 +18,8 @@
 )
 from ..._wrappers import ResultWrapper
 from ..._base_client import make_request_options
+from ...types.stream import download_create_params
+from ...types.stream.download_delete_response import DownloadDeleteResponse
 
 __all__ = ["DownloadsResource", "AsyncDownloadsResource"]
 
@@ -41,6 +44,96 @@ def with_streaming_response(self) -> DownloadsResourceWithStreamingResponse:
         """
         return DownloadsResourceWithStreamingResponse(self)
 
+    def create(
+        self,
+        identifier: str,
+        *,
+        account_id: str,
+        body: object,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> object:
+        """
+        Creates a download for a video when a video is ready to view.
+
+        Args:
+          account_id: Identifier.
+
+          identifier: A Cloudflare-generated unique identifier for a media item.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not account_id:
+            raise ValueError(f"Expected a non-empty value for `account_id` but received {account_id!r}")
+        if not identifier:
+            raise ValueError(f"Expected a non-empty value for `identifier` but received {identifier!r}")
+        return self._post(
+            f"/accounts/{account_id}/stream/{identifier}/downloads",
+            body=maybe_transform(body, download_create_params.DownloadCreateParams),
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                post_parser=ResultWrapper[Optional[object]]._unwrapper,
+            ),
+            cast_to=cast(Type[object], ResultWrapper[object]),
+        )
+
+    def delete(
+        self,
+        identifier: str,
+        *,
+        account_id: str,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> str:
+        """
+        Delete the downloads for a video.
+
+        Args:
+          account_id: Identifier.
+
+          identifier: A Cloudflare-generated unique identifier for a media item.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not account_id:
+            raise ValueError(f"Expected a non-empty value for `account_id` but received {account_id!r}")
+        if not identifier:
+            raise ValueError(f"Expected a non-empty value for `identifier` but received {identifier!r}")
+        return self._delete(
+            f"/accounts/{account_id}/stream/{identifier}/downloads",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                post_parser=ResultWrapper[Optional[DownloadDeleteResponse]]._unwrapper,
+            ),
+            cast_to=cast(Type[str], ResultWrapper[str]),
+        )
+
     def get(
         self,
         identifier: str,
@@ -106,6 +199,96 @@ def with_streaming_response(self) -> AsyncDownloadsResourceWithStreamingResponse
         """
         return AsyncDownloadsResourceWithStreamingResponse(self)
 
+    async def create(
+        self,
+        identifier: str,
+        *,
+        account_id: str,
+        body: object,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> object:
+        """
+        Creates a download for a video when a video is ready to view.
+
+        Args:
+          account_id: Identifier.
+
+          identifier: A Cloudflare-generated unique identifier for a media item.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not account_id:
+            raise ValueError(f"Expected a non-empty value for `account_id` but received {account_id!r}")
+        if not identifier:
+            raise ValueError(f"Expected a non-empty value for `identifier` but received {identifier!r}")
+        return await self._post(
+            f"/accounts/{account_id}/stream/{identifier}/downloads",
+            body=await async_maybe_transform(body, download_create_params.DownloadCreateParams),
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                post_parser=ResultWrapper[Optional[object]]._unwrapper,
+            ),
+            cast_to=cast(Type[object], ResultWrapper[object]),
+        )
+
+    async def delete(
+        self,
+        identifier: str,
+        *,
+        account_id: str,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> str:
+        """
+        Delete the downloads for a video.
+
+        Args:
+          account_id: Identifier.
+
+          identifier: A Cloudflare-generated unique identifier for a media item.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not account_id:
+            raise ValueError(f"Expected a non-empty value for `account_id` but received {account_id!r}")
+        if not identifier:
+            raise ValueError(f"Expected a non-empty value for `identifier` but received {identifier!r}")
+        return await self._delete(
+            f"/accounts/{account_id}/stream/{identifier}/downloads",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                post_parser=ResultWrapper[Optional[DownloadDeleteResponse]]._unwrapper,
+            ),
+            cast_to=cast(Type[str], ResultWrapper[str]),
+        )
+
     async def get(
         self,
         identifier: str,
@@ -155,6 +338,12 @@ class DownloadsResourceWithRawResponse:
     def __init__(self, downloads: DownloadsResource) -> None:
         self._downloads = downloads
 
+        self.create = to_raw_response_wrapper(
+            downloads.create,
+        )
+        self.delete = to_raw_response_wrapper(
+            downloads.delete,
+        )
         self.get = to_raw_response_wrapper(
             downloads.get,
         )
@@ -164,6 +353,12 @@ class AsyncDownloadsResourceWithRawResponse:
     def __init__(self, downloads: AsyncDownloadsResource) -> None:
         self._downloads = downloads
 
+        self.create = async_to_raw_response_wrapper(
+            downloads.create,
+        )
+        self.delete = async_to_raw_response_wrapper(
+            downloads.delete,
+        )
         self.get = async_to_raw_response_wrapper(
             downloads.get,
         )
@@ -173,6 +368,12 @@ class DownloadsResourceWithStreamingResponse:
     def __init__(self, downloads: DownloadsResource) -> None:
         self._downloads = downloads
 
+        self.create = to_streamed_response_wrapper(
+            downloads.create,
+        )
+        self.delete = to_streamed_response_wrapper(
+            downloads.delete,
+        )
         self.get = to_streamed_response_wrapper(
             downloads.get,
         )
@@ -182,6 +383,12 @@ class AsyncDownloadsResourceWithStreamingResponse:
     def __init__(self, downloads: AsyncDownloadsResource) -> None:
         self._downloads = downloads
 
+        self.create = async_to_streamed_response_wrapper(
+            downloads.create,
+        )
+        self.delete = async_to_streamed_response_wrapper(
+            downloads.delete,
+        )
         self.get = async_to_streamed_response_wrapper(
             downloads.get,
         )
diff --git a/src/cloudflare/types/stream/__init__.py b/src/cloudflare/types/stream/__init__.py
@@ -22,11 +22,13 @@
 from .stream_create_params import StreamCreateParams as StreamCreateParams
 from .token_create_response import TokenCreateResponse as TokenCreateResponse
 from .webhook_update_params import WebhookUpdateParams as WebhookUpdateParams
+from .download_create_params import DownloadCreateParams as DownloadCreateParams
 from .live_input_list_params import LiveInputListParams as LiveInputListParams
 from .audio_track_copy_params import AudioTrackCopyParams as AudioTrackCopyParams
 from .audio_track_edit_params import AudioTrackEditParams as AudioTrackEditParams
 from .watermark_create_params import WatermarkCreateParams as WatermarkCreateParams
 from .webhook_delete_response import WebhookDeleteResponse as WebhookDeleteResponse
+from .download_delete_response import DownloadDeleteResponse as DownloadDeleteResponse
 from .live_input_create_params import LiveInputCreateParams as LiveInputCreateParams
 from .live_input_list_response import LiveInputListResponse as LiveInputListResponse
 from .live_input_update_params import LiveInputUpdateParams as LiveInputUpdateParams
diff --git a/src/cloudflare/types/stream/download_create_params.py b/src/cloudflare/types/stream/download_create_params.py
@@ -0,0 +1,14 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["DownloadCreateParams"]
+
+
+class DownloadCreateParams(TypedDict, total=False):
+    account_id: Required[str]
+    """Identifier."""
+
+    body: Required[object]
diff --git a/src/cloudflare/types/stream/download_delete_response.py b/src/cloudflare/types/stream/download_delete_response.py
@@ -0,0 +1,7 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import TypeAlias
+
+__all__ = ["DownloadDeleteResponse"]
+
+DownloadDeleteResponse: TypeAlias = str
diff --git a/tests/api_resources/stream/test_downloads.py b/tests/api_resources/stream/test_downloads.py
