feat(api): add acknowledge_token param to environments.start method

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 175
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-d7f548d9bd50aca802b55ace7e9194d8dbe4a96a1258abcc4786cb00094b6802.yml
-openapi_spec_hash: d29ac6bb840f1dcfec0ab4b7e1235060
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-b501e4da71906d7d2cfb49ff85c4d1316592623392cf00cb535938b7844f469b.yml
+openapi_spec_hash: 5b1bd959ae6f6a909b3d00acbb49ea78
 config_hash: 343503f34d4ea5e1d46f58f24519a796

src/gitpod/resources/environments/environments.py

@@ -748,6 +748,7 @@ def mark_active(
     def start(
         self,
         *,
+        acknowledge_token: str | Omit = omit,
         environment_id: str | Omit = omit,
         # 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.
@@ -774,6 +775,10 @@ def start(
           ```
 
         Args:
+          acknowledge_token: acknowledge_token is the HMAC token from a previous
+              EnvironmentMaxLifetimeEnforcementDetails response, allowing the user to start an
+              environment past its max lifetime in warn mode.
+
           environment_id: environment_id specifies which environment should be started.
 
           extra_headers: Send extra headers
@@ -786,7 +791,13 @@ def start(
         """
         return self._post(
             "/gitpod.v1.EnvironmentService/StartEnvironment",
-            body=maybe_transform({"environment_id": environment_id}, environment_start_params.EnvironmentStartParams),
+            body=maybe_transform(
+                {
+                    "acknowledge_token": acknowledge_token,
+                    "environment_id": environment_id,
+                },
+                environment_start_params.EnvironmentStartParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -1577,6 +1588,7 @@ async def mark_active(
     async def start(
         self,
         *,
+        acknowledge_token: str | Omit = omit,
         environment_id: str | Omit = omit,
         # 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.
@@ -1603,6 +1615,10 @@ async def start(
           ```
 
         Args:
+          acknowledge_token: acknowledge_token is the HMAC token from a previous
+              EnvironmentMaxLifetimeEnforcementDetails response, allowing the user to start an
+              environment past its max lifetime in warn mode.
+
           environment_id: environment_id specifies which environment should be started.
 
           extra_headers: Send extra headers
@@ -1616,7 +1632,11 @@ async def start(
         return await self._post(
             "/gitpod.v1.EnvironmentService/StartEnvironment",
             body=await async_maybe_transform(
-                {"environment_id": environment_id}, environment_start_params.EnvironmentStartParams
+                {
+                    "acknowledge_token": acknowledge_token,
+                    "environment_id": environment_id,
+                },
+                environment_start_params.EnvironmentStartParams,
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout

src/gitpod/types/environment_start_params.py

@@ -10,5 +10,12 @@
 
 
 class EnvironmentStartParams(TypedDict, total=False):
+    acknowledge_token: Annotated[str, PropertyInfo(alias="acknowledgeToken")]
+    """
+    acknowledge_token is the HMAC token from a previous
+    EnvironmentMaxLifetimeEnforcementDetails response, allowing the user to start an
+    environment past its max lifetime in warn mode.
+    """
+
     environment_id: Annotated[str, PropertyInfo(alias="environmentId")]
     """environment_id specifies which environment should be started."""

tests/api_resources/test_environments.py

@@ -609,6 +609,7 @@ def test_method_start(self, client: Gitpod) -> None:
     @parametrize
     def test_method_start_with_all_params(self, client: Gitpod) -> None:
         environment = client.environments.start(
+            acknowledge_token="acknowledgeToken",
             environment_id="07e03a28-65a5-4d98-b532-8ea67b188048",
         )
         assert_matches_type(object, environment, path=["response"])
@@ -1296,6 +1297,7 @@ async def test_method_start(self, async_client: AsyncGitpod) -> None:
     @parametrize
     async def test_method_start_with_all_params(self, async_client: AsyncGitpod) -> None:
         environment = await async_client.environments.start(
+            acknowledge_token="acknowledgeToken",
             environment_id="07e03a28-65a5-4d98-b532-8ea67b188048",
         )
         assert_matches_type(object, environment, path=["response"])