feat: Add version filter to GET /deployments endpoint

Author: stainless-app[bot]

.stats.yml

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

src/kernel/resources/deployments.py

@@ -156,6 +156,7 @@ def list(
         self,
         *,
         app_name: str | Omit = omit,
+        app_version: str | Omit = omit,
         limit: int | Omit = omit,
         offset: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -167,11 +168,13 @@ def list(
     ) -> SyncOffsetPagination[DeploymentListResponse]:
         """List deployments.
 
-        Optionally filter by application name.
+        Optionally filter by application name and version.
 
         Args:
           app_name: Filter results by application name.
 
+          app_version: Filter results by application version. Requires app_name to be set.
+
           limit: Limit the number of deployments to return.
 
           offset: Offset the number of deployments to return.
@@ -195,6 +198,7 @@ def list(
                 query=maybe_transform(
                     {
                         "app_name": app_name,
+                        "app_version": app_version,
                         "limit": limit,
                         "offset": offset,
                     },
@@ -415,6 +419,7 @@ def list(
         self,
         *,
         app_name: str | Omit = omit,
+        app_version: str | Omit = omit,
         limit: int | Omit = omit,
         offset: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -426,11 +431,13 @@ def list(
     ) -> AsyncPaginator[DeploymentListResponse, AsyncOffsetPagination[DeploymentListResponse]]:
         """List deployments.
 
-        Optionally filter by application name.
+        Optionally filter by application name and version.
 
         Args:
           app_name: Filter results by application name.
 
+          app_version: Filter results by application version. Requires app_name to be set.
+
           limit: Limit the number of deployments to return.
 
           offset: Offset the number of deployments to return.
@@ -454,6 +461,7 @@ def list(
                 query=maybe_transform(
                     {
                         "app_name": app_name,
+                        "app_version": app_version,
                         "limit": limit,
                         "offset": offset,
                     },

src/kernel/types/deployment_list_params.py

@@ -11,6 +11,9 @@ class DeploymentListParams(TypedDict, total=False):
     app_name: str
     """Filter results by application name."""
 
+    app_version: str
+    """Filter results by application version. Requires app_name to be set."""
+
     limit: int
     """Limit the number of deployments to return."""
 

tests/api_resources/test_deployments.py

@@ -127,6 +127,7 @@ def test_method_list(self, client: Kernel) -> None:
     def test_method_list_with_all_params(self, client: Kernel) -> None:
         deployment = client.deployments.list(
             app_name="app_name",
+            app_version="app_version",
             limit=1,
             offset=0,
         )
@@ -357,6 +358,7 @@ async def test_method_list(self, async_client: AsyncKernel) -> None:
     async def test_method_list_with_all_params(self, async_client: AsyncKernel) -> None:
         deployment = await async_client.deployments.list(
             app_name="app_name",
+            app_version="app_version",
             limit=1,
             offset=0,
         )