From 829320d6bc201b7ae6515d794bc60f85392cdf57 Mon Sep 17 00:00:00 2001
From: pquentin <42327+pquentin@users.noreply.github.com>
Date: Wed, 26 Feb 2025 04:07:03 +0000
Subject: [PATCH] Update rest-api-spec

---
 output/schema/validation-errors.json          | 21 -------------------
 specification/_json_spec/cat.help.json        | 11 ----------
 specification/_json_spec/cat.segments.json    |  8 +++++++
 specification/_json_spec/cat.tasks.json       | 10 +++++++++
 ..._application.put_behavioral_analytics.json |  2 +-
 5 files changed, 19 insertions(+), 33 deletions(-)

diff --git a/output/schema/validation-errors.json b/output/schema/validation-errors.json
index 7835b4c447..e8645306c9 100644
--- a/output/schema/validation-errors.json
+++ b/output/schema/validation-errors.json
@@ -12,27 +12,6 @@
       ],
       "response": []
     },
-    "cat.help": {
-      "request": [
-        "Request: missing json spec query parameter 'help'",
-        "Request: missing json spec query parameter 's'"
-      ],
-      "response": []
-    },
-    "cat.segments": {
-      "request": [
-        "Request: query parameter 'local' does not exist in the json spec",
-        "Request: query parameter 'master_timeout' does not exist in the json spec"
-      ],
-      "response": []
-    },
-    "cat.tasks": {
-      "request": [
-        "Request: query parameter 'timeout' does not exist in the json spec",
-        "Request: query parameter 'wait_for_completion' does not exist in the json spec"
-      ],
-      "response": []
-    },
     "cluster.get_component_template": {
       "request": [
         "Request: query parameter 'flat_settings' does not exist in the json spec"
diff --git a/specification/_json_spec/cat.help.json b/specification/_json_spec/cat.help.json
index 07d8b8af0f..d37747f882 100644
--- a/specification/_json_spec/cat.help.json
+++ b/specification/_json_spec/cat.help.json
@@ -16,17 +16,6 @@
           "methods": ["GET"]
         }
       ]
-    },
-    "params": {
-      "help": {
-        "type": "boolean",
-        "description": "Return help information",
-        "default": false
-      },
-      "s": {
-        "type": "list",
-        "description": "Comma-separated list of column names or column aliases to sort by"
-      }
     }
   }
 }
diff --git a/specification/_json_spec/cat.segments.json b/specification/_json_spec/cat.segments.json
index 765f0b41ef..369c813aba 100644
--- a/specification/_json_spec/cat.segments.json
+++ b/specification/_json_spec/cat.segments.json
@@ -32,6 +32,14 @@
         "type": "string",
         "description": "a short version of the Accept header, e.g. json, yaml"
       },
+      "local": {
+        "type": "boolean",
+        "description": "Return local information, do not retrieve the state from master node (default: false)"
+      },
+      "master_timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout for connection to master node"
+      },
       "bytes": {
         "type": "enum",
         "description": "The unit in which to display byte values",
diff --git a/specification/_json_spec/cat.tasks.json b/specification/_json_spec/cat.tasks.json
index e8a74574f5..24164f3857 100644
--- a/specification/_json_spec/cat.tasks.json
+++ b/specification/_json_spec/cat.tasks.json
@@ -60,6 +60,16 @@
         "type": "boolean",
         "description": "Verbose mode. Display column headers",
         "default": false
+      },
+      "timeout": {
+        "type": "time",
+        "default": "30s",
+        "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error."
+      },
+      "wait_for_completion": {
+        "type": "boolean",
+        "default": false,
+        "description": "If `true`, the request blocks until the task has completed."
       }
     }
   }
diff --git a/specification/_json_spec/search_application.put_behavioral_analytics.json b/specification/_json_spec/search_application.put_behavioral_analytics.json
index 2b81868508..90b5c11c74 100644
--- a/specification/_json_spec/search_application.put_behavioral_analytics.json
+++ b/specification/_json_spec/search_application.put_behavioral_analytics.json
@@ -5,11 +5,11 @@
       "description": "Creates a behavioral analytics collection."
     },
     "stability": "experimental",
-    "visibility": "public",
     "deprecated": {
       "version": "9.0.0",
       "description": "Behavioral Analytics has been deprecated and will be removed in a future release."
     },
+    "visibility": "public",
     "headers": {
       "accept": ["application/json"]
     },