Link the main documentation in the CreateAPI section (#1837)

Co-authored-by: ci.datadog-api-spec <[email protected]>
Co-authored-by: api-clients-generation-pipeline[bot] <54105614+api-clients-generation-pipeline[bot]@users.noreply.github.com>

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-05-29 12:19:34.090961",
-            "spec_repo_commit": "5a618bf5"
+            "regenerated": "2024-05-29 17:07:16.366909",
+            "spec_repo_commit": "faa2d929"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-05-29 12:19:34.109387",
-            "spec_repo_commit": "5a618bf5"
+            "regenerated": "2024-05-29 17:07:16.384472",
+            "spec_repo_commit": "faa2d929"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -23222,11 +23222,10 @@ paths:
       description: 'Create a new API from the [OpenAPI](https://spec.openapis.org/oas/latest.html)
         specification given.
 
-        It supports version `2.0`, `3.0` and `3.1` of the specification. A specific
-        extension section, `x-datadog`,
+        See the [API Catalog documentation](https://docs.datadoghq.com/api_catalog/add_metadata/)
+        for additional
 
-        let you specify the `teamHandle` for your team responsible for the API in
-        Datadog.
+        information about the possible metadata.
 
         It returns the created API ID.
 

lib/datadog_api_client/v2/api/api_management_api.rb

@@ -34,8 +34,8 @@ def create_open_api(opts = {})
     # Create a new API.
     #
     # Create a new API from the [OpenAPI](https://spec.openapis.org/oas/latest.html) specification given.
-    # It supports version `2.0`, `3.0` and `3.1` of the specification. A specific extension section, `x-datadog`,
-    # let you specify the `teamHandle` for your team responsible for the API in Datadog.
+    # See the [API Catalog documentation](https://docs.datadoghq.com/api_catalog/add_metadata/) for additional
+    # information about the possible metadata.
     # It returns the created API ID.
     #
     #