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

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:27.276499",
-            "spec_repo_commit": "936a5463"
+            "regenerated": "2024-12-16 18:27:46.347897",
+            "spec_repo_commit": "a179b579"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-12-13 16:09:27.294189",
-            "spec_repo_commit": "936a5463"
+            "regenerated": "2024-12-16 18:27:46.361768",
+            "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/datadog_api_client/v2/api/events_api.py

@@ -130,7 +130,9 @@ def create_event(
 
         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.
 
         :param body: Event request object
         :type body: EventCreateRequestPayload