From f9cd5febf1b62d27a6204e80ec001d8325119628 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/project.tags.json
---
 .../src/main/resources/rest-api-spec/api/esql.get_query.json   | 2 +-
 .../main/resources/rest-api-spec/api/esql.list_queries.json    | 2 +-
 .../main/resources/rest-api-spec/api/ml.validate_detector.json | 2 +-
 rest-api-spec/src/main/resources/schema.json                   | 3 +++
 4 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/esql.get_query.json b/rest-api-spec/src/main/resources/rest-api-spec/api/esql.get_query.json
index 817e07828bed5..be23093c27a9a 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/esql.get_query.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/esql.get_query.json
@@ -1,7 +1,7 @@
 {
   "esql.get_query": {
     "documentation": {
-      "url": null,
+      "url": "https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-esql-get-query",
       "description": "Get a specific running ES|QL query information"
     },
     "stability": "experimental",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/esql.list_queries.json b/rest-api-spec/src/main/resources/rest-api-spec/api/esql.list_queries.json
index d219feadff04a..ba3fb4536665c 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/esql.list_queries.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/esql.list_queries.json
@@ -1,7 +1,7 @@
 {
   "esql.list_queries": {
     "documentation": {
-      "url": null,
+      "url": "https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-esql-list-queries",
       "description": "Get running ES|QL queries information"
     },
     "stability": "experimental",
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 8d3fba941af3b..090f65e8ab550 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/guide/en/machine-learning/current/ml-jobs.html",
+      "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 02fdd920f9216..3326a112c2713 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"
                       }
                     }
                   },