From d3dbd4cc461fb1e4bd032982eaaa338dc26ef5ba Mon Sep 17 00:00:00 2001
From: Quentin Pradet <quentin.pradet@elastic.co>
Date: Wed, 5 Nov 2025 07:19:08 +0400
Subject: [PATCH] rest-api-spec: fix documentation URLs (#137559)

(cherry picked from commit bb71252622bf967fc0a8093278e92b87379bc2c5)

# Conflicts:
#	rest-api-spec/src/main/resources/rest-api-spec/api/esql.get_query.json
#	rest-api-spec/src/main/resources/rest-api-spec/api/esql.list_queries.json
#	rest-api-spec/src/main/resources/rest-api-spec/api/ml.validate_detector.json
#	rest-api-spec/src/main/resources/rest-api-spec/api/project.tags.json
---
 .../main/resources/rest-api-spec/api/ml.validate_detector.json | 2 +-
 rest-api-spec/src/main/resources/schema.json                   | 3 +++
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ml.validate_detector.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ml.validate_detector.json
index 683151d482407..41534f790341b 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/ml.validate_detector.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/ml.validate_detector.json
@@ -1,7 +1,7 @@
 {
   "ml.validate_detector": {
     "documentation": {
-      "url": "https://www.elastic.co/docs/api/doc/elasticsearch/v8",
+      "url": null,
       "description": "Validate an anomaly detection job"
     },
     "stability": "stable",
diff --git a/rest-api-spec/src/main/resources/schema.json b/rest-api-spec/src/main/resources/schema.json
index 19cde469c3311..5ca63720d5401 100644
--- a/rest-api-spec/src/main/resources/schema.json
+++ b/rest-api-spec/src/main/resources/schema.json
@@ -60,6 +60,9 @@
                     "properties": {
                       "stability": {
                         "const": "stable"
+                      },
+                      "visibility": {
+                        "const": "public"
                       }
                     }
                   },