Add a note about downtime deletion behavior (#559)

Co-authored-by: ci.datadog-api-spec <[email protected]>

Author: api-clients-generation-pipeline[bot]

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-03-13 19:52:56.366752",
-            "spec_repo_commit": "f64c1d75"
+            "regenerated": "2025-03-14 07:51:06.068505",
+            "spec_repo_commit": "899883be"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-03-13 19:52:56.385315",
-            "spec_repo_commit": "f64c1d75"
+            "regenerated": "2025-03-14 07:51:06.084701",
+            "spec_repo_commit": "899883be"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -38777,7 +38777,12 @@ paths:
         - monitors_downtime
   /api/v2/downtime/{downtime_id}:
     delete:
-      description: Cancel a downtime.
+      description: 'Cancel a downtime.
+
+
+        **Note**: Downtimes canceled through the API are no longer active, but are
+        retained for approximately two days before being permanently removed. The
+        downtime may still appear in search results until it is permanently removed.'
       operationId: CancelDowntime
       parameters:
       - description: ID of the downtime to cancel.

src/datadogV2/api/api_downtimes.rs

@@ -211,6 +211,8 @@ impl DowntimesAPI {
     }
 
     /// Cancel a downtime.
+    ///
+    /// **Note**: Downtimes canceled through the API are no longer active, but are retained for approximately two days before being permanently removed. The downtime may still appear in search results until it is permanently removed.
     pub async fn cancel_downtime(
         &self,
         downtime_id: String,
@@ -222,6 +224,8 @@ impl DowntimesAPI {
     }
 
     /// Cancel a downtime.
+    ///
+    /// **Note**: Downtimes canceled through the API are no longer active, but are retained for approximately two days before being permanently removed. The downtime may still appear in search results until it is permanently removed.
     pub async fn cancel_downtime_with_http_info(
         &self,
         downtime_id: String,