Add a note about downtime deletion behavior (#2289)

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.528972",
-            "spec_repo_commit": "f64c1d75"
+            "regenerated": "2025-03-14 07:51:10.767732",
+            "spec_repo_commit": "899883be"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-03-13 19:52:49.544117",
-            "spec_repo_commit": "f64c1d75"
+            "regenerated": "2025-03-14 07:51:10.783055",
+            "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.

lib/datadog_api_client/v2/api/downtimes_api.rb

@@ -35,6 +35,8 @@ def cancel_downtime(downtime_id, opts = {})
     #
     # 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.
+    #
     # @param downtime_id [String] ID of the downtime to cancel.
     # @param opts [Hash] the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers