Add a note about downtime deletion behavior (#2101)

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:55.334120",
-            "spec_repo_commit": "f64c1d75"
+            "regenerated": "2025-03-14 07:51:12.126872",
+            "spec_repo_commit": "899883be"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-03-13 19:52:55.349813",
-            "spec_repo_commit": "f64c1d75"
+            "regenerated": "2025-03-14 07:51:12.142713",
+            "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.

packages/datadog-api-client-v2/apis/DowntimesApi.ts

@@ -776,6 +776,8 @@ export class 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.
    * @param param The request object
    */
   public cancelDowntime(