Add a note about downtime deletion behavior (#2759)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

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:49.215402",
-            "spec_repo_commit": "f64c1d75"
+            "regenerated": "2025-03-14 07:51:06.324305",
+            "spec_repo_commit": "899883be"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-03-13 19:52:49.230891",
-            "spec_repo_commit": "f64c1d75"
+            "regenerated": "2025-03-14 07:51:06.339981",
+            "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/main/java/com/datadog/api/client/v2/api/DowntimesApi.java

@@ -83,6 +83,10 @@ public CompletableFuture<Void> cancelDowntimeAsync(String downtimeId) {
   /**
    * Cancel a downtime.
    *
+   * <p><strong>Note</strong>: 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.
+   *
    * @param downtimeId ID of the downtime to cancel. (required)
    * @return ApiResponse&lt;Void&gt;
    * @throws ApiException if fails to make API call