[ECT-2482] Improve documentation to redirect common events usage to V1 endpoint (#431)

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": "2024-12-13 16:09:25.555961",
-            "spec_repo_commit": "936a5463"
+            "regenerated": "2024-12-16 18:27:46.210937",
+            "spec_repo_commit": "a179b579"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-12-13 16:09:25.575458",
-            "spec_repo_commit": "936a5463"
+            "regenerated": "2024-12-16 18:27:46.225187",
+            "spec_repo_commit": "a179b579"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -31987,12 +31987,10 @@ paths:
         permissions:
         - events_read
     post:
-      description: 'This endpoint allows you to post events.
-
-
-        Only events with **`change` category** are under General Availability. Refer
-        to [Change Tracking](https://docs.datadoghq.com/change_tracking) for further
-        details.'
+      description: "This endpoint allows you to post events.\n\n\u2705 **Only events
+        with the `change` category** are in General Availability. See [Change Tracking](https://docs.datadoghq.com/change_tracking)
+        for more details.\n\n\u274C For use cases involving other event categories,
+        please use the V1 endpoint."
       operationId: CreateEvent
       requestBody:
         content:

src/datadogV2/api/api_events.rs

@@ -170,7 +170,9 @@ impl EventsAPI {
 
     /// This endpoint allows you to post events.
     ///
-    /// Only events with **`change` category** are under General Availability. Refer to [Change Tracking](<https://docs.datadoghq.com/change_tracking>) for further details.
+    /// ✅ **Only events with the `change` category** are in General Availability. See [Change Tracking](<https://docs.datadoghq.com/change_tracking>) for more details.
+    ///
+    /// ❌ For use cases involving other event categories, please use the V1 endpoint.
     pub async fn create_event(
         &self,
         body: crate::datadogV2::model::EventCreateRequestPayload,
@@ -192,7 +194,9 @@ impl EventsAPI {
 
     /// This endpoint allows you to post events.
     ///
-    /// Only events with **`change` category** are under General Availability. Refer to [Change Tracking](<https://docs.datadoghq.com/change_tracking>) for further details.
+    /// ✅ **Only events with the `change` category** are in General Availability. See [Change Tracking](<https://docs.datadoghq.com/change_tracking>) for more details.
+    ///
+    /// ❌ For use cases involving other event categories, please use the V1 endpoint.
     pub async fn create_event_with_http_info(
         &self,
         body: crate::datadogV2::model::EventCreateRequestPayload,