Update rest-api-spec (#5009)

github-actions[bot] · pquentin · web-flow · commit 623ba4ea5f9b · 2025-07-22T14:55:19.000+04:00
Co-authored-by: pquentin &lt;42327+pquentin@users.noreply.github.com&gt;
diff --git a/output/schema/validation-errors.json b/output/schema/validation-errors.json
@@ -6,98 +6,11 @@
       ],
       "response": []
     },
-    "esql.async_query_get": {
-      "request": [
-        "Request: query parameter 'format' does not exist in the json spec"
-      ],
-      "response": []
-    },
-    "ilm.delete_lifecycle": {
-      "request": [
-        "Request: query parameter 'master_timeout' does not exist in the json spec",
-        "Request: query parameter 'timeout' does not exist in the json spec"
-      ],
-      "response": []
-    },
-    "ilm.explain_lifecycle": {
-      "request": [
-        "Request: query parameter 'master_timeout' does not exist in the json spec"
-      ],
-      "response": []
-    },
-    "ilm.get_lifecycle": {
-      "request": [
-        "Request: query parameter 'master_timeout' does not exist in the json spec",
-        "Request: query parameter 'timeout' does not exist in the json spec"
-      ],
-      "response": []
-    },
-    "ilm.put_lifecycle": {
-      "request": [
-        "Request: query parameter 'master_timeout' does not exist in the json spec",
-        "Request: query parameter 'timeout' does not exist in the json spec"
-      ],
-      "response": []
-    },
-    "ilm.start": {
-      "request": [
-        "Request: query parameter 'master_timeout' does not exist in the json spec",
-        "Request: query parameter 'timeout' does not exist in the json spec"
-      ],
-      "response": []
-    },
-    "ilm.stop": {
-      "request": [
-        "Request: query parameter 'master_timeout' does not exist in the json spec",
-        "Request: query parameter 'timeout' does not exist in the json spec"
-      ],
-      "response": []
-    },
-    "ingest.delete_geoip_database": {
-      "request": [
-        "Request: query parameter 'master_timeout' does not exist in the json spec",
-        "Request: query parameter 'timeout' does not exist in the json spec"
-      ],
-      "response": []
-    },
-    "ingest.delete_ip_location_database": {
-      "request": [
-        "Request: query parameter 'master_timeout' does not exist in the json spec",
-        "Request: query parameter 'timeout' does not exist in the json spec"
-      ],
-      "response": []
-    },
-    "ingest.put_geoip_database": {
-      "request": [
-        "Request: query parameter 'master_timeout' does not exist in the json spec",
-        "Request: query parameter 'timeout' does not exist in the json spec"
-      ],
-      "response": []
-    },
-    "ingest.put_ip_location_database": {
-      "request": [
-        "Request: query parameter 'master_timeout' does not exist in the json spec",
-        "Request: query parameter 'timeout' does not exist in the json spec"
-      ],
-      "response": []
-    },
     "ml.stop_datafeed": {
       "request": [
         "Request: missing json spec query parameter 'allow_no_datafeeds'"
       ],
       "response": []
-    },
-    "msearch": {
-      "request": [
-        "Request: query parameter 'allow_no_indices' does not exist in the json spec",
-        "Request: query parameter 'expand_wildcards' does not exist in the json spec",
-        "Request: query parameter 'ignore_throttled' does not exist in the json spec",
-        "Request: query parameter 'ignore_unavailable' does not exist in the json spec",
-        "Request: query parameter 'include_named_queries_score' does not exist in the json spec",
-        "Request: query parameter 'index' does not exist in the json spec",
-        "Request: query parameter 'routing' does not exist in the json spec"
-      ],
-      "response": []
     }
   },
   "generalErrors": [
diff --git a/specification/_json_spec/esql.async_query_get.json b/specification/_json_spec/esql.async_query_get.json
@@ -24,6 +24,10 @@
       ]
     },
     "params": {
+      "format": {
+        "type": "string",
+        "description": "a short version of the Accept header, e.g. json, yaml"
+      },
       "wait_for_completion_timeout": {
         "type": "time",
         "description": "Specify the time that the request should block waiting for the final response"
diff --git a/specification/_json_spec/ilm.delete_lifecycle.json b/specification/_json_spec/ilm.delete_lifecycle.json
@@ -23,6 +23,15 @@
         }
       ]
     },
-    "params": {}
+    "params": {
+      "master_timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout for connection to master node"
+      },
+      "timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout"
+      }
+    }
   }
 }
diff --git a/specification/_json_spec/ilm.explain_lifecycle.json b/specification/_json_spec/ilm.explain_lifecycle.json
@@ -31,6 +31,10 @@
       "only_errors": {
         "type": "boolean",
         "description": "filters the indices included in the response to ones in an ILM error state, implies only_managed"
+      },
+      "master_timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout for connection to master node"
       }
     }
   }
diff --git a/specification/_json_spec/ilm.get_lifecycle.json b/specification/_json_spec/ilm.get_lifecycle.json
@@ -27,6 +27,15 @@
         }
       ]
     },
-    "params": {}
+    "params": {
+      "master_timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout for connection to master node"
+      },
+      "timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout"
+      }
+    }
   }
 }
diff --git a/specification/_json_spec/ilm.put_lifecycle.json b/specification/_json_spec/ilm.put_lifecycle.json
@@ -24,7 +24,16 @@
         }
       ]
     },
-    "params": {},
+    "params": {
+      "master_timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout for connection to master node"
+      },
+      "timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout"
+      }
+    },
     "body": {
       "description": "The lifecycle policy definition to register"
     }
diff --git a/specification/_json_spec/ilm.start.json b/specification/_json_spec/ilm.start.json
@@ -17,6 +17,15 @@
         }
       ]
     },
-    "params": {}
+    "params": {
+      "master_timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout for connection to master node"
+      },
+      "timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout"
+      }
+    }
   }
 }
diff --git a/specification/_json_spec/ilm.stop.json b/specification/_json_spec/ilm.stop.json
@@ -17,6 +17,15 @@
         }
       ]
     },
-    "params": {}
+    "params": {
+      "master_timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout for connection to master node"
+      },
+      "timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout"
+      }
+    }
   }
 }
diff --git a/specification/_json_spec/ingest.delete_geoip_database.json b/specification/_json_spec/ingest.delete_geoip_database.json
@@ -23,6 +23,15 @@
         }
       ]
     },
-    "params": {}
+    "params": {
+      "master_timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout for connection to master node"
+      },
+      "timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout"
+      }
+    }
   }
 }
diff --git a/specification/_json_spec/ingest.delete_ip_location_database.json b/specification/_json_spec/ingest.delete_ip_location_database.json
@@ -23,6 +23,15 @@
         }
       ]
     },
-    "params": {}
+    "params": {
+      "master_timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout for connection to master node"
+      },
+      "timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout"
+      }
+    }
   }
 }
diff --git a/specification/_json_spec/ingest.put_geoip_database.json b/specification/_json_spec/ingest.put_geoip_database.json
@@ -24,7 +24,16 @@
         }
       ]
     },
-    "params": {},
+    "params": {
+      "master_timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout for connection to master node"
+      },
+      "timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout"
+      }
+    },
     "body": {
       "description": "The database configuration definition",
       "required": true
diff --git a/specification/_json_spec/ingest.put_ip_location_database.json b/specification/_json_spec/ingest.put_ip_location_database.json
@@ -24,7 +24,16 @@
         }
       ]
     },
-    "params": {},
+    "params": {
+      "master_timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout for connection to master node"
+      },
+      "timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout"
+      }
+    },
     "body": {
       "description": "The database configuration definition",
       "required": true
diff --git a/specification/_json_spec/msearch.json b/specification/_json_spec/msearch.json
@@ -60,6 +60,38 @@
         "type": "boolean",
         "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution",
         "default": "true"
+      },
+      "index": {
+        "type": "list",
+        "description": "A comma-separated list of index names to use as default"
+      },
+      "ignore_unavailable": {
+        "type": "boolean",
+        "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)"
+      },
+      "ignore_throttled": {
+        "type": "boolean",
+        "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled",
+        "deprecated": true
+      },
+      "allow_no_indices": {
+        "type": "boolean",
+        "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)"
+      },
+      "expand_wildcards": {
+        "type": "enum",
+        "options": ["open", "closed", "hidden", "none", "all"],
+        "default": "open",
+        "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both."
+      },
+      "routing": {
+        "type": "list",
+        "description": "A comma-separated list of specific routing values"
+      },
+      "include_named_queries_score": {
+        "type": "boolean",
+        "description": "Indicates whether hit.matched_queries should be rendered as a map that includes the name of the matched query associated with its score (true) or as an array containing the name of the matched queries (false)",
+        "default": false
       }
     },
     "body": {

Original file line number	Diff line number	Diff line change
`@@ -23,6 +23,15 @@`
`23`	`23`	`}`
`24`	`24`	`]`
`25`	`25`	`},`
`26`		`- "params": {}`
	`26`	`+ "params": {`
	`27`	`+ "master_timeout": {`
	`28`	`+ "type": "time",`
	`29`	`+ "description": "Explicit operation timeout for connection to master node"`
	`30`	`+ },`
	`31`	`+ "timeout": {`
	`32`	`+ "type": "time",`
	`33`	`+ "description": "Explicit operation timeout"`
	`34`	`+ }`
	`35`	`+ }`
`27`	`36`	`}`
`28`	`37`	`}`
Original file line number	Diff line number	Diff line change
`@@ -31,6 +31,10 @@`
`31`	`31`	`"only_errors": {`
`32`	`32`	`"type": "boolean",`
`33`	`33`	`"description": "filters the indices included in the response to ones in an ILM error state, implies only_managed"`
	`34`	`+ },`
	`35`	`+ "master_timeout": {`
	`36`	`+ "type": "time",`
	`37`	`+ "description": "Explicit operation timeout for connection to master node"`
`34`	`38`	`}`
`35`	`39`	`}`
`36`	`40`	`}`
Original file line number	Diff line number	Diff line change
`@@ -27,6 +27,15 @@`
`27`	`27`	`}`
`28`	`28`	`]`
`29`	`29`	`},`
`30`		`- "params": {}`
	`30`	`+ "params": {`
	`31`	`+ "master_timeout": {`
	`32`	`+ "type": "time",`
	`33`	`+ "description": "Explicit operation timeout for connection to master node"`
	`34`	`+ },`
	`35`	`+ "timeout": {`
	`36`	`+ "type": "time",`
	`37`	`+ "description": "Explicit operation timeout"`
	`38`	`+ }`
	`39`	`+ }`
`31`	`40`	`}`
`32`	`41`	`}`
Original file line number	Diff line number	Diff line change
`@@ -24,7 +24,16 @@`
`24`	`24`	`}`
`25`	`25`	`]`
`26`	`26`	`},`
`27`		`- "params": {},`
	`27`	`+ "params": {`
	`28`	`+ "master_timeout": {`
	`29`	`+ "type": "time",`
	`30`	`+ "description": "Explicit operation timeout for connection to master node"`
	`31`	`+ },`
	`32`	`+ "timeout": {`
	`33`	`+ "type": "time",`
	`34`	`+ "description": "Explicit operation timeout"`
	`35`	`+ }`
	`36`	`+ },`
`28`	`37`	`"body": {`
`29`	`38`	`"description": "The lifecycle policy definition to register"`
`30`	`39`	`}`
Original file line number	Diff line number	Diff line change
`@@ -17,6 +17,15 @@`
`17`	`17`	`}`
`18`	`18`	`]`
`19`	`19`	`},`
`20`		`- "params": {}`
	`20`	`+ "params": {`
	`21`	`+ "master_timeout": {`
	`22`	`+ "type": "time",`
	`23`	`+ "description": "Explicit operation timeout for connection to master node"`
	`24`	`+ },`
	`25`	`+ "timeout": {`
	`26`	`+ "type": "time",`
	`27`	`+ "description": "Explicit operation timeout"`
	`28`	`+ }`
	`29`	`+ }`
`21`	`30`	`}`
`22`	`31`	`}`