feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 1773
+configured_endpoints: 1775
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-1ef60e0a6e6ea360f4ec097f02a529dfc8dd8d2d5e84bd506bed4836463090ff.yml
 openapi_spec_hash: 79fb2f57dc2bbdd283d4238878994551
-config_hash: bafeb7666d2b7868c9d4ab8f0cc686e1
+config_hash: 4a37da9893560914a7ac1a75cc01202a

api.md

@@ -2389,13 +2389,20 @@ Methods:
 Types:
 
 ```python
-from cloudflare.types.workers.scripts import DeploymentCreateResponse, DeploymentGetResponse
+from cloudflare.types.workers.scripts import (
+    DeploymentCreateResponse,
+    DeploymentListResponse,
+    DeploymentDeleteResponse,
+    DeploymentGetResponse,
+)
 ```
 
 Methods:
 
 - <code title="post /accounts/{account_id}/workers/scripts/{script_name}/deployments">client.workers.scripts.deployments.<a href="./src/cloudflare/resources/workers/scripts/deployments.py">create</a>(script_name, \*, account_id, \*\*<a href="src/cloudflare/types/workers/scripts/deployment_create_params.py">params</a>) -> <a href="./src/cloudflare/types/workers/scripts/deployment_create_response.py">DeploymentCreateResponse</a></code>
-- <code title="get /accounts/{account_id}/workers/scripts/{script_name}/deployments">client.workers.scripts.deployments.<a href="./src/cloudflare/resources/workers/scripts/deployments.py">get</a>(script_name, \*, account_id) -> <a href="./src/cloudflare/types/workers/scripts/deployment_get_response.py">DeploymentGetResponse</a></code>
+- <code title="get /accounts/{account_id}/workers/scripts/{script_name}/deployments">client.workers.scripts.deployments.<a href="./src/cloudflare/resources/workers/scripts/deployments.py">list</a>(script_name, \*, account_id) -> <a href="./src/cloudflare/types/workers/scripts/deployment_list_response.py">DeploymentListResponse</a></code>
+- <code title="delete /accounts/{account_id}/workers/scripts/{script_name}/deployments/{deployment_id}">client.workers.scripts.deployments.<a href="./src/cloudflare/resources/workers/scripts/deployments.py">delete</a>(deployment_id, \*, account_id, script_name) -> <a href="./src/cloudflare/types/workers/scripts/deployment_delete_response.py">DeploymentDeleteResponse</a></code>
+- <code title="get /accounts/{account_id}/workers/scripts/{script_name}/deployments/{deployment_id}">client.workers.scripts.deployments.<a href="./src/cloudflare/resources/workers/scripts/deployments.py">get</a>(deployment_id, \*, account_id, script_name) -> <a href="./src/cloudflare/types/workers/scripts/deployment_get_response.py">DeploymentGetResponse</a></code>
 
 ### Versions
 

src/cloudflare/resources/workers/scripts/deployments.py

@@ -21,7 +21,9 @@
 from ...._base_client import make_request_options
 from ....types.workers.scripts import deployment_create_params
 from ....types.workers.scripts.deployment_get_response import DeploymentGetResponse
+from ....types.workers.scripts.deployment_list_response import DeploymentListResponse
 from ....types.workers.scripts.deployment_create_response import DeploymentCreateResponse
+from ....types.workers.scripts.deployment_delete_response import DeploymentDeleteResponse
 
 __all__ = ["DeploymentsResource", "AsyncDeploymentsResource"]
 
@@ -109,7 +111,7 @@ def create(
             cast_to=cast(Type[DeploymentCreateResponse], ResultWrapper[DeploymentCreateResponse]),
         )
 
-    def get(
+    def list(
         self,
         script_name: str,
         *,
@@ -120,7 +122,7 @@ def get(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> DeploymentGetResponse:
+    ) -> DeploymentListResponse:
         """List of Worker Deployments.
 
         The first deployment in the list is the latest
@@ -145,6 +147,98 @@ def get(
             raise ValueError(f"Expected a non-empty value for `script_name` but received {script_name!r}")
         return self._get(
             f"/accounts/{account_id}/workers/scripts/{script_name}/deployments",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                post_parser=ResultWrapper[DeploymentListResponse]._unwrapper,
+            ),
+            cast_to=cast(Type[DeploymentListResponse], ResultWrapper[DeploymentListResponse]),
+        )
+
+    def delete(
+        self,
+        deployment_id: str,
+        *,
+        account_id: str,
+        script_name: 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,
+    ) -> DeploymentDeleteResponse:
+        """Delete a Worker Deployment.
+
+        The latest deployment, which is actively serving
+        traffic, cannot be deleted. All other deployments can be deleted.
+
+        Args:
+          account_id: Identifier.
+
+          script_name: Name of the script, used in URLs and route configuration.
+
+          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 script_name:
+            raise ValueError(f"Expected a non-empty value for `script_name` but received {script_name!r}")
+        if not deployment_id:
+            raise ValueError(f"Expected a non-empty value for `deployment_id` but received {deployment_id!r}")
+        return self._delete(
+            f"/accounts/{account_id}/workers/scripts/{script_name}/deployments/{deployment_id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=DeploymentDeleteResponse,
+        )
+
+    def get(
+        self,
+        deployment_id: str,
+        *,
+        account_id: str,
+        script_name: 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,
+    ) -> DeploymentGetResponse:
+        """
+        Get information about a Worker Deployment.
+
+        Args:
+          account_id: Identifier.
+
+          script_name: Name of the script, used in URLs and route configuration.
+
+          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 script_name:
+            raise ValueError(f"Expected a non-empty value for `script_name` but received {script_name!r}")
+        if not deployment_id:
+            raise ValueError(f"Expected a non-empty value for `deployment_id` but received {deployment_id!r}")
+        return self._get(
+            f"/accounts/{account_id}/workers/scripts/{script_name}/deployments/{deployment_id}",
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -239,7 +333,7 @@ async def create(
             cast_to=cast(Type[DeploymentCreateResponse], ResultWrapper[DeploymentCreateResponse]),
         )
 
-    async def get(
+    async def list(
         self,
         script_name: str,
         *,
@@ -250,7 +344,7 @@ async def get(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> DeploymentGetResponse:
+    ) -> DeploymentListResponse:
         """List of Worker Deployments.
 
         The first deployment in the list is the latest
@@ -275,6 +369,98 @@ async def get(
             raise ValueError(f"Expected a non-empty value for `script_name` but received {script_name!r}")
         return await self._get(
             f"/accounts/{account_id}/workers/scripts/{script_name}/deployments",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                post_parser=ResultWrapper[DeploymentListResponse]._unwrapper,
+            ),
+            cast_to=cast(Type[DeploymentListResponse], ResultWrapper[DeploymentListResponse]),
+        )
+
+    async def delete(
+        self,
+        deployment_id: str,
+        *,
+        account_id: str,
+        script_name: 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,
+    ) -> DeploymentDeleteResponse:
+        """Delete a Worker Deployment.
+
+        The latest deployment, which is actively serving
+        traffic, cannot be deleted. All other deployments can be deleted.
+
+        Args:
+          account_id: Identifier.
+
+          script_name: Name of the script, used in URLs and route configuration.
+
+          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 script_name:
+            raise ValueError(f"Expected a non-empty value for `script_name` but received {script_name!r}")
+        if not deployment_id:
+            raise ValueError(f"Expected a non-empty value for `deployment_id` but received {deployment_id!r}")
+        return await self._delete(
+            f"/accounts/{account_id}/workers/scripts/{script_name}/deployments/{deployment_id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=DeploymentDeleteResponse,
+        )
+
+    async def get(
+        self,
+        deployment_id: str,
+        *,
+        account_id: str,
+        script_name: 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,
+    ) -> DeploymentGetResponse:
+        """
+        Get information about a Worker Deployment.
+
+        Args:
+          account_id: Identifier.
+
+          script_name: Name of the script, used in URLs and route configuration.
+
+          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 script_name:
+            raise ValueError(f"Expected a non-empty value for `script_name` but received {script_name!r}")
+        if not deployment_id:
+            raise ValueError(f"Expected a non-empty value for `deployment_id` but received {deployment_id!r}")
+        return await self._get(
+            f"/accounts/{account_id}/workers/scripts/{script_name}/deployments/{deployment_id}",
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -293,6 +479,12 @@ def __init__(self, deployments: DeploymentsResource) -> None:
         self.create = to_raw_response_wrapper(
             deployments.create,
         )
+        self.list = to_raw_response_wrapper(
+            deployments.list,
+        )
+        self.delete = to_raw_response_wrapper(
+            deployments.delete,
+        )
         self.get = to_raw_response_wrapper(
             deployments.get,
         )
@@ -305,6 +497,12 @@ def __init__(self, deployments: AsyncDeploymentsResource) -> None:
         self.create = async_to_raw_response_wrapper(
             deployments.create,
         )
+        self.list = async_to_raw_response_wrapper(
+            deployments.list,
+        )
+        self.delete = async_to_raw_response_wrapper(
+            deployments.delete,
+        )
         self.get = async_to_raw_response_wrapper(
             deployments.get,
         )
@@ -317,6 +515,12 @@ def __init__(self, deployments: DeploymentsResource) -> None:
         self.create = to_streamed_response_wrapper(
             deployments.create,
         )
+        self.list = to_streamed_response_wrapper(
+            deployments.list,
+        )
+        self.delete = to_streamed_response_wrapper(
+            deployments.delete,
+        )
         self.get = to_streamed_response_wrapper(
             deployments.get,
         )
@@ -329,6 +533,12 @@ def __init__(self, deployments: AsyncDeploymentsResource) -> None:
         self.create = async_to_streamed_response_wrapper(
             deployments.create,
         )
+        self.list = async_to_streamed_response_wrapper(
+            deployments.list,
+        )
+        self.delete = async_to_streamed_response_wrapper(
+            deployments.delete,
+        )
         self.get = async_to_streamed_response_wrapper(
             deployments.get,
         )

src/cloudflare/types/workers/scripts/__init__.py

@@ -25,10 +25,12 @@
 from .subdomain_create_params import SubdomainCreateParams as SubdomainCreateParams
 from .version_create_response import VersionCreateResponse as VersionCreateResponse
 from .deployment_create_params import DeploymentCreateParams as DeploymentCreateParams
+from .deployment_list_response import DeploymentListResponse as DeploymentListResponse
 from .schedule_update_response import ScheduleUpdateResponse as ScheduleUpdateResponse
 from .subdomain_create_response import SubdomainCreateResponse as SubdomainCreateResponse
 from .subdomain_delete_response import SubdomainDeleteResponse as SubdomainDeleteResponse
 from .deployment_create_response import DeploymentCreateResponse as DeploymentCreateResponse
+from .deployment_delete_response import DeploymentDeleteResponse as DeploymentDeleteResponse
 from .script_and_version_setting_edit_params import (
     ScriptAndVersionSettingEditParams as ScriptAndVersionSettingEditParams,
 )

src/cloudflare/types/workers/scripts/deployment_delete_response.py

@@ -0,0 +1,45 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from typing_extensions import Literal
+
+from ...._models import BaseModel
+
+__all__ = ["DeploymentDeleteResponse", "Error", "ErrorSource", "Message", "MessageSource"]
+
+
+class ErrorSource(BaseModel):
+    pointer: Optional[str] = None
+
+
+class Error(BaseModel):
+    code: int
+
+    message: str
+
+    documentation_url: Optional[str] = None
+
+    source: Optional[ErrorSource] = None
+
+
+class MessageSource(BaseModel):
+    pointer: Optional[str] = None
+
+
+class Message(BaseModel):
+    code: int
+
+    message: str
+
+    documentation_url: Optional[str] = None
+
+    source: Optional[MessageSource] = None
+
+
+class DeploymentDeleteResponse(BaseModel):
+    errors: List[Error]
+
+    messages: List[Message]
+
+    success: Literal[True]
+    """Whether the API call was successful."""