feat: Add DELETE /deployments/{id} API endpoint

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 100
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-a0f1d08e6f62a74de2aac5c25e592494abdd59f2cfca2842c5810927554faee0.yml
-openapi_spec_hash: ebd8bf67b7bb371cf4b4fa68b967cab5
-config_hash: 27c0ea01aeb797a1767af139851c5b66
+configured_endpoints: 101
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-bbc3dbdd0410eb315cfaeb21aad9f85e4a7f92ac55526ebb702a8bee343c2ab7.yml
+openapi_spec_hash: 60a5134c45a8f3a217e128d4e3335cae
+config_hash: 147340811dd6fbb9c2d80515a7e31f9a

api.md

@@ -33,6 +33,7 @@ Methods:
 - <code title="post /deployments">client.deployments.<a href="./src/kernel/resources/deployments.py">create</a>(\*\*<a href="src/kernel/types/deployment_create_params.py">params</a>) -> <a href="./src/kernel/types/deployment_create_response.py">DeploymentCreateResponse</a></code>
 - <code title="get /deployments/{id}">client.deployments.<a href="./src/kernel/resources/deployments.py">retrieve</a>(id) -> <a href="./src/kernel/types/deployment_retrieve_response.py">DeploymentRetrieveResponse</a></code>
 - <code title="get /deployments">client.deployments.<a href="./src/kernel/resources/deployments.py">list</a>(\*\*<a href="src/kernel/types/deployment_list_params.py">params</a>) -> <a href="./src/kernel/types/deployment_list_response.py">SyncOffsetPagination[DeploymentListResponse]</a></code>
+- <code title="delete /deployments/{id}">client.deployments.<a href="./src/kernel/resources/deployments.py">delete</a>(id) -> None</code>
 - <code title="get /deployments/{id}/events">client.deployments.<a href="./src/kernel/resources/deployments.py">follow</a>(id, \*\*<a href="src/kernel/types/deployment_follow_params.py">params</a>) -> <a href="./src/kernel/types/deployment_follow_response.py">DeploymentFollowResponse</a></code>
 
 # Apps

src/kernel/resources/deployments.py

@@ -8,7 +8,7 @@
 import httpx
 
 from ..types import deployment_list_params, deployment_create_params, deployment_follow_params
-from .._types import Body, Omit, Query, Headers, NotGiven, FileTypes, omit, not_given
+from .._types import Body, Omit, Query, Headers, NoneType, NotGiven, FileTypes, omit, not_given
 from .._utils import extract_files, maybe_transform, deepcopy_minimal, async_maybe_transform
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
@@ -204,6 +204,42 @@ def list(
             model=DeploymentListResponse,
         )
 
+    def delete(
+        self,
+        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,
+    ) -> None:
+        """Stops a running deployment and marks it for deletion.
+
+        If the deployment is
+        already in a terminal state (stopped or failed), returns immediately.
+
+        Args:
+          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 id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return self._delete(
+            f"/deployments/{id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
     def follow(
         self,
         id: str,
@@ -427,6 +463,42 @@ def list(
             model=DeploymentListResponse,
         )
 
+    async def delete(
+        self,
+        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,
+    ) -> None:
+        """Stops a running deployment and marks it for deletion.
+
+        If the deployment is
+        already in a terminal state (stopped or failed), returns immediately.
+
+        Args:
+          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 id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return await self._delete(
+            f"/deployments/{id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
     async def follow(
         self,
         id: str,
@@ -488,6 +560,9 @@ def __init__(self, deployments: DeploymentsResource) -> None:
         self.list = to_raw_response_wrapper(
             deployments.list,
         )
+        self.delete = to_raw_response_wrapper(
+            deployments.delete,
+        )
         self.follow = to_raw_response_wrapper(
             deployments.follow,
         )
@@ -506,6 +581,9 @@ def __init__(self, deployments: AsyncDeploymentsResource) -> None:
         self.list = async_to_raw_response_wrapper(
             deployments.list,
         )
+        self.delete = async_to_raw_response_wrapper(
+            deployments.delete,
+        )
         self.follow = async_to_raw_response_wrapper(
             deployments.follow,
         )
@@ -524,6 +602,9 @@ def __init__(self, deployments: DeploymentsResource) -> None:
         self.list = to_streamed_response_wrapper(
             deployments.list,
         )
+        self.delete = to_streamed_response_wrapper(
+            deployments.delete,
+        )
         self.follow = to_streamed_response_wrapper(
             deployments.follow,
         )
@@ -542,6 +623,9 @@ def __init__(self, deployments: AsyncDeploymentsResource) -> None:
         self.list = async_to_streamed_response_wrapper(
             deployments.list,
         )
+        self.delete = async_to_streamed_response_wrapper(
+            deployments.delete,
+        )
         self.follow = async_to_streamed_response_wrapper(
             deployments.follow,
         )

tests/api_resources/test_deployments.py

@@ -154,6 +154,48 @@ def test_streaming_response_list(self, client: Kernel) -> None:
 
         assert cast(Any, response.is_closed) is True
 
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    def test_method_delete(self, client: Kernel) -> None:
+        deployment = client.deployments.delete(
+            "id",
+        )
+        assert deployment is None
+
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    def test_raw_response_delete(self, client: Kernel) -> None:
+        response = client.deployments.with_raw_response.delete(
+            "id",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        deployment = response.parse()
+        assert deployment is None
+
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    def test_streaming_response_delete(self, client: Kernel) -> None:
+        with client.deployments.with_streaming_response.delete(
+            "id",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            deployment = response.parse()
+            assert deployment is None
+
+        assert cast(Any, response.is_closed) is True
+
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    def test_path_params_delete(self, client: Kernel) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `id` but received ''"):
+            client.deployments.with_raw_response.delete(
+                "",
+            )
+
     @pytest.mark.skip(reason="Mock server tests are disabled")
     @parametrize
     def test_method_follow(self, client: Kernel) -> None:
@@ -342,6 +384,48 @@ async def test_streaming_response_list(self, async_client: AsyncKernel) -> None:
 
         assert cast(Any, response.is_closed) is True
 
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    async def test_method_delete(self, async_client: AsyncKernel) -> None:
+        deployment = await async_client.deployments.delete(
+            "id",
+        )
+        assert deployment is None
+
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    async def test_raw_response_delete(self, async_client: AsyncKernel) -> None:
+        response = await async_client.deployments.with_raw_response.delete(
+            "id",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        deployment = await response.parse()
+        assert deployment is None
+
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    async def test_streaming_response_delete(self, async_client: AsyncKernel) -> None:
+        async with async_client.deployments.with_streaming_response.delete(
+            "id",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            deployment = await response.parse()
+            assert deployment is None
+
+        assert cast(Any, response.is_closed) is True
+
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    async def test_path_params_delete(self, async_client: AsyncKernel) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `id` but received ''"):
+            await async_client.deployments.with_raw_response.delete(
+                "",
+            )
+
     @pytest.mark.skip(reason="Mock server tests are disabled")
     @parametrize
     async def test_method_follow(self, async_client: AsyncKernel) -> None: