[ECT-2482] Improve documentation to redirect common events usage to V…

…1 endpoint (#26767)

Co-authored-by: ci.datadog-api-spec <[email protected]>

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-12-13 15:31:47.674190",
-            "spec_repo_commit": "e7a707af"
+            "regenerated": "2024-12-16 18:29:13.331043",
+            "spec_repo_commit": "a179b579"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-12-13 15:31:55.671458",
-            "spec_repo_commit": "e7a707af"
+            "regenerated": "2024-12-16 18:29:21.222347",
+            "spec_repo_commit": "a179b579"
         }
     }
 }

content/en/api/v1/synthetics/examples.json

@@ -4550,7 +4550,7 @@
         ],
         "to_ts": 0
       },
-      "html": "<div class=\"\"><div class=\"row   \">\n          <div class=\"col-12 first-column\">\n            <div class=\"row first-row  \">\n              <div class=\"col-4 column\">\n      <p class=\"key\">from_ts&nbsp;[<em>required</em>]</p>\n    </div>\n              <div class=\"col-2 column\"><p>int64</p></div>\n              <div class=\"col-6 column\"><p>Timestamp in seconds (Unix epoch) for the start of uptime.</p></div>\n            </div>\n            \n          </div>\n        </div><div class=\"row   \">\n          <div class=\"col-12 first-column\">\n            <div class=\"row first-row  \">\n              <div class=\"col-4 column\">\n      <p class=\"key\">public_ids&nbsp;[<em>required</em>]</p>\n    </div>\n              <div class=\"col-2 column\"><p>[string]</p></div>\n              <div class=\"col-6 column\"><p>An array of Synthetic test IDs you want to delete.</p></div>\n            </div>\n            \n          </div>\n        </div><div class=\"row   \">\n          <div class=\"col-12 first-column\">\n            <div class=\"row first-row  \">\n              <div class=\"col-4 column\">\n      <p class=\"key\">to_ts&nbsp;[<em>required</em>]</p>\n    </div>\n              <div class=\"col-2 column\"><p>int64</p></div>\n              <div class=\"col-6 column\"><p>Timestamp in seconds (Unix epoch) for the end of uptime.</p></div>\n            </div>\n            \n          </div>\n        </div></div>"
+      "html": "<div class=\"\"><div class=\"row   \">\n          <div class=\"col-12 first-column\">\n            <div class=\"row first-row  \">\n              <div class=\"col-4 column\">\n      <p class=\"key\">from_ts&nbsp;[<em>required</em>]</p>\n    </div>\n              <div class=\"col-2 column\"><p>int64</p></div>\n              <div class=\"col-6 column\"><p>Timestamp in seconds (Unix epoch) for the start of uptime.</p></div>\n            </div>\n            \n          </div>\n        </div><div class=\"row   \">\n          <div class=\"col-12 first-column\">\n            <div class=\"row first-row  \">\n              <div class=\"col-4 column\">\n      <p class=\"key\">public_ids&nbsp;[<em>required</em>]</p>\n    </div>\n              <div class=\"col-2 column\"><p>[string]</p></div>\n              <div class=\"col-6 column\"><p>An array of Synthetic test IDs you want uptimes for.</p></div>\n            </div>\n            \n          </div>\n        </div><div class=\"row   \">\n          <div class=\"col-12 first-column\">\n            <div class=\"row first-row  \">\n              <div class=\"col-4 column\">\n      <p class=\"key\">to_ts&nbsp;[<em>required</em>]</p>\n    </div>\n              <div class=\"col-2 column\"><p>int64</p></div>\n              <div class=\"col-6 column\"><p>Timestamp in seconds (Unix epoch) for the end of uptime.</p></div>\n            </div>\n            \n          </div>\n        </div></div>"
     }
   },
   "GetTest": {

data/api/v1/full_spec.yaml

@@ -15448,7 +15448,7 @@ components:
           format: int64
           type: integer
         public_ids:
-          description: An array of Synthetic test IDs you want to delete.
+          description: An array of Synthetic test IDs you want uptimes for.
           example: []
           items:
             description: A Synthetic test ID.

data/api/v1/full_spec_deref.json

@@ -508537,7 +508537,7 @@
             "type": "integer"
           },
           "public_ids": {
-            "description": "An array of Synthetic test IDs you want to delete.",
+            "description": "An array of Synthetic test IDs you want uptimes for.",
             "example": [],
             "items": {
               "description": "A Synthetic test ID.",
@@ -1108276,7 +1108276,7 @@
                     "type": "integer"
                   },
                   "public_ids": {
-                    "description": "An array of Synthetic test IDs you want to delete.",
+                    "description": "An array of Synthetic test IDs you want uptimes for.",
                     "example": [],
                     "items": {
                       "description": "A Synthetic test ID.",

data/api/v2/full_spec.yaml

@@ -32924,12 +32924,10 @@ paths:
       x-undo:
         type: safe
     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:

data/api/v2/full_spec_deref.json

@@ -230907,7 +230907,7 @@
         }
       },
       "post": {
-        "description": "This endpoint allows you to post events.\n\nOnly 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✅ **Only events with the `change` category** are in General Availability. See [Change Tracking](https://docs.datadoghq.com/change_tracking) for more details.\n\n❌ For use cases involving other event categories, please use the V1 endpoint.",
         "operationId": "CreateEvent",
         "requestBody": {
           "content": {