diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json
index 67c12225ee..eab9e74c48 100644
--- a/output/openapi/elasticsearch-openapi.json
+++ b/output/openapi/elasticsearch-openapi.json
@@ -20409,8 +20409,8 @@
         "tags": [
           "ml"
         ],
-        "summary": "Return ML defaults and limits",
-        "description": "Returns defaults and limits used by machine learning.\nThis endpoint is designed to be used by a user interface that needs to fully\nunderstand machine learning configurations where some options are not\nspecified, meaning that the defaults should be used. This endpoint may be\nused to find out what those defaults are. It also provides information about\nthe maximum size of machine learning jobs that could run in the current\ncluster configuration.",
+        "summary": "Get machine learning information",
+        "description": "Get defaults and limits used by machine learning.\nThis endpoint is designed to be used by a user interface that needs to fully\nunderstand machine learning configurations where some options are not\nspecified, meaning that the defaults should be used. This endpoint may be\nused to find out what those defaults are. It also provides information about\nthe maximum size of machine learning jobs that could run in the current\ncluster configuration.",
         "operationId": "ml-info",
         "responses": {
           "200": {
@@ -22586,9 +22586,9 @@
     "/_ml/anomaly_detectors/_validate/detector": {
       "post": {
         "tags": [
-          "ml"
+          "ml anomaly"
         ],
-        "summary": "Validates an anomaly detection detector",
+        "summary": "Validate an anomaly detection job",
         "operationId": "ml-validate-detector",
         "requestBody": {
           "content": {
diff --git a/output/schema/schema.json b/output/schema/schema.json
index 478520ccf2..0ced42ee9b 100644
--- a/output/schema/schema.json
+++ b/output/schema/schema.json
@@ -11429,7 +11429,7 @@
           "stability": "stable"
         }
       },
-      "description": "Return ML defaults and limits.\nReturns defaults and limits used by machine learning.\nThis endpoint is designed to be used by a user interface that needs to fully\nunderstand machine learning configurations where some options are not\nspecified, meaning that the defaults should be used. This endpoint may be\nused to find out what those defaults are. It also provides information about\nthe maximum size of machine learning jobs that could run in the current\ncluster configuration.",
+      "description": "Get machine learning information.\nGet defaults and limits used by machine learning.\nThis endpoint is designed to be used by a user interface that needs to fully\nunderstand machine learning configurations where some options are not\nspecified, meaning that the defaults should be used. This endpoint may be\nused to find out what those defaults are. It also provides information about\nthe maximum size of machine learning jobs that could run in the current\ncluster configuration.",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/current/get-ml-info.html",
       "name": "ml.info",
       "privileges": {
@@ -12908,7 +12908,8 @@
           "visibility": "private"
         }
       },
-      "description": "Validates an anomaly detection detector.",
+      "description": "Validate an anomaly detection job.",
+      "docTag": "ml anomaly",
       "docUrl": "https://www.elastic.co/guide/en/machine-learning/current/ml-jobs.html",
       "name": "ml.validate_detector",
       "request": {
@@ -168587,7 +168588,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Return ML defaults and limits.\nReturns defaults and limits used by machine learning.\nThis endpoint is designed to be used by a user interface that needs to fully\nunderstand machine learning configurations where some options are not\nspecified, meaning that the defaults should be used. This endpoint may be\nused to find out what those defaults are. It also provides information about\nthe maximum size of machine learning jobs that could run in the current\ncluster configuration.",
+      "description": "Get machine learning information.\nGet defaults and limits used by machine learning.\nThis endpoint is designed to be used by a user interface that needs to fully\nunderstand machine learning configurations where some options are not\nspecified, meaning that the defaults should be used. This endpoint may be\nused to find out what those defaults are. It also provides information about\nthe maximum size of machine learning jobs that could run in the current\ncluster configuration.",
       "inherits": {
         "type": {
           "name": "RequestBase",
@@ -175139,7 +175140,7 @@
           }
         }
       },
-      "description": "Validates an anomaly detection detector.",
+      "description": "Validate an anomaly detection job.",
       "inherits": {
         "type": {
           "name": "RequestBase",
@@ -175152,7 +175153,7 @@
       },
       "path": [],
       "query": [],
-      "specLocation": "ml/validate_detector/MlValidateDetectorRequest.ts#L23-L31"
+      "specLocation": "ml/validate_detector/MlValidateDetectorRequest.ts#L23-L33"
     },
     {
       "kind": "response",
diff --git a/specification/ml/info/MlInfoRequest.ts b/specification/ml/info/MlInfoRequest.ts
index 17ba0702d3..4f503ed165 100644
--- a/specification/ml/info/MlInfoRequest.ts
+++ b/specification/ml/info/MlInfoRequest.ts
@@ -20,8 +20,8 @@
 import { RequestBase } from '@_types/Base'
 
 /**
- * Return ML defaults and limits.
- * Returns defaults and limits used by machine learning.
+ * Get machine learning information.
+ * Get defaults and limits used by machine learning.
  * This endpoint is designed to be used by a user interface that needs to fully
  * understand machine learning configurations where some options are not
  * specified, meaning that the defaults should be used. This endpoint may be
diff --git a/specification/ml/validate_detector/MlValidateDetectorRequest.ts b/specification/ml/validate_detector/MlValidateDetectorRequest.ts
index fc586c5fb2..e8f6c3a705 100644
--- a/specification/ml/validate_detector/MlValidateDetectorRequest.ts
+++ b/specification/ml/validate_detector/MlValidateDetectorRequest.ts
@@ -21,9 +21,11 @@ import { Detector } from '@ml/_types/Detector'
 import { RequestBase } from '@_types/Base'
 
 /**
+ * Validate an anomaly detection job.
  * @rest_spec_name ml.validate_detector
  * @availability stack since=5.4.0 stability=stable visibility=private
  * @availability serverless stability=stable visibility=private
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   /** @codegen_name detector */