Update rest-api-spec (#3593)

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

Author: github-actions[bot]

output/openapi/elasticsearch-openapi.json

@@ -2,7 +2,6 @@
   "endpointErrors": {
     "async_search.submit": {
       "request": [
-        "Request: query parameter 'keep_alive' does not exist in the json spec",
         "Request: query parameter 'min_compatible_shard_node' does not exist in the json spec",
         "interface definition _types:QueryVectorBuilder - Property text_embedding is a single-variant and must be required"
       ],
@@ -57,13 +56,6 @@
       ],
       "response": []
     },
-    "cat.help": {
-      "request": [
-        "Request: missing json spec query parameter 'help'",
-        "Request: missing json spec query parameter 's'"
-      ],
-      "response": []
-    },
     "cat.indices": {
       "request": [
         "request definition cat.indices:Request / body - A request with inherited properties must have a PropertyBody"
@@ -138,8 +130,6 @@
     },
     "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",
         "request definition cat.segments:Request / body - A request with inherited properties must have a PropertyBody"
       ],
       "response": []
@@ -158,8 +148,6 @@
     },
     "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",
         "request definition cat.tasks:Request / body - A request with inherited properties must have a PropertyBody"
       ],
       "response": []
@@ -367,6 +355,13 @@
       ],
       "response": []
     },
+    "inference.update": {
+      "request": [
+        "/_inference/{inference_id}/_update: different http methods in the json spec",
+        "/_inference/{task_type}/{inference_id}/_update: different http methods in the json spec"
+      ],
+      "response": []
+    },
     "ingest.delete_geoip_database": {
       "request": [
         "Request: query parameter 'master_timeout' does not exist in the json spec",

output/openapi/elasticsearch-serverless-openapi.json

@@ -39,6 +39,11 @@
         "description": "Control whether the response should be stored in the cluster if it completed within the provided [wait_for_completion] time (default: false)",
         "default": false
       },
+      "keep_alive": {
+        "type": "time",
+        "description": "Update the time interval in which the results (partial or final) for this search will be available",
+        "default": "5d"
+      },
       "batched_reduce_size": {
         "type": "number",
         "description": "The number of shard results that should be reduced at once on the coordinating node. This value should be used as the granularity at which progress results will be made available.",

output/schema/schema-serverless.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"
-      }
     }
   }
 }

output/schema/validation-errors.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/async_search.submit.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/cat.help.json

@@ -42,7 +42,7 @@
       "allow_partial_search_results": {
         "type": "boolean",
         "description": "Control whether the query should keep running in case of shard failures, and return partial results",
-        "default": false
+        "default": true
       },
       "allow_partial_sequence_results": {
         "type": "boolean",

specification/_json_spec/cat.segments.json

@@ -1,7 +1,7 @@
 {
   "indices.cancel_migrate_reindex": {
     "documentation": {
-      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/data-stream-reindex.html",
+      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/data-stream-reindex-cancel-api.html",
       "description": "This API returns the status of a migration reindex attempt for a data stream or index"
     },
     "stability": "experimental",

specification/_json_spec/cat.tasks.json

@@ -1,7 +1,7 @@
 {
   "indices.create_from": {
     "documentation": {
-      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/data-stream-reindex.html",
+      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-create-index-from-source.html",
       "description": "This API creates a destination from a source index. It copies the mappings and settings from the source index while allowing request settings and mappings to override the source values."
     },
     "stability": "experimental",

specification/_json_spec/eql.search.json

@@ -1,7 +1,7 @@
 {
   "indices.get_migrate_reindex_status": {
     "documentation": {
-      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/data-stream-reindex.html",
+      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/data-stream-reindex-status-api.html",
       "description": "This API returns the status of a migration reindex attempt for a data stream or index"
     },
     "stability": "experimental",

specification/_json_spec/indices.cancel_migrate_reindex.json

@@ -1,7 +1,7 @@
 {
   "indices.migrate_reindex": {
     "documentation": {
-      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/data-stream-reindex.html",
+      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/data-stream-reindex-api.html",
       "description": "This API reindexes all legacy backing indices for a data stream. It does this in a persistent task. The persistent task id is returned immediately, and the reindexing work is completed in that task"
     },
     "stability": "experimental",