Update rest-api-spec (#3816)

Co-authored-by: pquentin <[email protected]>

Author: github-actions[bot]

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"

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"
-      }
     }
   }
 }

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",

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."
       }
     }
   }

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"]
     },