From d08f75d93551c1e5a949ef4002984851f11d93fc Mon Sep 17 00:00:00 2001
From: Mpdreamz <Mpdreamz@gmail.com>
Date: Tue, 5 Feb 2019 12:54:36 +0100
Subject: [PATCH 01/15] introduce state to the REST API specification

---
 rest-api-spec/README.markdown                             | 8 ++++++++
 .../src/main/resources/rest-api-spec/api/rank_eval.json   | 1 +
 .../rest-api-spec/api/scripts_painless_execute.json       | 1 +
 .../rest-api-spec/api/ccr.delete_auto_follow_pattern.json | 1 +
 .../src/test/resources/rest-api-spec/api/ccr.follow.json  | 1 +
 .../test/resources/rest-api-spec/api/ccr.follow_info.json | 1 +
 .../resources/rest-api-spec/api/ccr.follow_stats.json     | 1 +
 .../rest-api-spec/api/ccr.get_auto_follow_pattern.json    | 1 +
 .../resources/rest-api-spec/api/ccr.pause_follow.json     | 1 +
 .../rest-api-spec/api/ccr.put_auto_follow_pattern.json    | 1 +
 .../resources/rest-api-spec/api/ccr.resume_follow.json    | 1 +
 .../src/test/resources/rest-api-spec/api/ccr.stats.json   | 1 +
 .../test/resources/rest-api-spec/api/ccr.unfollow.json    | 1 +
 .../rest-api-spec/api/ml.find_file_structure.json         | 1 +
 .../test/resources/rest-api-spec/api/monitoring.bulk.json | 1 +
 .../resources/rest-api-spec/api/rollup.delete_job.json    | 1 +
 .../test/resources/rest-api-spec/api/rollup.get_jobs.json | 1 +
 .../rest-api-spec/api/rollup.get_rollup_caps.json         | 1 +
 .../rest-api-spec/api/rollup.get_rollup_index_caps.json   | 1 +
 .../test/resources/rest-api-spec/api/rollup.put_job.json  | 1 +
 .../resources/rest-api-spec/api/rollup.rollup_search.json | 1 +
 .../resources/rest-api-spec/api/rollup.start_job.json     | 1 +
 .../test/resources/rest-api-spec/api/rollup.stop_job.json | 1 +
 .../resources/rest-api-spec/api/sql.clear_cursor.json     | 1 +
 .../src/test/resources/rest-api-spec/api/sql.query.json   | 1 +
 .../test/resources/rest-api-spec/api/sql.translate.json   | 1 +
 26 files changed, 33 insertions(+)

diff --git a/rest-api-spec/README.markdown b/rest-api-spec/README.markdown
index 56b5e9b553b83..c99ae530e1f1c 100644
--- a/rest-api-spec/README.markdown
+++ b/rest-api-spec/README.markdown
@@ -10,6 +10,7 @@ Example for the ["Create Index"](http://www.elastic.co/guide/en/elasticsearch/re
 {
   "indices.create": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-create-index.html",
+    "state": "stable",
     "methods": ["PUT", "POST"],
     "url": {
       "path": "/{index}",
@@ -39,10 +40,17 @@ The specification contains:
 
 * The _name_ of the API (`indices.create`), which usually corresponds to the client calls
 * Link to the documentation at <http://elastic.co>
+* `state` indicating the state of the API, defaults to `stable`
+    * `private` this API should not be be implemented by clients
+    * `experimental` highly likely to break in the near future (minor/path), no bwc guarantees. 
+    Possibly removed in the future.
+    * `beta` less likely to break or be removed but still reserve the right to do so
+    * `stable` No backwards breaking changes in a minor (default if not specified)
 * List of HTTP methods for the endpoint
 * URL specification: path, parts, parameters
 * Whether body is allowed for the endpoint or not and its description
 
+
 The `methods` and `url.paths` elements list all possible HTTP methods and URLs for the endpoint;
 it is the responsibility of the developer to use this information for a sensible API on the target platform.
 
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/rank_eval.json b/rest-api-spec/src/main/resources/rest-api-spec/api/rank_eval.json
index 5c9cebf741135..2891a626e72ca 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/rank_eval.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/rank_eval.json
@@ -1,6 +1,7 @@
 {
   "rank_eval": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/search-rank-eval.html",
+    "state" : "experimental",
     "methods": ["GET", "POST"],
     "url": {
       "path": "/_rank_eval",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/scripts_painless_execute.json b/rest-api-spec/src/main/resources/rest-api-spec/api/scripts_painless_execute.json
index c02627cfd874c..4f9d811fb87e0 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/scripts_painless_execute.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/scripts_painless_execute.json
@@ -1,6 +1,7 @@
 {
   "scripts_painless_execute": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/painless/master/painless-execute-api.html",
+    "state" : "experimental",
     "methods": ["GET", "POST"],
     "url": {
       "path": "/_scripts/painless/_execute",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.delete_auto_follow_pattern.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.delete_auto_follow_pattern.json
index 735387b173b73..3d33fa1fb4e5a 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.delete_auto_follow_pattern.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.delete_auto_follow_pattern.json
@@ -1,6 +1,7 @@
 {
   "ccr.delete_auto_follow_pattern": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-delete-auto-follow-pattern.html",
+    "state" : "beta",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_ccr/auto_follow/{name}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow.json
index 588dd60261252..b4f393e61f093 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow.json
@@ -1,6 +1,7 @@
 {
   "ccr.follow": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-put-follow.html",
+    "state" : "beta",
     "methods": [ "PUT" ],
     "url": {
       "path": "/{index}/_ccr/follow",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_info.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_info.json
index 87fd387edc13a..0286f9dc0d99c 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_info.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_info.json
@@ -1,6 +1,7 @@
 {
   "ccr.follow_info": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-get-follow-info.html",
+    "state" : "beta",
     "methods": [ "GET" ],
     "url": {
       "path": "/{index}/_ccr/info",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_stats.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_stats.json
index de4bb66056bb3..66b889a4eed4e 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_stats.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_stats.json
@@ -1,6 +1,7 @@
 {
   "ccr.follow_stats": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-get-follow-stats.html",
+    "state" : "beta",
     "methods": [ "GET" ],
     "url": {
       "path": "/{index}/_ccr/stats",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.get_auto_follow_pattern.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.get_auto_follow_pattern.json
index 6aea678fc004b..48fc1f8088c0d 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.get_auto_follow_pattern.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.get_auto_follow_pattern.json
@@ -1,6 +1,7 @@
 {
   "ccr.get_auto_follow_pattern": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-get-auto-follow-pattern.html",
+    "state" : "beta",
     "methods": [ "GET" ],
     "url": {
       "path": "/_ccr/auto_follow/{name}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.pause_follow.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.pause_follow.json
index e128dab917ca4..52696e98cf341 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.pause_follow.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.pause_follow.json
@@ -1,6 +1,7 @@
 {
   "ccr.pause_follow": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-post-pause-follow.html",
+    "state" : "beta",
     "methods": [ "POST" ],
     "url": {
       "path": "/{index}/_ccr/pause_follow",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.put_auto_follow_pattern.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.put_auto_follow_pattern.json
index 128b262ec7a50..886eebb33a858 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.put_auto_follow_pattern.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.put_auto_follow_pattern.json
@@ -1,6 +1,7 @@
 {
   "ccr.put_auto_follow_pattern": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-put-auto-follow-pattern.html",
+    "state" : "beta",
     "methods": [ "PUT" ],
     "url": {
       "path": "/_ccr/auto_follow/{name}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.resume_follow.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.resume_follow.json
index 61e3b8580fc2c..bf30fac570dc1 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.resume_follow.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.resume_follow.json
@@ -1,6 +1,7 @@
 {
   "ccr.resume_follow": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-post-resume-follow.html",
+    "state" : "beta",
     "methods": [ "POST" ],
     "url": {
       "path": "/{index}/_ccr/resume_follow",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.stats.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.stats.json
index ad9ab49bcbe46..13ed02b7f2b22 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.stats.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.stats.json
@@ -1,6 +1,7 @@
 {
   "ccr.stats": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-get-stats.html",
+    "state" : "beta",
     "methods": [ "GET" ],
     "url": {
       "path": "/_ccr/stats",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.unfollow.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.unfollow.json
index 41be574421fc6..2bbc736753e25 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.unfollow.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.unfollow.json
@@ -1,6 +1,7 @@
 {
   "ccr.unfollow": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current",
+    "state" : "beta",
     "methods": [ "POST" ],
     "url": {
       "path": "/{index}/_ccr/unfollow",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.find_file_structure.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.find_file_structure.json
index 4e5550ae824a9..72bcf880a43ef 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.find_file_structure.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.find_file_structure.json
@@ -1,6 +1,7 @@
 {
   "ml.find_file_structure": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-find-file-structure.html",
+    "state" : "experimental",
     "methods": [ "POST" ],
     "url": {
       "path": "/_ml/find_file_structure",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/monitoring.bulk.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/monitoring.bulk.json
index 78a6017cba2e6..9006774ffbc5f 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/monitoring.bulk.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/monitoring.bulk.json
@@ -1,6 +1,7 @@
 {
   "monitoring.bulk": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/es-monitoring.html",
+    "state" : "private",
     "methods": ["POST", "PUT"],
     "url": {
       "path": "/_monitoring/bulk",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.delete_job.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.delete_job.json
index e03cd2ae977b9..59f9c7db2f1ba 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.delete_job.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.delete_job.json
@@ -1,6 +1,7 @@
 {
   "rollup.delete_job": {
     "documentation": "",
+    "state" : "experimental",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_rollup/job/{id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_jobs.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_jobs.json
index aa5d56e590910..1f6f1fe1b1253 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_jobs.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_jobs.json
@@ -1,6 +1,7 @@
 {
   "rollup.get_jobs": {
     "documentation": "",
+    "state" : "experimental",
     "methods": [ "GET" ],
     "url": {
       "path": "/_rollup/job/{id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_rollup_caps.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_rollup_caps.json
index 0fd8aa3168222..6b3c80c8e0439 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_rollup_caps.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_rollup_caps.json
@@ -1,6 +1,7 @@
 {
   "rollup.get_rollup_caps": {
     "documentation": "",
+    "state" : "experimental",
     "methods": [ "GET" ],
     "url": {
       "path": "/_rollup/data/{id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_rollup_index_caps.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_rollup_index_caps.json
index c446f29e7591b..ea87ef6014cc7 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_rollup_index_caps.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_rollup_index_caps.json
@@ -1,6 +1,7 @@
 {
   "rollup.get_rollup_index_caps": {
     "documentation": "",
+    "state" : "experimental",
     "methods": [ "GET" ],
     "url": {
       "path": "/{index}/_rollup/data",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.put_job.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.put_job.json
index ca33affd7d8a6..425e086130be8 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.put_job.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.put_job.json
@@ -1,6 +1,7 @@
 {
   "rollup.put_job": {
     "documentation": "",
+    "state" : "experimental",
     "methods": [ "PUT" ],
     "url": {
       "path": "/_rollup/job/{id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.rollup_search.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.rollup_search.json
index 0eeb7b29256cf..6de4f8be455b7 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.rollup_search.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.rollup_search.json
@@ -1,6 +1,7 @@
 {
   "rollup.rollup_search": {
     "documentation": "",
+    "state" : "experimental",
     "methods": [ "GET", "POST" ],
     "url": {
       "path": "/{index}/_rollup_search",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.start_job.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.start_job.json
index 8ee505b195b22..5e1a12f141440 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.start_job.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.start_job.json
@@ -1,6 +1,7 @@
 {
   "rollup.start_job": {
     "documentation": "",
+    "state" : "experimental",
     "methods": [ "POST" ],
     "url": {
       "path": "/_rollup/job/{id}/_start",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.stop_job.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.stop_job.json
index 152b72945800d..5d4e0663a12aa 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.stop_job.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.stop_job.json
@@ -1,6 +1,7 @@
 {
   "rollup.stop_job": {
     "documentation": "",
+    "state" : "experimental",
     "methods": [ "POST" ],
     "url": {
       "path": "/_rollup/job/{id}/_stop",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.clear_cursor.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.clear_cursor.json
index ec84f9543bfe0..00e0e86a1f105 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.clear_cursor.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.clear_cursor.json
@@ -1,6 +1,7 @@
 {
   "sql.clear_cursor": {
     "documentation": "Clear SQL cursor",
+    "state" : "beta",
     "methods": [ "POST"],
     "url": {
       "path": "/_sql/close",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.query.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.query.json
index c12a876e8cd32..96914a6a88314 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.query.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.query.json
@@ -1,6 +1,7 @@
 {
     "sql.query": {
       "documentation": "Execute SQL",
+      "state" : "beta",
       "methods": [ "POST", "GET" ],
       "url": {
         "path": "/_sql",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.translate.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.translate.json
index 2200a61be66b2..5bbcd745d8cd4 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.translate.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.translate.json
@@ -1,6 +1,7 @@
 {
     "sql.translate": {
       "documentation": "Translate SQL into Elasticsearch queries",
+      "state" : "beta",
       "methods": [ "POST", "GET" ],
       "url": {
         "path": "/_sql/translate",

From 01faf3357d351f8ff84c7b8656e2ef8e790d8007 Mon Sep 17 00:00:00 2001
From: Mpdreamz <Mpdreamz@gmail.com>
Date: Wed, 13 Feb 2019 18:01:35 +0100
Subject: [PATCH 02/15] change state over to stability

---
 rest-api-spec/README.markdown                                 | 4 ++--
 .../src/main/resources/rest-api-spec/api/rank_eval.json       | 2 +-
 .../resources/rest-api-spec/api/scripts_painless_execute.json | 2 +-
 .../rest-api-spec/api/ccr.delete_auto_follow_pattern.json     | 2 +-
 .../src/test/resources/rest-api-spec/api/ccr.follow.json      | 2 +-
 .../src/test/resources/rest-api-spec/api/ccr.follow_info.json | 2 +-
 .../test/resources/rest-api-spec/api/ccr.follow_stats.json    | 2 +-
 .../rest-api-spec/api/ccr.get_auto_follow_pattern.json        | 2 +-
 .../test/resources/rest-api-spec/api/ccr.pause_follow.json    | 2 +-
 .../rest-api-spec/api/ccr.put_auto_follow_pattern.json        | 2 +-
 .../test/resources/rest-api-spec/api/ccr.resume_follow.json   | 2 +-
 .../src/test/resources/rest-api-spec/api/ccr.stats.json       | 2 +-
 .../src/test/resources/rest-api-spec/api/ccr.unfollow.json    | 2 +-
 .../resources/rest-api-spec/api/ml.find_file_structure.json   | 2 +-
 .../src/test/resources/rest-api-spec/api/monitoring.bulk.json | 2 +-
 .../test/resources/rest-api-spec/api/rollup.delete_job.json   | 2 +-
 .../src/test/resources/rest-api-spec/api/rollup.get_jobs.json | 2 +-
 .../resources/rest-api-spec/api/rollup.get_rollup_caps.json   | 2 +-
 .../rest-api-spec/api/rollup.get_rollup_index_caps.json       | 2 +-
 .../src/test/resources/rest-api-spec/api/rollup.put_job.json  | 2 +-
 .../resources/rest-api-spec/api/rollup.rollup_search.json     | 2 +-
 .../test/resources/rest-api-spec/api/rollup.start_job.json    | 2 +-
 .../src/test/resources/rest-api-spec/api/rollup.stop_job.json | 2 +-
 .../test/resources/rest-api-spec/api/sql.clear_cursor.json    | 2 +-
 .../src/test/resources/rest-api-spec/api/sql.query.json       | 2 +-
 .../src/test/resources/rest-api-spec/api/sql.translate.json   | 2 +-
 26 files changed, 27 insertions(+), 27 deletions(-)

diff --git a/rest-api-spec/README.markdown b/rest-api-spec/README.markdown
index c99ae530e1f1c..2c6d925fa4bb9 100644
--- a/rest-api-spec/README.markdown
+++ b/rest-api-spec/README.markdown
@@ -10,7 +10,7 @@ Example for the ["Create Index"](http://www.elastic.co/guide/en/elasticsearch/re
 {
   "indices.create": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-create-index.html",
-    "state": "stable",
+    "stability": "stable",
     "methods": ["PUT", "POST"],
     "url": {
       "path": "/{index}",
@@ -40,7 +40,7 @@ The specification contains:
 
 * The _name_ of the API (`indices.create`), which usually corresponds to the client calls
 * Link to the documentation at <http://elastic.co>
-* `state` indicating the state of the API, defaults to `stable`
+* `stability` indicating the state of the API, defaults to `stable`
     * `private` this API should not be be implemented by clients
     * `experimental` highly likely to break in the near future (minor/path), no bwc guarantees. 
     Possibly removed in the future.
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/rank_eval.json b/rest-api-spec/src/main/resources/rest-api-spec/api/rank_eval.json
index 2891a626e72ca..6a4897c55885c 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/rank_eval.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/rank_eval.json
@@ -1,7 +1,7 @@
 {
   "rank_eval": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/search-rank-eval.html",
-    "state" : "experimental",
+    "stability" : "experimental",
     "methods": ["GET", "POST"],
     "url": {
       "path": "/_rank_eval",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/scripts_painless_execute.json b/rest-api-spec/src/main/resources/rest-api-spec/api/scripts_painless_execute.json
index 4f9d811fb87e0..de07968c6cb8d 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/scripts_painless_execute.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/scripts_painless_execute.json
@@ -1,7 +1,7 @@
 {
   "scripts_painless_execute": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/painless/master/painless-execute-api.html",
-    "state" : "experimental",
+    "stability" : "experimental",
     "methods": ["GET", "POST"],
     "url": {
       "path": "/_scripts/painless/_execute",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.delete_auto_follow_pattern.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.delete_auto_follow_pattern.json
index 3d33fa1fb4e5a..0092b31973603 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.delete_auto_follow_pattern.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.delete_auto_follow_pattern.json
@@ -1,7 +1,7 @@
 {
   "ccr.delete_auto_follow_pattern": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-delete-auto-follow-pattern.html",
-    "state" : "beta",
+    "stability" : "beta",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_ccr/auto_follow/{name}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow.json
index b4f393e61f093..36fff7a18a9f1 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow.json
@@ -1,7 +1,7 @@
 {
   "ccr.follow": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-put-follow.html",
-    "state" : "beta",
+    "stability" : "beta",
     "methods": [ "PUT" ],
     "url": {
       "path": "/{index}/_ccr/follow",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_info.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_info.json
index 0286f9dc0d99c..b18d89bfcd4ec 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_info.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_info.json
@@ -1,7 +1,7 @@
 {
   "ccr.follow_info": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-get-follow-info.html",
-    "state" : "beta",
+    "stability" : "beta",
     "methods": [ "GET" ],
     "url": {
       "path": "/{index}/_ccr/info",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_stats.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_stats.json
index 66b889a4eed4e..275ec7661b825 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_stats.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_stats.json
@@ -1,7 +1,7 @@
 {
   "ccr.follow_stats": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-get-follow-stats.html",
-    "state" : "beta",
+    "stability" : "beta",
     "methods": [ "GET" ],
     "url": {
       "path": "/{index}/_ccr/stats",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.get_auto_follow_pattern.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.get_auto_follow_pattern.json
index 48fc1f8088c0d..d82fd098ff61d 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.get_auto_follow_pattern.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.get_auto_follow_pattern.json
@@ -1,7 +1,7 @@
 {
   "ccr.get_auto_follow_pattern": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-get-auto-follow-pattern.html",
-    "state" : "beta",
+    "stability" : "beta",
     "methods": [ "GET" ],
     "url": {
       "path": "/_ccr/auto_follow/{name}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.pause_follow.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.pause_follow.json
index 52696e98cf341..e4500c566c4be 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.pause_follow.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.pause_follow.json
@@ -1,7 +1,7 @@
 {
   "ccr.pause_follow": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-post-pause-follow.html",
-    "state" : "beta",
+    "stability" : "beta",
     "methods": [ "POST" ],
     "url": {
       "path": "/{index}/_ccr/pause_follow",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.put_auto_follow_pattern.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.put_auto_follow_pattern.json
index 886eebb33a858..74144e55acd09 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.put_auto_follow_pattern.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.put_auto_follow_pattern.json
@@ -1,7 +1,7 @@
 {
   "ccr.put_auto_follow_pattern": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-put-auto-follow-pattern.html",
-    "state" : "beta",
+    "stability" : "beta",
     "methods": [ "PUT" ],
     "url": {
       "path": "/_ccr/auto_follow/{name}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.resume_follow.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.resume_follow.json
index bf30fac570dc1..f267c621375c0 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.resume_follow.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.resume_follow.json
@@ -1,7 +1,7 @@
 {
   "ccr.resume_follow": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-post-resume-follow.html",
-    "state" : "beta",
+    "stability" : "beta",
     "methods": [ "POST" ],
     "url": {
       "path": "/{index}/_ccr/resume_follow",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.stats.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.stats.json
index 13ed02b7f2b22..e47c4d639149c 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.stats.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.stats.json
@@ -1,7 +1,7 @@
 {
   "ccr.stats": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-get-stats.html",
-    "state" : "beta",
+    "stability" : "beta",
     "methods": [ "GET" ],
     "url": {
       "path": "/_ccr/stats",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.unfollow.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.unfollow.json
index 2bbc736753e25..060d20fb2a889 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.unfollow.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.unfollow.json
@@ -1,7 +1,7 @@
 {
   "ccr.unfollow": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current",
-    "state" : "beta",
+    "stability" : "beta",
     "methods": [ "POST" ],
     "url": {
       "path": "/{index}/_ccr/unfollow",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.find_file_structure.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.find_file_structure.json
index 72bcf880a43ef..8f40ce3425f91 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.find_file_structure.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.find_file_structure.json
@@ -1,7 +1,7 @@
 {
   "ml.find_file_structure": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-find-file-structure.html",
-    "state" : "experimental",
+    "stability" : "experimental",
     "methods": [ "POST" ],
     "url": {
       "path": "/_ml/find_file_structure",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/monitoring.bulk.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/monitoring.bulk.json
index 9006774ffbc5f..fb37efb7cd614 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/monitoring.bulk.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/monitoring.bulk.json
@@ -1,7 +1,7 @@
 {
   "monitoring.bulk": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/es-monitoring.html",
-    "state" : "private",
+    "stability" : "private",
     "methods": ["POST", "PUT"],
     "url": {
       "path": "/_monitoring/bulk",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.delete_job.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.delete_job.json
index 59f9c7db2f1ba..adb8e381cde5e 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.delete_job.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.delete_job.json
@@ -1,7 +1,7 @@
 {
   "rollup.delete_job": {
     "documentation": "",
-    "state" : "experimental",
+    "stability" : "experimental",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_rollup/job/{id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_jobs.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_jobs.json
index 1f6f1fe1b1253..5f6f91275ceed 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_jobs.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_jobs.json
@@ -1,7 +1,7 @@
 {
   "rollup.get_jobs": {
     "documentation": "",
-    "state" : "experimental",
+    "stability" : "experimental",
     "methods": [ "GET" ],
     "url": {
       "path": "/_rollup/job/{id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_rollup_caps.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_rollup_caps.json
index 6b3c80c8e0439..bfa185b57c4a7 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_rollup_caps.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_rollup_caps.json
@@ -1,7 +1,7 @@
 {
   "rollup.get_rollup_caps": {
     "documentation": "",
-    "state" : "experimental",
+    "stability" : "experimental",
     "methods": [ "GET" ],
     "url": {
       "path": "/_rollup/data/{id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_rollup_index_caps.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_rollup_index_caps.json
index ea87ef6014cc7..5fbedef7fe9ab 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_rollup_index_caps.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.get_rollup_index_caps.json
@@ -1,7 +1,7 @@
 {
   "rollup.get_rollup_index_caps": {
     "documentation": "",
-    "state" : "experimental",
+    "stability" : "experimental",
     "methods": [ "GET" ],
     "url": {
       "path": "/{index}/_rollup/data",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.put_job.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.put_job.json
index 425e086130be8..1b1f6551fda09 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.put_job.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.put_job.json
@@ -1,7 +1,7 @@
 {
   "rollup.put_job": {
     "documentation": "",
-    "state" : "experimental",
+    "stability" : "experimental",
     "methods": [ "PUT" ],
     "url": {
       "path": "/_rollup/job/{id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.rollup_search.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.rollup_search.json
index 6de4f8be455b7..ee5a9c7323476 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.rollup_search.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.rollup_search.json
@@ -1,7 +1,7 @@
 {
   "rollup.rollup_search": {
     "documentation": "",
-    "state" : "experimental",
+    "stability" : "experimental",
     "methods": [ "GET", "POST" ],
     "url": {
       "path": "/{index}/_rollup_search",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.start_job.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.start_job.json
index 5e1a12f141440..c4a590d314817 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.start_job.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.start_job.json
@@ -1,7 +1,7 @@
 {
   "rollup.start_job": {
     "documentation": "",
-    "state" : "experimental",
+    "stability" : "experimental",
     "methods": [ "POST" ],
     "url": {
       "path": "/_rollup/job/{id}/_start",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.stop_job.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.stop_job.json
index 5d4e0663a12aa..f7d766a5807ac 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.stop_job.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/rollup.stop_job.json
@@ -1,7 +1,7 @@
 {
   "rollup.stop_job": {
     "documentation": "",
-    "state" : "experimental",
+    "stability" : "experimental",
     "methods": [ "POST" ],
     "url": {
       "path": "/_rollup/job/{id}/_stop",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.clear_cursor.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.clear_cursor.json
index 00e0e86a1f105..3721a07880800 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.clear_cursor.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.clear_cursor.json
@@ -1,7 +1,7 @@
 {
   "sql.clear_cursor": {
     "documentation": "Clear SQL cursor",
-    "state" : "beta",
+    "stability" : "beta",
     "methods": [ "POST"],
     "url": {
       "path": "/_sql/close",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.query.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.query.json
index 96914a6a88314..4630ca5afcd05 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.query.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.query.json
@@ -1,7 +1,7 @@
 {
     "sql.query": {
       "documentation": "Execute SQL",
-      "state" : "beta",
+      "stability" : "beta",
       "methods": [ "POST", "GET" ],
       "url": {
         "path": "/_sql",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.translate.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.translate.json
index 5bbcd745d8cd4..82b96c68498ed 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.translate.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.translate.json
@@ -1,7 +1,7 @@
 {
     "sql.translate": {
       "documentation": "Translate SQL into Elasticsearch queries",
-      "state" : "beta",
+      "stability" : "beta",
       "methods": [ "POST", "GET" ],
       "url": {
         "path": "/_sql/translate",

From b6d7e639186ea993a9e82881678d106a9dc99153 Mon Sep 17 00:00:00 2001
From: Mpdreamz <Mpdreamz@gmail.com>
Date: Mon, 8 Apr 2019 15:24:18 +0200
Subject: [PATCH 03/15] CCR is no GA updated to stable

---
 .../rest-api-spec/api/ccr.delete_auto_follow_pattern.json       | 2 +-
 .../plugin/src/test/resources/rest-api-spec/api/ccr.follow.json | 2 +-
 .../src/test/resources/rest-api-spec/api/ccr.follow_info.json   | 2 +-
 .../src/test/resources/rest-api-spec/api/ccr.follow_stats.json  | 2 +-
 .../test/resources/rest-api-spec/api/ccr.forget_follower.json   | 1 +
 .../rest-api-spec/api/ccr.get_auto_follow_pattern.json          | 2 +-
 .../src/test/resources/rest-api-spec/api/ccr.pause_follow.json  | 2 +-
 .../rest-api-spec/api/ccr.put_auto_follow_pattern.json          | 2 +-
 .../src/test/resources/rest-api-spec/api/ccr.resume_follow.json | 2 +-
 .../plugin/src/test/resources/rest-api-spec/api/ccr.stats.json  | 2 +-
 .../src/test/resources/rest-api-spec/api/ccr.unfollow.json      | 2 +-
 11 files changed, 11 insertions(+), 10 deletions(-)

diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.delete_auto_follow_pattern.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.delete_auto_follow_pattern.json
index 0092b31973603..7ca90b47dad45 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.delete_auto_follow_pattern.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.delete_auto_follow_pattern.json
@@ -1,7 +1,7 @@
 {
   "ccr.delete_auto_follow_pattern": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-delete-auto-follow-pattern.html",
-    "stability" : "beta",
+    "stability" : "stable",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_ccr/auto_follow/{name}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow.json
index 36fff7a18a9f1..bb44184d429b0 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow.json
@@ -1,7 +1,7 @@
 {
   "ccr.follow": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-put-follow.html",
-    "stability" : "beta",
+    "stability" : "stable",
     "methods": [ "PUT" ],
     "url": {
       "path": "/{index}/_ccr/follow",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_info.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_info.json
index b18d89bfcd4ec..ae3e5d2cd7707 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_info.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_info.json
@@ -1,7 +1,7 @@
 {
   "ccr.follow_info": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-get-follow-info.html",
-    "stability" : "beta",
+    "stability" : "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/{index}/_ccr/info",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_stats.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_stats.json
index 275ec7661b825..94b6064fee4ac 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_stats.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.follow_stats.json
@@ -1,7 +1,7 @@
 {
   "ccr.follow_stats": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-get-follow-stats.html",
-    "stability" : "beta",
+    "stability" : "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/{index}/_ccr/stats",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.forget_follower.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.forget_follower.json
index 92d38e5e999e8..9dbff67e8ead4 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.forget_follower.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.forget_follower.json
@@ -1,6 +1,7 @@
 {
   "ccr.forget_follower": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current",
+    "stability" : "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/{index}/_ccr/forget_follower",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.get_auto_follow_pattern.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.get_auto_follow_pattern.json
index d82fd098ff61d..1db513b74c907 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.get_auto_follow_pattern.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.get_auto_follow_pattern.json
@@ -1,7 +1,7 @@
 {
   "ccr.get_auto_follow_pattern": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-get-auto-follow-pattern.html",
-    "stability" : "beta",
+    "stability" : "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/_ccr/auto_follow/{name}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.pause_follow.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.pause_follow.json
index e4500c566c4be..8904491764468 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.pause_follow.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.pause_follow.json
@@ -1,7 +1,7 @@
 {
   "ccr.pause_follow": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-post-pause-follow.html",
-    "stability" : "beta",
+    "stability" : "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/{index}/_ccr/pause_follow",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.put_auto_follow_pattern.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.put_auto_follow_pattern.json
index 74144e55acd09..b49c4c652d2b8 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.put_auto_follow_pattern.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.put_auto_follow_pattern.json
@@ -1,7 +1,7 @@
 {
   "ccr.put_auto_follow_pattern": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-put-auto-follow-pattern.html",
-    "stability" : "beta",
+    "stability" : "stable",
     "methods": [ "PUT" ],
     "url": {
       "path": "/_ccr/auto_follow/{name}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.resume_follow.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.resume_follow.json
index f267c621375c0..63850635c3176 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.resume_follow.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.resume_follow.json
@@ -1,7 +1,7 @@
 {
   "ccr.resume_follow": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-post-resume-follow.html",
-    "stability" : "beta",
+    "stability" : "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/{index}/_ccr/resume_follow",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.stats.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.stats.json
index e47c4d639149c..a5599a74aa27a 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.stats.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.stats.json
@@ -1,7 +1,7 @@
 {
   "ccr.stats": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-get-stats.html",
-    "stability" : "beta",
+    "stability" : "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/_ccr/stats",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.unfollow.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.unfollow.json
index 060d20fb2a889..6c7762d380fe8 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.unfollow.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ccr.unfollow.json
@@ -1,7 +1,7 @@
 {
   "ccr.unfollow": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current",
-    "stability" : "beta",
+    "stability" : "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/{index}/_ccr/unfollow",

From 9623f0c66feb82417e7a1903d3f01fe0848ccb75 Mon Sep 17 00:00:00 2001
From: Mpdreamz <Mpdreamz@gmail.com>
Date: Mon, 8 Apr 2019 15:26:35 +0200
Subject: [PATCH 04/15] SQL is now GA so marked as stable

---
 .../src/test/resources/rest-api-spec/api/sql.clear_cursor.json  | 2 +-
 .../plugin/src/test/resources/rest-api-spec/api/sql.query.json  | 2 +-
 .../src/test/resources/rest-api-spec/api/sql.translate.json     | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.clear_cursor.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.clear_cursor.json
index 3721a07880800..1a8e6ace8a08d 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.clear_cursor.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.clear_cursor.json
@@ -1,7 +1,7 @@
 {
   "sql.clear_cursor": {
     "documentation": "Clear SQL cursor",
-    "stability" : "beta",
+    "stability" : "stable",
     "methods": [ "POST"],
     "url": {
       "path": "/_sql/close",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.query.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.query.json
index 4630ca5afcd05..64fc2536c0c66 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.query.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.query.json
@@ -1,7 +1,7 @@
 {
     "sql.query": {
       "documentation": "Execute SQL",
-      "stability" : "beta",
+      "stability" : "stable",
       "methods": [ "POST", "GET" ],
       "url": {
         "path": "/_sql",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.translate.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.translate.json
index 82b96c68498ed..f83a9d9a8d97b 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.translate.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/sql.translate.json
@@ -1,7 +1,7 @@
 {
     "sql.translate": {
       "documentation": "Translate SQL into Elasticsearch queries",
-      "stability" : "beta",
+      "stability" : "stable",
       "methods": [ "POST", "GET" ],
       "url": {
         "path": "/_sql/translate",

From 53190760f9f066cd5d1cd04c28ca6e56e31c48a1 Mon Sep 17 00:00:00 2001
From: Mpdreamz <Mpdreamz@gmail.com>
Date: Mon, 8 Apr 2019 15:38:05 +0200
Subject: [PATCH 05/15] Introduce `internal` as state for API's, marks stable
 in terms of lifetime but unstable in terms of guarantees on its output format
 since it exposes internal representations

---
 rest-api-spec/README.markdown                                   | 2 ++
 .../src/main/resources/rest-api-spec/api/cluster.state.json     | 1 +
 2 files changed, 3 insertions(+)

diff --git a/rest-api-spec/README.markdown b/rest-api-spec/README.markdown
index 2c6d925fa4bb9..d6209f5683343 100644
--- a/rest-api-spec/README.markdown
+++ b/rest-api-spec/README.markdown
@@ -45,6 +45,8 @@ The specification contains:
     * `experimental` highly likely to break in the near future (minor/path), no bwc guarantees. 
     Possibly removed in the future.
     * `beta` less likely to break or be removed but still reserve the right to do so
+    * `internal` API that is stable with regards to its lifetime (here to stay) but makes no guarantees towards its
+     output format. Typically used by monitoring API's exposing internal representations.
     * `stable` No backwards breaking changes in a minor (default if not specified)
 * List of HTTP methods for the endpoint
 * URL specification: path, parts, parameters
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.state.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.state.json
index fec3f45000497..4db6f433b3a3d 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.state.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.state.json
@@ -1,6 +1,7 @@
 {
   "cluster.state": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-state.html",
+    "stability" : "internal",
     "methods": ["GET"],
     "url": {
       "path": "/_cluster/state",

From 719f41fb42b539528bb6f09d933a2294804ceaec Mon Sep 17 00:00:00 2001
From: Mpdreamz <Mpdreamz@gmail.com>
Date: Mon, 8 Apr 2019 16:23:49 +0200
Subject: [PATCH 06/15] make setting a wrong stability value, or not setting it
 at all an error that causes the YAML test suite to fail

---
 .../yaml/restspec/ClientYamlSuiteRestApi.java  | 18 +++++++++++++-----
 .../restspec/ClientYamlSuiteRestApiParser.java | 17 +++++++++++++++++
 2 files changed, 30 insertions(+), 5 deletions(-)

diff --git a/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApi.java b/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApi.java
index 72c94762a4314..ff4f0c7179b79 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApi.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApi.java
@@ -21,11 +21,7 @@
 import org.apache.http.client.methods.HttpPost;
 import org.apache.http.client.methods.HttpPut;
 
-import java.util.ArrayList;
-import java.util.HashMap;
-import java.util.List;
-import java.util.Map;
-import java.util.Set;
+import java.util.*;
 
 /**
  * Specification of an Elasticsearch endpoint used by the YAML specs to generate REST requests.
@@ -39,6 +35,12 @@ public class ClientYamlSuiteRestApi {
     private Map<String, Boolean> pathParts = new HashMap<>();
     private Map<String, Boolean> params = new HashMap<>();
     private Body body = Body.NOT_SUPPORTED;
+    private Stability stability = Stability.UNKNOWN;
+
+    public enum Stability
+    {
+        UNKNOWN, PRIVATE, EXPERIMENTAL, BETA, INTERNAL, STABLE
+    }
 
     public enum Body {
         NOT_SUPPORTED, OPTIONAL, REQUIRED
@@ -139,6 +141,12 @@ public boolean isBodyRequired() {
         return body == Body.REQUIRED;
     }
 
+    public void setStability(String stability) {
+        this.stability = ClientYamlSuiteRestApi.Stability.valueOf(stability.toUpperCase(Locale.ROOT));
+    }
+
+    public Stability getStability() { return this.stability; }
+
     /**
      * Finds the best matching rest path given the current parameters and replaces
      * placeholders with their corresponding values received as arguments
diff --git a/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApiParser.java b/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApiParser.java
index 3c6216eed76ed..f7edd1029fb98 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApiParser.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApiParser.java
@@ -23,6 +23,7 @@
 import org.elasticsearch.common.xcontent.XContentParser;
 
 import java.io.IOException;
+import java.util.Locale;
 
 /**
  * Parser for a {@link ClientYamlSuiteRestApi}.
@@ -51,6 +52,18 @@ public ClientYamlSuiteRestApi parse(String location, XContentParser parser) thro
         while (parser.nextToken() != XContentParser.Token.END_OBJECT || level >= 0) {
 
             if (parser.currentToken() == XContentParser.Token.FIELD_NAME) {
+                if ("stability".equals(parser.currentName()))
+                {
+                    parser.nextToken();
+                    String stability = parser.textOrNull();
+                    try {
+                        restApi.setStability(stability);
+                    } catch (IllegalArgumentException ex)
+                    {
+                        throw new IllegalArgumentException("API [" + apiName + "] sets wrong state for stability (" + stability + ") [" + location + "]");
+                    }
+                }
+
                 if ("methods".equals(parser.currentName())) {
                     parser.nextToken();
                     while (parser.nextToken() == XContentParser.Token.VALUE_STRING) {
@@ -144,6 +157,10 @@ public ClientYamlSuiteRestApi parse(String location, XContentParser parser) thro
         assert parser.currentToken() == XContentParser.Token.END_OBJECT : "Expected [END_OBJECT] but was ["  + parser.currentToken() +"]";
         parser.nextToken();
 
+        if (restApi.getStability() == ClientYamlSuiteRestApi.Stability.UNKNOWN) {
+            throw new IllegalArgumentException("API [" + apiName + "] does not explicitly declare its stability in [" + location + "]");
+        }
+
         return restApi;
     }
 

From f4f8b521917a4e97ca865f6117faa1e6e4da0186 Mon Sep 17 00:00:00 2001
From: Mpdreamz <Mpdreamz@gmail.com>
Date: Mon, 8 Apr 2019 17:09:15 +0200
Subject: [PATCH 07/15] update spec files to be explicit about their stability
 state

---
 rest-api-spec/src/main/resources/rest-api-spec/api/bulk.json | 1 +
 .../src/main/resources/rest-api-spec/api/cat.aliases.json    | 1 +
 .../src/main/resources/rest-api-spec/api/cat.allocation.json | 1 +
 .../src/main/resources/rest-api-spec/api/cat.count.json      | 1 +
 .../src/main/resources/rest-api-spec/api/cat.fielddata.json  | 1 +
 .../src/main/resources/rest-api-spec/api/cat.health.json     | 1 +
 .../src/main/resources/rest-api-spec/api/cat.help.json       | 1 +
 .../src/main/resources/rest-api-spec/api/cat.indices.json    | 1 +
 .../src/main/resources/rest-api-spec/api/cat.master.json     | 1 +
 .../src/main/resources/rest-api-spec/api/cat.nodeattrs.json  | 1 +
 .../src/main/resources/rest-api-spec/api/cat.nodes.json      | 1 +
 .../main/resources/rest-api-spec/api/cat.pending_tasks.json  | 1 +
 .../src/main/resources/rest-api-spec/api/cat.plugins.json    | 1 +
 .../src/main/resources/rest-api-spec/api/cat.recovery.json   | 1 +
 .../main/resources/rest-api-spec/api/cat.repositories.json   | 1 +
 .../src/main/resources/rest-api-spec/api/cat.segments.json   | 1 +
 .../src/main/resources/rest-api-spec/api/cat.shards.json     | 1 +
 .../src/main/resources/rest-api-spec/api/cat.snapshots.json  | 1 +
 .../src/main/resources/rest-api-spec/api/cat.tasks.json      | 1 +
 .../src/main/resources/rest-api-spec/api/cat.templates.json  | 1 +
 .../main/resources/rest-api-spec/api/cat.thread_pool.json    | 1 +
 .../src/main/resources/rest-api-spec/api/clear_scroll.json   | 1 +
 .../rest-api-spec/api/cluster.allocation_explain.json        | 1 +
 .../resources/rest-api-spec/api/cluster.get_settings.json    | 1 +
 .../src/main/resources/rest-api-spec/api/cluster.health.json | 1 +
 .../resources/rest-api-spec/api/cluster.pending_tasks.json   | 1 +
 .../resources/rest-api-spec/api/cluster.put_settings.json    | 1 +
 .../resources/rest-api-spec/api/cluster.remote_info.json     | 1 +
 .../main/resources/rest-api-spec/api/cluster.reroute.json    | 1 +
 .../src/main/resources/rest-api-spec/api/cluster.stats.json  | 1 +
 .../src/main/resources/rest-api-spec/api/count.json          | 1 +
 .../src/main/resources/rest-api-spec/api/create.json         | 1 +
 .../src/main/resources/rest-api-spec/api/delete.json         | 1 +
 .../main/resources/rest-api-spec/api/delete_by_query.json    | 1 +
 .../rest-api-spec/api/delete_by_query_rethrottle.json        | 1 +
 .../src/main/resources/rest-api-spec/api/delete_script.json  | 1 +
 .../src/main/resources/rest-api-spec/api/exists.json         | 1 +
 .../src/main/resources/rest-api-spec/api/exists_source.json  | 1 +
 .../src/main/resources/rest-api-spec/api/explain.json        | 1 +
 .../src/main/resources/rest-api-spec/api/field_caps.json     | 1 +
 rest-api-spec/src/main/resources/rest-api-spec/api/get.json  | 1 +
 .../src/main/resources/rest-api-spec/api/get_script.json     | 1 +
 .../src/main/resources/rest-api-spec/api/get_source.json     | 1 +
 .../src/main/resources/rest-api-spec/api/index.json          | 1 +
 .../main/resources/rest-api-spec/api/indices.analyze.json    | 1 +
 .../resources/rest-api-spec/api/indices.clear_cache.json     | 1 +
 .../src/main/resources/rest-api-spec/api/indices.close.json  | 1 +
 .../src/main/resources/rest-api-spec/api/indices.create.json | 1 +
 .../src/main/resources/rest-api-spec/api/indices.delete.json | 1 +
 .../resources/rest-api-spec/api/indices.delete_alias.json    | 1 +
 .../resources/rest-api-spec/api/indices.delete_template.json | 1 +
 .../src/main/resources/rest-api-spec/api/indices.exists.json | 1 +
 .../resources/rest-api-spec/api/indices.exists_alias.json    | 1 +
 .../resources/rest-api-spec/api/indices.exists_template.json | 1 +
 .../resources/rest-api-spec/api/indices.exists_type.json     | 1 +
 .../src/main/resources/rest-api-spec/api/indices.flush.json  | 1 +
 .../resources/rest-api-spec/api/indices.flush_synced.json    | 1 +
 .../main/resources/rest-api-spec/api/indices.forcemerge.json | 1 +
 .../src/main/resources/rest-api-spec/api/indices.get.json    | 1 +
 .../main/resources/rest-api-spec/api/indices.get_alias.json  | 1 +
 .../rest-api-spec/api/indices.get_field_mapping.json         | 1 +
 .../resources/rest-api-spec/api/indices.get_mapping.json     | 1 +
 .../resources/rest-api-spec/api/indices.get_settings.json    | 1 +
 .../resources/rest-api-spec/api/indices.get_template.json    | 1 +
 .../resources/rest-api-spec/api/indices.get_upgrade.json     | 1 +
 .../src/main/resources/rest-api-spec/api/indices.open.json   | 1 +
 .../main/resources/rest-api-spec/api/indices.put_alias.json  | 1 +
 .../resources/rest-api-spec/api/indices.put_mapping.json     | 1 +
 .../resources/rest-api-spec/api/indices.put_settings.json    | 1 +
 .../resources/rest-api-spec/api/indices.put_template.json    | 1 +
 .../main/resources/rest-api-spec/api/indices.recovery.json   | 1 +
 .../main/resources/rest-api-spec/api/indices.refresh.json    | 1 +
 .../main/resources/rest-api-spec/api/indices.rollover.json   | 1 +
 .../main/resources/rest-api-spec/api/indices.segments.json   | 1 +
 .../resources/rest-api-spec/api/indices.shard_stores.json    | 1 +
 .../src/main/resources/rest-api-spec/api/indices.shrink.json | 1 +
 .../src/main/resources/rest-api-spec/api/indices.split.json  | 1 +
 .../src/main/resources/rest-api-spec/api/indices.stats.json  | 1 +
 .../resources/rest-api-spec/api/indices.update_aliases.json  | 1 +
 .../main/resources/rest-api-spec/api/indices.upgrade.json    | 1 +
 .../resources/rest-api-spec/api/indices.validate_query.json  | 1 +
 rest-api-spec/src/main/resources/rest-api-spec/api/info.json | 1 +
 .../resources/rest-api-spec/api/ingest.delete_pipeline.json  | 1 +
 .../resources/rest-api-spec/api/ingest.get_pipeline.json     | 1 +
 .../resources/rest-api-spec/api/ingest.processor_grok.json   | 1 +
 .../resources/rest-api-spec/api/ingest.put_pipeline.json     | 1 +
 .../main/resources/rest-api-spec/api/ingest.simulate.json    | 1 +
 rest-api-spec/src/main/resources/rest-api-spec/api/mget.json | 1 +
 .../src/main/resources/rest-api-spec/api/msearch.json        | 1 +
 .../main/resources/rest-api-spec/api/msearch_template.json   | 1 +
 .../src/main/resources/rest-api-spec/api/mtermvectors.json   | 1 +
 .../main/resources/rest-api-spec/api/nodes.hot_threads.json  | 1 +
 .../src/main/resources/rest-api-spec/api/nodes.info.json     | 1 +
 .../rest-api-spec/api/nodes.reload_secure_settings.json      | 1 +
 .../src/main/resources/rest-api-spec/api/nodes.stats.json    | 1 +
 .../src/main/resources/rest-api-spec/api/nodes.usage.json    | 1 +
 rest-api-spec/src/main/resources/rest-api-spec/api/ping.json | 1 +
 .../src/main/resources/rest-api-spec/api/put_script.json     | 1 +
 .../src/main/resources/rest-api-spec/api/reindex.json        | 1 +
 .../main/resources/rest-api-spec/api/reindex_rethrottle.json | 1 +
 .../resources/rest-api-spec/api/render_search_template.json  | 1 +
 .../rest-api-spec/api/scripts_painless_context.json          | 1 +
 .../src/main/resources/rest-api-spec/api/scroll.json         | 1 +
 .../src/main/resources/rest-api-spec/api/search.json         | 1 +
 .../src/main/resources/rest-api-spec/api/search_shards.json  | 1 +
 .../main/resources/rest-api-spec/api/search_template.json    | 1 +
 .../main/resources/rest-api-spec/api/snapshot.create.json    | 1 +
 .../rest-api-spec/api/snapshot.create_repository.json        | 1 +
 .../main/resources/rest-api-spec/api/snapshot.delete.json    | 1 +
 .../rest-api-spec/api/snapshot.delete_repository.json        | 1 +
 .../src/main/resources/rest-api-spec/api/snapshot.get.json   | 1 +
 .../resources/rest-api-spec/api/snapshot.get_repository.json | 1 +
 .../main/resources/rest-api-spec/api/snapshot.restore.json   | 1 +
 .../main/resources/rest-api-spec/api/snapshot.status.json    | 1 +
 .../rest-api-spec/api/snapshot.verify_repository.json        | 1 +
 .../src/main/resources/rest-api-spec/api/tasks.cancel.json   | 1 +
 .../src/main/resources/rest-api-spec/api/tasks.get.json      | 1 +
 .../src/main/resources/rest-api-spec/api/tasks.list.json     | 1 +
 .../src/main/resources/rest-api-spec/api/termvectors.json    | 1 +
 .../src/main/resources/rest-api-spec/api/update.json         | 1 +
 .../main/resources/rest-api-spec/api/update_by_query.json    | 1 +
 .../rest-api-spec/api/update_by_query_rethrottle.json        | 1 +
 .../api/data_frame.delete_data_frame_transform.json          | 1 +
 .../api/data_frame.get_data_frame_transform.json             | 1 +
 .../api/data_frame.get_data_frame_transform_stats.json       | 1 +
 .../api/data_frame.preview_data_frame_transform.json         | 1 +
 .../api/data_frame.put_data_frame_transform.json             | 1 +
 .../api/data_frame.start_data_frame_transform.json           | 1 +
 .../api/data_frame.stop_data_frame_transform.json            | 1 +
 .../src/test/resources/rest-api-spec/api/graph.explore.json  | 1 +
 .../resources/rest-api-spec/api/ilm.delete_lifecycle.json    | 1 +
 .../resources/rest-api-spec/api/ilm.explain_lifecycle.json   | 1 +
 .../test/resources/rest-api-spec/api/ilm.get_lifecycle.json  | 1 +
 .../src/test/resources/rest-api-spec/api/ilm.get_status.json | 1 +
 .../test/resources/rest-api-spec/api/ilm.move_to_step.json   | 1 +
 .../test/resources/rest-api-spec/api/ilm.put_lifecycle.json  | 1 +
 .../test/resources/rest-api-spec/api/ilm.remove_policy.json  | 1 +
 .../src/test/resources/rest-api-spec/api/ilm.retry.json      | 1 +
 .../src/test/resources/rest-api-spec/api/ilm.start.json      | 1 +
 .../src/test/resources/rest-api-spec/api/ilm.stop.json       | 1 +
 .../src/test/resources/rest-api-spec/api/indices.freeze.json | 1 +
 .../test/resources/rest-api-spec/api/indices.unfreeze.json   | 1 +
 .../src/test/resources/rest-api-spec/api/license.delete.json | 1 +
 .../src/test/resources/rest-api-spec/api/license.get.json    | 1 +
 .../rest-api-spec/api/license.get_basic_status.json          | 1 +
 .../rest-api-spec/api/license.get_trial_status.json          | 1 +
 .../src/test/resources/rest-api-spec/api/license.post.json   | 1 +
 .../rest-api-spec/api/license.post_start_basic.json          | 1 +
 .../rest-api-spec/api/license.post_start_trial.json          | 1 +
 .../resources/rest-api-spec/api/migration.deprecations.json  | 1 +
 .../src/test/resources/rest-api-spec/api/ml.close_job.json   | 1 +
 .../test/resources/rest-api-spec/api/ml.delete_calendar.json | 1 +
 .../rest-api-spec/api/ml.delete_calendar_event.json          | 1 +
 .../resources/rest-api-spec/api/ml.delete_calendar_job.json  | 1 +
 .../test/resources/rest-api-spec/api/ml.delete_datafeed.json | 1 +
 .../resources/rest-api-spec/api/ml.delete_expired_data.json  | 1 +
 .../test/resources/rest-api-spec/api/ml.delete_filter.json   | 1 +
 .../test/resources/rest-api-spec/api/ml.delete_forecast.json | 1 +
 .../src/test/resources/rest-api-spec/api/ml.delete_job.json  | 1 +
 .../rest-api-spec/api/ml.delete_model_snapshot.json          | 1 +
 .../src/test/resources/rest-api-spec/api/ml.flush_job.json   | 5 ++---
 .../src/test/resources/rest-api-spec/api/ml.forecast.json    | 1 +
 .../src/test/resources/rest-api-spec/api/ml.get_buckets.json | 1 +
 .../resources/rest-api-spec/api/ml.get_calendar_events.json  | 1 +
 .../test/resources/rest-api-spec/api/ml.get_calendars.json   | 1 +
 .../test/resources/rest-api-spec/api/ml.get_categories.json  | 1 +
 .../resources/rest-api-spec/api/ml.get_datafeed_stats.json   | 1 +
 .../test/resources/rest-api-spec/api/ml.get_datafeeds.json   | 1 +
 .../src/test/resources/rest-api-spec/api/ml.get_filters.json | 1 +
 .../test/resources/rest-api-spec/api/ml.get_influencers.json | 1 +
 .../test/resources/rest-api-spec/api/ml.get_job_stats.json   | 1 +
 .../src/test/resources/rest-api-spec/api/ml.get_jobs.json    | 1 +
 .../resources/rest-api-spec/api/ml.get_model_snapshots.json  | 1 +
 .../resources/rest-api-spec/api/ml.get_overall_buckets.json  | 1 +
 .../src/test/resources/rest-api-spec/api/ml.get_records.json | 1 +
 .../plugin/src/test/resources/rest-api-spec/api/ml.info.json | 1 +
 .../src/test/resources/rest-api-spec/api/ml.open_job.json    | 1 +
 .../resources/rest-api-spec/api/ml.post_calendar_events.json | 1 +
 .../src/test/resources/rest-api-spec/api/ml.post_data.json   | 1 +
 .../resources/rest-api-spec/api/ml.preview_datafeed.json     | 1 +
 .../test/resources/rest-api-spec/api/ml.put_calendar.json    | 1 +
 .../resources/rest-api-spec/api/ml.put_calendar_job.json     | 1 +
 .../test/resources/rest-api-spec/api/ml.put_datafeed.json    | 1 +
 .../src/test/resources/rest-api-spec/api/ml.put_filter.json  | 1 +
 .../src/test/resources/rest-api-spec/api/ml.put_job.json     | 1 +
 .../rest-api-spec/api/ml.revert_model_snapshot.json          | 1 +
 .../resources/rest-api-spec/api/ml.set_upgrade_mode.json     | 1 +
 .../test/resources/rest-api-spec/api/ml.start_datafeed.json  | 1 +
 .../test/resources/rest-api-spec/api/ml.stop_datafeed.json   | 5 ++---
 .../test/resources/rest-api-spec/api/ml.update_datafeed.json | 1 +
 .../test/resources/rest-api-spec/api/ml.update_filter.json   | 1 +
 .../src/test/resources/rest-api-spec/api/ml.update_job.json  | 1 +
 .../rest-api-spec/api/ml.update_model_snapshot.json          | 1 +
 .../src/test/resources/rest-api-spec/api/ml.validate.json    | 1 +
 .../resources/rest-api-spec/api/ml.validate_detector.json    | 1 +
 .../resources/rest-api-spec/api/security.authenticate.json   | 1 +
 .../rest-api-spec/api/security.change_password.json          | 1 +
 .../rest-api-spec/api/security.clear_cached_realms.json      | 1 +
 .../rest-api-spec/api/security.clear_cached_roles.json       | 1 +
 .../resources/rest-api-spec/api/security.create_api_key.json | 1 +
 .../rest-api-spec/api/security.delete_privileges.json        | 1 +
 .../resources/rest-api-spec/api/security.delete_role.json    | 1 +
 .../rest-api-spec/api/security.delete_role_mapping.json      | 1 +
 .../resources/rest-api-spec/api/security.delete_user.json    | 1 +
 .../resources/rest-api-spec/api/security.disable_user.json   | 1 +
 .../resources/rest-api-spec/api/security.enable_user.json    | 1 +
 .../resources/rest-api-spec/api/security.get_api_key.json    | 1 +
 .../resources/rest-api-spec/api/security.get_privileges.json | 1 +
 .../test/resources/rest-api-spec/api/security.get_role.json  | 1 +
 .../rest-api-spec/api/security.get_role_mapping.json         | 1 +
 .../test/resources/rest-api-spec/api/security.get_token.json | 1 +
 .../test/resources/rest-api-spec/api/security.get_user.json  | 1 +
 .../rest-api-spec/api/security.get_user_privileges.json      | 1 +
 .../resources/rest-api-spec/api/security.has_privileges.json | 1 +
 .../rest-api-spec/api/security.invalidate_api_key.json       | 1 +
 .../rest-api-spec/api/security.invalidate_token.json         | 1 +
 .../resources/rest-api-spec/api/security.put_privileges.json | 1 +
 .../test/resources/rest-api-spec/api/security.put_role.json  | 1 +
 .../rest-api-spec/api/security.put_role_mapping.json         | 1 +
 .../test/resources/rest-api-spec/api/security.put_user.json  | 1 +
 .../test/resources/rest-api-spec/api/ssl.certificates.json   | 1 +
 .../test/resources/rest-api-spec/api/watcher.ack_watch.json  | 1 +
 .../resources/rest-api-spec/api/watcher.activate_watch.json  | 1 +
 .../rest-api-spec/api/watcher.deactivate_watch.json          | 1 +
 .../resources/rest-api-spec/api/watcher.delete_watch.json    | 2 +-
 .../resources/rest-api-spec/api/watcher.execute_watch.json   | 1 +
 .../test/resources/rest-api-spec/api/watcher.get_watch.json  | 1 +
 .../test/resources/rest-api-spec/api/watcher.put_watch.json  | 1 +
 .../src/test/resources/rest-api-spec/api/watcher.start.json  | 1 +
 .../src/test/resources/rest-api-spec/api/watcher.stats.json  | 1 +
 .../src/test/resources/rest-api-spec/api/watcher.stop.json   | 1 +
 .../src/test/resources/rest-api-spec/api/xpack.info.json     | 1 +
 .../src/test/resources/rest-api-spec/api/xpack.usage.json    | 1 +
 233 files changed, 235 insertions(+), 7 deletions(-)

diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/bulk.json b/rest-api-spec/src/main/resources/rest-api-spec/api/bulk.json
index a07f362bef064..fcbe4bf617446 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/bulk.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/bulk.json
@@ -1,6 +1,7 @@
 {
   "bulk": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/docs-bulk.html",
+    "stability": "stable",
     "methods": ["POST", "PUT"],
     "url": {
       "path": "/_bulk",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.aliases.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.aliases.json
index d30c6ace6f723..2472d950a1575 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.aliases.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.aliases.json
@@ -1,6 +1,7 @@
 {
   "cat.aliases": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cat-alias.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cat/aliases",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.allocation.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.allocation.json
index 7c826890607e4..3c630212148b8 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.allocation.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.allocation.json
@@ -1,6 +1,7 @@
 {
   "cat.allocation": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cat-allocation.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cat/allocation",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.count.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.count.json
index 4311d9a3be12d..8d91d3d6df904 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.count.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.count.json
@@ -1,6 +1,7 @@
 {
   "cat.count": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cat-count.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cat/count",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.fielddata.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.fielddata.json
index 88c7eee126294..d2fe6725172a1 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.fielddata.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.fielddata.json
@@ -1,6 +1,7 @@
 {
   "cat.fielddata": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cat-fielddata.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cat/fielddata",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.health.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.health.json
index e858e83b465ed..ee6f2ffe7c9b4 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.health.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.health.json
@@ -1,6 +1,7 @@
 {
   "cat.health": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cat-health.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cat/health",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.help.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.help.json
index e893fb1b0447e..ce4df6a5d6c24 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.help.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.help.json
@@ -1,6 +1,7 @@
 {
   "cat.help": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cat.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cat",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.indices.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.indices.json
index 24961a57cf331..cc049c8192187 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.indices.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.indices.json
@@ -1,6 +1,7 @@
 {
   "cat.indices": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cat-indices.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cat/indices",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.master.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.master.json
index ab87b2adb7e72..bda8cdb84956f 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.master.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.master.json
@@ -1,6 +1,7 @@
 {
   "cat.master": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cat-master.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cat/master",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.nodeattrs.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.nodeattrs.json
index 3d8a4a77a7704..51cfc9aa1a449 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.nodeattrs.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.nodeattrs.json
@@ -1,6 +1,7 @@
 {
   "cat.nodeattrs": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cat-nodeattrs.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cat/nodeattrs",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.nodes.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.nodes.json
index 1b3c1266a63a0..53a04606ce82b 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.nodes.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.nodes.json
@@ -1,6 +1,7 @@
 {
   "cat.nodes": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cat-nodes.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cat/nodes",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.pending_tasks.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.pending_tasks.json
index 983b82482ae40..d8d3a792cc7f8 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.pending_tasks.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.pending_tasks.json
@@ -1,6 +1,7 @@
 {
   "cat.pending_tasks": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cat-pending-tasks.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cat/pending_tasks",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.plugins.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.plugins.json
index 93c7feababa99..ac20a12a61424 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.plugins.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.plugins.json
@@ -1,6 +1,7 @@
 {
   "cat.plugins": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cat-plugins.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cat/plugins",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.recovery.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.recovery.json
index 42f91cedfdd6c..1a2be146bef28 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.recovery.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.recovery.json
@@ -1,6 +1,7 @@
 {
   "cat.recovery": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cat-recovery.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cat/recovery",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.repositories.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.repositories.json
index c640a568fde0b..a1bb336aabf7d 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.repositories.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.repositories.json
@@ -1,6 +1,7 @@
 {
   "cat.repositories": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cat-repositories.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cat/repositories",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.segments.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.segments.json
index 3306b2f753b2a..5b7b4a49e5781 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.segments.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.segments.json
@@ -1,6 +1,7 @@
 {
   "cat.segments": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cat-segments.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cat/segments",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.shards.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.shards.json
index 2ad714e7225d7..9f0027a975b5d 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.shards.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.shards.json
@@ -1,6 +1,7 @@
 {
   "cat.shards": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cat-shards.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cat/shards",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.snapshots.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.snapshots.json
index eec22e2e0412d..6267c7194d698 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.snapshots.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.snapshots.json
@@ -1,6 +1,7 @@
 {
   "cat.snapshots": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cat-snapshots.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cat/snapshots",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.tasks.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.tasks.json
index 1958843e601c7..8bfd24eb5152f 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.tasks.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.tasks.json
@@ -1,6 +1,7 @@
 {
   "cat.tasks": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/tasks.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cat/tasks",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.templates.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.templates.json
index f0757c2d652dc..eef7e17b48f88 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.templates.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.templates.json
@@ -1,6 +1,7 @@
 {
   "cat.templates": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cat-templates.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cat/templates",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.thread_pool.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.thread_pool.json
index 70a11000bbe41..82d832512772d 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.thread_pool.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.thread_pool.json
@@ -1,6 +1,7 @@
 {
   "cat.thread_pool": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cat-thread-pool.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cat/thread_pool",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/clear_scroll.json b/rest-api-spec/src/main/resources/rest-api-spec/api/clear_scroll.json
index b2b0343230c66..c374b1d4710ec 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/clear_scroll.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/clear_scroll.json
@@ -1,6 +1,7 @@
 {
   "clear_scroll": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/search-request-scroll.html",
+    "stability": "stable",
     "methods": ["DELETE"],
     "url": {
       "path": "/_search/scroll",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.allocation_explain.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.allocation_explain.json
index 26b24cfb69760..43bdc3539c8a1 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.allocation_explain.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.allocation_explain.json
@@ -1,6 +1,7 @@
 {
   "cluster.allocation_explain": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-allocation-explain.html",
+    "stability": "stable",
     "methods": ["GET", "POST"],
     "url": {
       "path": "/_cluster/allocation/explain",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.get_settings.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.get_settings.json
index baba4e3436abc..795944be06146 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.get_settings.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.get_settings.json
@@ -1,6 +1,7 @@
 {
   "cluster.get_settings": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-update-settings.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cluster/settings",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.health.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.health.json
index 49d0ef5c83aee..908e5647b44e0 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.health.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.health.json
@@ -1,6 +1,7 @@
 {
   "cluster.health": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-health.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cluster/health",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.pending_tasks.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.pending_tasks.json
index fb5e1609ff39d..85bba46649084 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.pending_tasks.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.pending_tasks.json
@@ -1,6 +1,7 @@
 {
   "cluster.pending_tasks": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-pending.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cluster/pending_tasks",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.put_settings.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.put_settings.json
index 5fcf03102836a..a393cfe5f5d7f 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.put_settings.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.put_settings.json
@@ -1,6 +1,7 @@
 {
   "cluster.put_settings": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-update-settings.html",
+    "stability": "stable",
     "methods": ["PUT"],
     "url": {
       "path": "/_cluster/settings",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.remote_info.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.remote_info.json
index 3237853154493..dd7e79431c664 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.remote_info.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.remote_info.json
@@ -1,6 +1,7 @@
 {
   "cluster.remote_info": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-remote-info.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_remote/info",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.reroute.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.reroute.json
index 8bb85ca087ae8..6f17ffddf3e30 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.reroute.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.reroute.json
@@ -1,6 +1,7 @@
 {
   "cluster.reroute": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-reroute.html",
+    "stability": "stable",
     "methods": ["POST"],
     "url": {
       "path": "/_cluster/reroute",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.stats.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.stats.json
index 36400ed2f7c4c..3830a5e468405 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.stats.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.stats.json
@@ -1,6 +1,7 @@
 {
   "cluster.stats": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-stats.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cluster/stats",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/count.json b/rest-api-spec/src/main/resources/rest-api-spec/api/count.json
index b933091b9a416..a307973ae5366 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/count.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/count.json
@@ -1,6 +1,7 @@
 {
   "count": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/search-count.html",
+    "stability": "stable",
     "methods": ["POST", "GET"],
     "url": {
       "path": "/_count",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/create.json b/rest-api-spec/src/main/resources/rest-api-spec/api/create.json
index f21d2606364d1..69c3e56b4a13d 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/create.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/create.json
@@ -1,6 +1,7 @@
 {
   "create": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/docs-index_.html",
+    "stability": "stable",
     "methods": ["PUT","POST"],
     "url": {
       "path": "/{index}/_create/{id}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/delete.json b/rest-api-spec/src/main/resources/rest-api-spec/api/delete.json
index 792f9d89609bf..3fe8b1d3f01fa 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/delete.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/delete.json
@@ -1,6 +1,7 @@
 {
   "delete": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/docs-delete.html",
+    "stability": "stable",
     "methods": ["DELETE"],
     "url": {
       "path": "/{index}/_doc/{id}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/delete_by_query.json b/rest-api-spec/src/main/resources/rest-api-spec/api/delete_by_query.json
index 37b88e0f24d93..af9fba190eb7b 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/delete_by_query.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/delete_by_query.json
@@ -1,6 +1,7 @@
 {
   "delete_by_query": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/docs-delete-by-query.html",
+    "stability": "stable",
     "methods": ["POST"],
     "url": {
       "path": "/{index}/_delete_by_query",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/delete_by_query_rethrottle.json b/rest-api-spec/src/main/resources/rest-api-spec/api/delete_by_query_rethrottle.json
index f49af01cfc3b7..e101d64838541 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/delete_by_query_rethrottle.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/delete_by_query_rethrottle.json
@@ -1,6 +1,7 @@
 {
   "delete_by_query_rethrottle": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-delete-by-query.html",
+    "stability": "stable",
     "methods": ["POST"],
     "url": {
       "path": "/_delete_by_query/{task_id}/_rethrottle",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/delete_script.json b/rest-api-spec/src/main/resources/rest-api-spec/api/delete_script.json
index 83bb690cc0428..afe0812822d58 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/delete_script.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/delete_script.json
@@ -1,6 +1,7 @@
 {
   "delete_script": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/modules-scripting.html",
+    "stability": "stable",
     "methods": ["DELETE"],
     "url": {
       "path": "/_scripts/{id}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/exists.json b/rest-api-spec/src/main/resources/rest-api-spec/api/exists.json
index 3debd3edce585..e0dc3d198e650 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/exists.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/exists.json
@@ -1,6 +1,7 @@
 {
   "exists": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/docs-get.html",
+    "stability": "stable",
     "methods": ["HEAD"],
     "url": {
       "path": "/{index}/_doc/{id}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/exists_source.json b/rest-api-spec/src/main/resources/rest-api-spec/api/exists_source.json
index 89f9c33e5fb44..ae2bbaa57d319 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/exists_source.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/exists_source.json
@@ -1,6 +1,7 @@
 {
   "exists_source": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/docs-get.html",
+    "stability": "stable",
     "methods": ["HEAD"],
     "url": {
       "path": "/{index}/_source/{id}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/explain.json b/rest-api-spec/src/main/resources/rest-api-spec/api/explain.json
index 12aa7a8dca942..852256ea99f53 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/explain.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/explain.json
@@ -1,6 +1,7 @@
 {
   "explain": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/search-explain.html",
+    "stability": "stable",
     "methods": ["GET", "POST"],
     "url": {
       "path": "/{index}/_explain/{id}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/field_caps.json b/rest-api-spec/src/main/resources/rest-api-spec/api/field_caps.json
index ebb520fd433b9..e4883c8d58dc2 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/field_caps.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/field_caps.json
@@ -1,6 +1,7 @@
 {
   "field_caps": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/search-field-caps.html",
+    "stability": "stable",
     "methods": ["GET", "POST"],
     "url": {
       "path": "/_field_caps",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/get.json b/rest-api-spec/src/main/resources/rest-api-spec/api/get.json
index 5b2203c94deb9..7744070db39f6 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/get.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/get.json
@@ -1,6 +1,7 @@
 {
   "get": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/docs-get.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/{index}/_doc/{id}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/get_script.json b/rest-api-spec/src/main/resources/rest-api-spec/api/get_script.json
index 0b2d6c5a5b9c2..ca0fe3e6d6c67 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/get_script.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/get_script.json
@@ -1,6 +1,7 @@
 {
   "get_script": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/modules-scripting.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_scripts/{id}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/get_source.json b/rest-api-spec/src/main/resources/rest-api-spec/api/get_source.json
index a26691edc41fc..e0d1015fa3c7d 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/get_source.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/get_source.json
@@ -1,6 +1,7 @@
 {
   "get_source": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/docs-get.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/{index}/_source/{id}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/index.json b/rest-api-spec/src/main/resources/rest-api-spec/api/index.json
index 2a2053d2250a0..5e47b0a617441 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/index.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/index.json
@@ -1,6 +1,7 @@
 {
   "index": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/docs-index_.html",
+    "stability": "stable",
     "methods": ["POST", "PUT"],
     "url": {
       "path": "/{index}/_doc",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.analyze.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.analyze.json
index c340ccd2f37c2..dcbf6f07d4c10 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.analyze.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.analyze.json
@@ -1,6 +1,7 @@
 {
   "indices.analyze": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-analyze.html",
+    "stability": "stable",
     "methods": ["GET", "POST"],
     "url": {
       "path": "/_analyze",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.clear_cache.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.clear_cache.json
index 7e62371dd674d..b83abbb3d162d 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.clear_cache.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.clear_cache.json
@@ -1,6 +1,7 @@
 {
   "indices.clear_cache": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-clearcache.html",
+    "stability": "stable",
     "methods": ["POST"],
     "url": {
       "path": "/_cache/clear",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.close.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.close.json
index 55fd245f26c91..f85220f00cf06 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.close.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.close.json
@@ -1,6 +1,7 @@
 {
   "indices.close": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-open-close.html",
+    "stability": "stable",
     "methods": ["POST"],
     "url": {
       "path": "/{index}/_close",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.create.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.create.json
index d4a16e576e1b9..f14af04ce0e0b 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.create.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.create.json
@@ -1,6 +1,7 @@
 {
   "indices.create": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-create-index.html",
+    "stability": "stable",
     "methods": ["PUT"],
     "url": {
       "path": "/{index}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.delete.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.delete.json
index c391242e9de15..6be87d867fca0 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.delete.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.delete.json
@@ -1,6 +1,7 @@
 {
   "indices.delete": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-delete-index.html",
+    "stability": "stable",
     "methods": ["DELETE"],
     "url": {
       "path": "/{index}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.delete_alias.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.delete_alias.json
index 30a32fbfef871..313d455d625be 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.delete_alias.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.delete_alias.json
@@ -1,6 +1,7 @@
 {
   "indices.delete_alias": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-aliases.html",
+    "stability": "stable",
     "methods": ["DELETE"],
     "url": {
       "path": "/{index}/_alias/{name}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.delete_template.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.delete_template.json
index b311c9bbda82a..49508e74a5e87 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.delete_template.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.delete_template.json
@@ -1,6 +1,7 @@
 {
   "indices.delete_template": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-templates.html",
+    "stability": "stable",
     "methods": ["DELETE"],
     "url": {
       "path": "/_template/{name}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.exists.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.exists.json
index 7f04f00b40def..40e7c41669bcb 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.exists.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.exists.json
@@ -1,6 +1,7 @@
 {
   "indices.exists": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-exists.html",
+    "stability": "stable",
     "methods": [ "HEAD" ],
     "url": {
       "path": "/{index}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.exists_alias.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.exists_alias.json
index aea20b2b634d0..052f5d80b0041 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.exists_alias.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.exists_alias.json
@@ -1,6 +1,7 @@
 {
   "indices.exists_alias": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-aliases.html",
+    "stability": "stable",
     "methods": ["HEAD"],
     "url": {
       "path": "/_alias/{name}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.exists_template.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.exists_template.json
index 3fb9d1e207e1e..13a3e777e1bd9 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.exists_template.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.exists_template.json
@@ -1,6 +1,7 @@
 {
   "indices.exists_template": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-templates.html",
+    "stability": "stable",
     "methods": ["HEAD"],
     "url": {
       "path": "/_template/{name}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.exists_type.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.exists_type.json
index a788202c93ae2..f6fad0d9c948a 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.exists_type.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.exists_type.json
@@ -1,6 +1,7 @@
 {
   "indices.exists_type": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-types-exists.html",
+    "stability": "stable",
     "methods": ["HEAD"],
     "deprecated" : {
       "version" : "7.0.0",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.flush.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.flush.json
index 77d9e037163fa..e3bbdc9e961c2 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.flush.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.flush.json
@@ -1,6 +1,7 @@
 {
   "indices.flush": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-flush.html",
+    "stability": "stable",
     "methods": ["POST", "GET"],
     "url": {
       "path": "/_flush",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.flush_synced.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.flush_synced.json
index 08488eae8648b..e0961b669d046 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.flush_synced.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.flush_synced.json
@@ -1,6 +1,7 @@
 {
   "indices.flush_synced": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-synced-flush.html",
+    "stability": "stable",
     "methods": ["POST", "GET"],
     "url": {
       "path": "/_flush/synced",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.forcemerge.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.forcemerge.json
index d87ce2a4451d6..3bc6750919e0a 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.forcemerge.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.forcemerge.json
@@ -1,6 +1,7 @@
 {
   "indices.forcemerge": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-forcemerge.html",
+    "stability": "stable",
     "methods": ["POST"],
     "url": {
       "path": "/_forcemerge",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get.json
index 76e6ed00feb26..7130dc9d297d2 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get.json
@@ -1,6 +1,7 @@
 {
   "indices.get":{
     "documentation":"http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-get-index.html",
+    "stability": "stable",
     "methods":[ "GET" ],
     "url":{
       "path":"/{index}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_alias.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_alias.json
index b68d7c527fcdc..99b296ae39e62 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_alias.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_alias.json
@@ -1,6 +1,7 @@
 {
   "indices.get_alias": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-aliases.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_alias/",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_field_mapping.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_field_mapping.json
index 305cb700ceae9..38f61f7bde5f9 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_field_mapping.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_field_mapping.json
@@ -1,6 +1,7 @@
 {
   "indices.get_field_mapping": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-get-field-mapping.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_mapping/field/{fields}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_mapping.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_mapping.json
index abfc3d3867e9a..06ce5781076a1 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_mapping.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_mapping.json
@@ -1,6 +1,7 @@
 {
   "indices.get_mapping": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-get-mapping.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_mapping",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_settings.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_settings.json
index ed22cc837d6a8..f4c64abdc38c4 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_settings.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_settings.json
@@ -1,6 +1,7 @@
 {
   "indices.get_settings": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-get-settings.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_settings",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_template.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_template.json
index e2aae3b7444aa..9dc7146782391 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_template.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_template.json
@@ -1,6 +1,7 @@
 {
   "indices.get_template": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-templates.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_template/{name}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_upgrade.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_upgrade.json
index 3c114a450eef2..a05d021007ce3 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_upgrade.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_upgrade.json
@@ -1,6 +1,7 @@
 {
   "indices.get_upgrade": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-upgrade.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_upgrade",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.open.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.open.json
index 86c39988e181f..9e2d96623a2e3 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.open.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.open.json
@@ -1,6 +1,7 @@
 {
   "indices.open": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-open-close.html",
+    "stability": "stable",
     "methods": ["POST"],
     "url": {
       "path": "/{index}/_open",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.put_alias.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.put_alias.json
index da53d5ac441e1..43d6ebe479537 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.put_alias.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.put_alias.json
@@ -1,6 +1,7 @@
 {
   "indices.put_alias": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-aliases.html",
+    "stability": "stable",
     "methods": ["PUT", "POST"],
     "url": {
       "path": "/{index}/_alias/{name}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.put_mapping.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.put_mapping.json
index c46e6b15549cc..ad3b4ec45c19a 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.put_mapping.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.put_mapping.json
@@ -1,6 +1,7 @@
 {
   "indices.put_mapping": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-put-mapping.html",
+    "stability": "stable",
     "methods": ["PUT", "POST"],
     "url": {
       "path": "{index}/_mapping",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.put_settings.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.put_settings.json
index 3055cb8e32e2e..30064af7782ab 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.put_settings.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.put_settings.json
@@ -1,6 +1,7 @@
 {
   "indices.put_settings": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-update-settings.html",
+    "stability": "stable",
     "methods": ["PUT"],
     "url": {
       "path": "/_settings",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.put_template.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.put_template.json
index 65aa9506ff9f1..35c6b8c65353c 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.put_template.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.put_template.json
@@ -1,6 +1,7 @@
 {
   "indices.put_template": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-templates.html",
+    "stability": "stable",
     "methods": ["PUT", "POST"],
     "url": {
       "path": "/_template/{name}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.recovery.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.recovery.json
index 80b7f1a000986..892fc72669425 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.recovery.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.recovery.json
@@ -1,6 +1,7 @@
 {
     "indices.recovery" : {
         "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-recovery.html",
+        "stability": "stable",
         "methods": ["GET"],
         "url": {
             "path": "/_recovery",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.refresh.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.refresh.json
index a32974d017f22..443dbeacd75c8 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.refresh.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.refresh.json
@@ -1,6 +1,7 @@
 {
   "indices.refresh": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-refresh.html",
+    "stability": "stable",
     "methods": ["POST", "GET"],
     "url": {
       "path": "/_refresh",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.rollover.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.rollover.json
index 7bf1513969fb3..42299cb56d2da 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.rollover.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.rollover.json
@@ -1,6 +1,7 @@
 {
   "indices.rollover": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-rollover-index.html",
+    "stability": "stable",
     "methods": ["POST"],
     "url": {
       "path": "/{alias}/_rollover",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.segments.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.segments.json
index 3ecf1b23aaea2..7d0fcda29c0d5 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.segments.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.segments.json
@@ -1,6 +1,7 @@
 {
   "indices.segments": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-segments.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_segments",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.shard_stores.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.shard_stores.json
index ecdaa75a3a9e4..6107f301b4615 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.shard_stores.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.shard_stores.json
@@ -1,6 +1,7 @@
 {
   "indices.shard_stores": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-shards-stores.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_shard_stores",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.shrink.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.shrink.json
index 5ef943eacba6c..15959f7a34d0f 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.shrink.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.shrink.json
@@ -1,6 +1,7 @@
 {
   "indices.shrink": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-shrink-index.html",
+    "stability": "stable",
     "methods": ["PUT", "POST"],
     "url": {
       "path": "/{index}/_shrink/{target}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.split.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.split.json
index a79fa7b708269..ff44807da483b 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.split.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.split.json
@@ -1,6 +1,7 @@
 {
   "indices.split": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-split-index.html",
+    "stability": "stable",
     "methods": ["PUT", "POST"],
     "url": {
       "path": "/{index}/_split/{target}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.stats.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.stats.json
index c86a2c1147a9b..16ddd236e8ba7 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.stats.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.stats.json
@@ -1,6 +1,7 @@
 {
   "indices.stats": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-stats.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_stats",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.update_aliases.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.update_aliases.json
index 30c369e410a25..03e58a2fe8025 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.update_aliases.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.update_aliases.json
@@ -1,6 +1,7 @@
 {
   "indices.update_aliases": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-aliases.html",
+    "stability": "stable",
     "methods": ["POST"],
     "url": {
       "path": "/_aliases",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.upgrade.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.upgrade.json
index 1e2413ee723cc..47cb5e4b64b19 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.upgrade.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.upgrade.json
@@ -1,6 +1,7 @@
 {
   "indices.upgrade": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/indices-upgrade.html",
+    "stability": "stable",
     "methods": ["POST"],
     "url": {
       "path": "/_upgrade",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.validate_query.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.validate_query.json
index 6f1395b1582a0..4a78258854659 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.validate_query.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.validate_query.json
@@ -1,6 +1,7 @@
 {
   "indices.validate_query": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/search-validate.html",
+    "stability": "stable",
     "methods": ["GET", "POST"],
     "url": {
       "path": "/_validate/query",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/info.json b/rest-api-spec/src/main/resources/rest-api-spec/api/info.json
index 63754eb7f7c3c..ecaabf69fc9f5 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/info.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/info.json
@@ -1,6 +1,7 @@
 {
   "info": {
     "documentation": "http://www.elastic.co/guide/",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.delete_pipeline.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.delete_pipeline.json
index c3b51de862097..4b5ae4922053d 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.delete_pipeline.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.delete_pipeline.json
@@ -1,6 +1,7 @@
 {
   "ingest.delete_pipeline": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/delete-pipeline-api.html",
+    "stability": "stable",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_ingest/pipeline/{id}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.get_pipeline.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.get_pipeline.json
index 16a07e072b771..eca3dc3f7397f 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.get_pipeline.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.get_pipeline.json
@@ -1,6 +1,7 @@
 {
   "ingest.get_pipeline": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/get-pipeline-api.html",
+    "stability": "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/_ingest/pipeline/{id}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.processor_grok.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.processor_grok.json
index bf40be853e2d1..f98f23e94651b 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.processor_grok.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.processor_grok.json
@@ -1,6 +1,7 @@
 {
   "ingest.processor_grok": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/grok-processor.html#grok-processor-rest-get",
+    "stability": "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/_ingest/processor/grok",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.put_pipeline.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.put_pipeline.json
index 1ea77901d8dbd..be62eb23e6a1a 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.put_pipeline.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.put_pipeline.json
@@ -1,6 +1,7 @@
 {
   "ingest.put_pipeline": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/put-pipeline-api.html",
+    "stability": "stable",
     "methods": [ "PUT" ],
     "url": {
       "path": "/_ingest/pipeline/{id}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.simulate.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.simulate.json
index c16008ad6b659..01a7b4b0af3a5 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.simulate.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.simulate.json
@@ -1,6 +1,7 @@
 {
   "ingest.simulate": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/simulate-pipeline-api.html",
+    "stability": "stable",
     "methods": [ "GET", "POST" ],
     "url": {
       "path": "/_ingest/pipeline/_simulate",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/mget.json b/rest-api-spec/src/main/resources/rest-api-spec/api/mget.json
index c04fb34beac18..79ee0cb4395d9 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/mget.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/mget.json
@@ -1,6 +1,7 @@
 {
   "mget": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/docs-multi-get.html",
+    "stability": "stable",
     "methods": ["GET", "POST"],
     "url": {
       "path": "/_mget",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/msearch.json b/rest-api-spec/src/main/resources/rest-api-spec/api/msearch.json
index 9c416e841362a..df47b504f866f 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/msearch.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/msearch.json
@@ -1,6 +1,7 @@
 {
   "msearch": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/search-multi-search.html",
+    "stability": "stable",
     "methods": ["GET", "POST"],
     "url": {
       "path": "/_msearch",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/msearch_template.json b/rest-api-spec/src/main/resources/rest-api-spec/api/msearch_template.json
index 87aa6b22b8d45..d4829b0a57f3b 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/msearch_template.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/msearch_template.json
@@ -1,6 +1,7 @@
 {
   "msearch_template": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/search-multi-search.html",
+    "stability": "stable",
     "methods": ["GET", "POST"],
     "url": {
       "path": "/_msearch/template",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/mtermvectors.json b/rest-api-spec/src/main/resources/rest-api-spec/api/mtermvectors.json
index 8cf4b22e90da9..844f13917958a 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/mtermvectors.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/mtermvectors.json
@@ -1,6 +1,7 @@
 {
   "mtermvectors" : {
     "documentation" : "http://www.elastic.co/guide/en/elasticsearch/reference/master/docs-multi-termvectors.html",
+    "stability": "stable",
     "methods" : ["GET", "POST"],
     "url" : {
       "path" : "/_mtermvectors",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/nodes.hot_threads.json b/rest-api-spec/src/main/resources/rest-api-spec/api/nodes.hot_threads.json
index 95df4f53aa579..49925ffb17e9d 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/nodes.hot_threads.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/nodes.hot_threads.json
@@ -1,6 +1,7 @@
 {
   "nodes.hot_threads": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-nodes-hot-threads.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_nodes/hot_threads",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/nodes.info.json b/rest-api-spec/src/main/resources/rest-api-spec/api/nodes.info.json
index c86d35dc1a95a..a4f28f9da26b6 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/nodes.info.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/nodes.info.json
@@ -1,6 +1,7 @@
 {
   "nodes.info": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-nodes-info.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_nodes",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/nodes.reload_secure_settings.json b/rest-api-spec/src/main/resources/rest-api-spec/api/nodes.reload_secure_settings.json
index 0a566df35bbc2..2ffa43c5e2780 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/nodes.reload_secure_settings.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/nodes.reload_secure_settings.json
@@ -1,6 +1,7 @@
 {
   "nodes.reload_secure_settings": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/secure-settings.html#reloadable-secure-settings",
+    "stability": "stable",
     "methods": ["POST"],
     "url": {
       "path": "/_nodes/reload_secure_settings",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/nodes.stats.json b/rest-api-spec/src/main/resources/rest-api-spec/api/nodes.stats.json
index 7b426d03918b2..777f46a21072b 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/nodes.stats.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/nodes.stats.json
@@ -1,6 +1,7 @@
 {
   "nodes.stats": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-nodes-stats.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_nodes/stats",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/nodes.usage.json b/rest-api-spec/src/main/resources/rest-api-spec/api/nodes.usage.json
index 97c3f201f6cdf..1d5a2d18d04d1 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/nodes.usage.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/nodes.usage.json
@@ -1,6 +1,7 @@
 {
   "nodes.usage": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-nodes-usage.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_nodes/usage",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ping.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ping.json
index 41310bb30d494..3b6b5206561c1 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/ping.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/ping.json
@@ -1,6 +1,7 @@
 {
   "ping": {
     "documentation": "http://www.elastic.co/guide/",
+    "stability": "stable",
     "methods": ["HEAD"],
     "url": {
       "path": "/",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/put_script.json b/rest-api-spec/src/main/resources/rest-api-spec/api/put_script.json
index 34bd4f63c285e..d67d6007ddc7a 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/put_script.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/put_script.json
@@ -1,6 +1,7 @@
 {
   "put_script": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/modules-scripting.html",
+    "stability": "stable",
     "methods": ["PUT", "POST"],
     "url": {
       "path": "/_scripts/{id}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/reindex.json b/rest-api-spec/src/main/resources/rest-api-spec/api/reindex.json
index e85eadb5bc41e..62cbdf6178a34 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/reindex.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/reindex.json
@@ -1,6 +1,7 @@
 {
   "reindex": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/docs-reindex.html",
+    "stability": "stable",
     "methods": ["POST"],
     "url": {
       "path": "/_reindex",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/reindex_rethrottle.json b/rest-api-spec/src/main/resources/rest-api-spec/api/reindex_rethrottle.json
index 2763eb8983fd5..a5da7c4d2857d 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/reindex_rethrottle.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/reindex_rethrottle.json
@@ -1,6 +1,7 @@
 {
   "reindex_rethrottle": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/docs-reindex.html",
+    "stability": "stable",
     "methods": ["POST"],
     "url": {
       "path": "/_reindex/{task_id}/_rethrottle",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/render_search_template.json b/rest-api-spec/src/main/resources/rest-api-spec/api/render_search_template.json
index 8f27c12b819da..e0d10b15562ba 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/render_search_template.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/render_search_template.json
@@ -1,6 +1,7 @@
 {
   "render_search_template": {
     "documentation": "http://www.elasticsearch.org/guide/en/elasticsearch/reference/master/search-template.html",
+    "stability": "stable",
     "methods": ["GET", "POST"],
     "url": {
       "path": "/_render/template",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/scripts_painless_context.json b/rest-api-spec/src/main/resources/rest-api-spec/api/scripts_painless_context.json
index 1eb490e8ab59f..b74af959b9f8d 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/scripts_painless_context.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/scripts_painless_context.json
@@ -1,5 +1,6 @@
 {
   "scripts_painless_context": {
+    "stability": "private",
     "methods": ["GET"],
     "url": {
       "path": "/_scripts/painless/_context",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/scroll.json b/rest-api-spec/src/main/resources/rest-api-spec/api/scroll.json
index 31e02a172fd0e..dc7dc6b099709 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/scroll.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/scroll.json
@@ -1,6 +1,7 @@
 {
   "scroll": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/search-request-scroll.html",
+    "stability": "stable",
     "methods": ["GET", "POST"],
     "url": {
       "path": "/_search/scroll",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/search.json b/rest-api-spec/src/main/resources/rest-api-spec/api/search.json
index 00ed8d113a00c..5f18aa3888aa6 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/search.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/search.json
@@ -1,6 +1,7 @@
 {
   "search": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/search-search.html",
+    "stability": "stable",
     "methods": ["GET", "POST"],
     "url": {
       "path": "/_search",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/search_shards.json b/rest-api-spec/src/main/resources/rest-api-spec/api/search_shards.json
index b3de107b79787..f314ccf99f1e9 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/search_shards.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/search_shards.json
@@ -1,6 +1,7 @@
 {
   "search_shards": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/search-shards.html",
+    "stability": "stable",
     "methods": ["GET", "POST"],
     "url": {
       "path": "/{index}/_search_shards",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/search_template.json b/rest-api-spec/src/main/resources/rest-api-spec/api/search_template.json
index 5395e4f59c10e..0e9cf80e4342f 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/search_template.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/search_template.json
@@ -1,6 +1,7 @@
 {
   "search_template": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/search-template.html",
+    "stability": "stable",
     "methods": ["GET", "POST"],
     "url": {
       "path": "/_search/template",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.create.json b/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.create.json
index 29ae2206c8568..edb8c61503feb 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.create.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.create.json
@@ -1,6 +1,7 @@
 {
   "snapshot.create": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/modules-snapshots.html",
+    "stability": "stable",
     "methods": ["PUT", "POST"],
     "url": {
       "path": "/_snapshot/{repository}/{snapshot}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.create_repository.json b/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.create_repository.json
index 7a73f6abc3c28..f7249c55318d4 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.create_repository.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.create_repository.json
@@ -1,6 +1,7 @@
 {
   "snapshot.create_repository": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/modules-snapshots.html",
+    "stability": "stable",
     "methods": ["PUT", "POST"],
     "url": {
       "path": "/_snapshot/{repository}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.delete.json b/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.delete.json
index 6668289f442a6..eb74b86a22fce 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.delete.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.delete.json
@@ -1,6 +1,7 @@
 {
   "snapshot.delete": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/modules-snapshots.html",
+    "stability": "stable",
     "methods": ["DELETE"],
     "url": {
       "path": "/_snapshot/{repository}/{snapshot}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.delete_repository.json b/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.delete_repository.json
index 4f0c43b8f0317..bf126ab27b93a 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.delete_repository.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.delete_repository.json
@@ -1,6 +1,7 @@
 {
   "snapshot.delete_repository": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/modules-snapshots.html",
+    "stability": "stable",
     "methods": ["DELETE"],
     "url": {
       "path": "/_snapshot/{repository}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.get.json b/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.get.json
index 02f5259bc2ec8..0cec0115f64c1 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.get.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.get.json
@@ -1,6 +1,7 @@
 {
   "snapshot.get": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/modules-snapshots.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_snapshot/{repository}/{snapshot}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.get_repository.json b/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.get_repository.json
index bf6a660146173..a8264fb0cd1ca 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.get_repository.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.get_repository.json
@@ -1,6 +1,7 @@
 {
   "snapshot.get_repository": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/modules-snapshots.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_snapshot",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.restore.json b/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.restore.json
index bdd265799ce4b..e7e65fc80683f 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.restore.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.restore.json
@@ -1,6 +1,7 @@
 {
   "snapshot.restore": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/modules-snapshots.html",
+    "stability": "stable",
     "methods": ["POST"],
     "url": {
       "path": "/_snapshot/{repository}/{snapshot}/_restore",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.status.json b/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.status.json
index cba488de793bc..23ffafd659ea9 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.status.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.status.json
@@ -1,6 +1,7 @@
 {
   "snapshot.status": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/modules-snapshots.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_snapshot/_status",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.verify_repository.json b/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.verify_repository.json
index 0d9a97c10877b..87a62e37570d9 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.verify_repository.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/snapshot.verify_repository.json
@@ -1,6 +1,7 @@
 {
     "snapshot.verify_repository": {
         "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/modules-snapshots.html",
+        "stability": "stable",
         "methods": ["POST"],
         "url": {
             "path": "/_snapshot/{repository}/_verify",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/tasks.cancel.json b/rest-api-spec/src/main/resources/rest-api-spec/api/tasks.cancel.json
index 244ca986f9b7f..49ff0ebe7a3f5 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/tasks.cancel.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/tasks.cancel.json
@@ -1,6 +1,7 @@
 {
   "tasks.cancel": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/tasks.html",
+    "stability": "stable",
     "methods": ["POST"],
     "url": {
       "path": "/_tasks",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/tasks.get.json b/rest-api-spec/src/main/resources/rest-api-spec/api/tasks.get.json
index 3fefdb8f965ff..25a5695c20f73 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/tasks.get.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/tasks.get.json
@@ -1,6 +1,7 @@
 {
   "tasks.get": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/tasks.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_tasks/{task_id}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/tasks.list.json b/rest-api-spec/src/main/resources/rest-api-spec/api/tasks.list.json
index f16967eafeb02..5fe2dee401a49 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/tasks.list.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/tasks.list.json
@@ -1,6 +1,7 @@
 {
   "tasks.list": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/tasks.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_tasks",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/termvectors.json b/rest-api-spec/src/main/resources/rest-api-spec/api/termvectors.json
index 44b972b355f68..4989019840dae 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/termvectors.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/termvectors.json
@@ -1,6 +1,7 @@
 {
   "termvectors" : {
     "documentation" : "http://www.elastic.co/guide/en/elasticsearch/reference/master/docs-termvectors.html",
+    "stability": "stable",
     "methods" : ["GET", "POST"],
     "url" : {
       "path" : "/{index}/_termvectors/{id}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/update.json b/rest-api-spec/src/main/resources/rest-api-spec/api/update.json
index b85c70be57d9e..061b8d5d2b592 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/update.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/update.json
@@ -1,6 +1,7 @@
 {
   "update": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/docs-update.html",
+    "stability": "stable",
     "methods": ["POST"],
     "url": {
       "path": "/{index}/_update/{id}",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/update_by_query.json b/rest-api-spec/src/main/resources/rest-api-spec/api/update_by_query.json
index bdb4c565bd965..1323b15315a4d 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/update_by_query.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/update_by_query.json
@@ -1,6 +1,7 @@
 {
   "update_by_query": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/docs-update-by-query.html",
+    "stability": "stable",
     "methods": ["POST"],
     "url": {
       "path": "/{index}/_update_by_query",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/update_by_query_rethrottle.json b/rest-api-spec/src/main/resources/rest-api-spec/api/update_by_query_rethrottle.json
index 9ec2540b43006..6e48ffc1d8a0f 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/update_by_query_rethrottle.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/update_by_query_rethrottle.json
@@ -1,6 +1,7 @@
 {
   "update_by_query_rethrottle": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-update-by-query.html",
+    "stability": "stable",
     "methods": ["POST"],
     "url": {
       "path": "/_update_by_query/{task_id}/_rethrottle",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.delete_data_frame_transform.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.delete_data_frame_transform.json
index 14478f72c9afe..b49bf30b48b1b 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.delete_data_frame_transform.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.delete_data_frame_transform.json
@@ -1,6 +1,7 @@
 {
   "data_frame.delete_data_frame_transform": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/delete-data-frame-transform.html",
+    "stability": "private",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_data_frame/transforms/{transform_id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.get_data_frame_transform.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.get_data_frame_transform.json
index 5bf6dd25fb546..f9a88ae553e2f 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.get_data_frame_transform.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.get_data_frame_transform.json
@@ -1,6 +1,7 @@
 {
   "data_frame.get_data_frame_transform": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/get-data-frame-transform.html",
+    "stability": "private",
     "methods": [ "GET" ],
     "url": {
       "path": "/_data_frame/transforms/{transform_id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.get_data_frame_transform_stats.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.get_data_frame_transform_stats.json
index b100c7e0a2471..64c9e5e33e173 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.get_data_frame_transform_stats.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.get_data_frame_transform_stats.json
@@ -1,6 +1,7 @@
 {
   "data_frame.get_data_frame_transform_stats": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/get-data-frame-transform-stats.html",
+    "stability": "private",
     "methods": [ "GET" ],
     "url": {
       "path": "/_data_frame/transforms/{transform_id}/_stats",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.preview_data_frame_transform.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.preview_data_frame_transform.json
index c8cf76e90d340..d4dbe48e1d681 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.preview_data_frame_transform.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.preview_data_frame_transform.json
@@ -1,6 +1,7 @@
 {
   "data_frame.preview_data_frame_transform": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/preview-data-frame-transform.html",
+    "stability": "private",
     "methods": [ "POST" ],
     "url": {
       "path": "/_data_frame/transforms/_preview",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.put_data_frame_transform.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.put_data_frame_transform.json
index cef6de3a2b6e4..744c446f037ca 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.put_data_frame_transform.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.put_data_frame_transform.json
@@ -1,6 +1,7 @@
 {
   "data_frame.put_data_frame_transform": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/put-data-frame-transform.html",
+    "stability": "private",
     "methods": [ "PUT" ],
     "url": {
       "path": "/_data_frame/transforms/{transform_id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.start_data_frame_transform.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.start_data_frame_transform.json
index f2dd8e529f47d..04d7cc58bd0a5 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.start_data_frame_transform.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.start_data_frame_transform.json
@@ -1,6 +1,7 @@
 {
   "data_frame.start_data_frame_transform": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/start-data-frame-transform.html",
+    "stability": "private",
     "methods": [ "POST" ],
     "url": {
       "path": "/_data_frame/transforms/{transform_id}/_start",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.stop_data_frame_transform.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.stop_data_frame_transform.json
index f4f548b9aa0eb..98a5638ffae44 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.stop_data_frame_transform.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.stop_data_frame_transform.json
@@ -1,6 +1,7 @@
 {
   "data_frame.stop_data_frame_transform": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/stop-data-frame-transform.html",
+    "stability": "private",
     "methods": [ "POST" ],
     "url": {
       "path": "/_data_frame/transforms/{transform_id}/_stop",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/graph.explore.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/graph.explore.json
index b01c51bc6c381..3b75c84cef225 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/graph.explore.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/graph.explore.json
@@ -1,6 +1,7 @@
 {
   "graph.explore": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/graph-explore-api.html",
+    "stability": "stable",
     "methods": ["GET", "POST"],
     "url": {
       "path": "/{index}/_graph/explore",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.delete_lifecycle.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.delete_lifecycle.json
index cee1660fb1f84..280a9e179f57b 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.delete_lifecycle.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.delete_lifecycle.json
@@ -1,6 +1,7 @@
 {
   "ilm.delete_lifecycle": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ilm-delete-lifecycle.html",
+    "stability": "stable",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_ilm/policy/{policy}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.explain_lifecycle.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.explain_lifecycle.json
index 2441e64264809..bf3dfa6b6ac2b 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.explain_lifecycle.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.explain_lifecycle.json
@@ -1,6 +1,7 @@
 {
   "ilm.explain_lifecycle": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ilm-explain-lifecycle.html",
+    "stability": "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/{index}/_ilm/explain",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.get_lifecycle.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.get_lifecycle.json
index 3526ff40aee46..f396b97acca60 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.get_lifecycle.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.get_lifecycle.json
@@ -1,6 +1,7 @@
 {
   "ilm.get_lifecycle": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ilm-get-lifecycle.html",
+    "stability": "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/_ilm/policy/{policy}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.get_status.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.get_status.json
index 70aec541a115b..0a52062c5201f 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.get_status.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.get_status.json
@@ -1,6 +1,7 @@
 {
   "ilm.get_status": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ilm-get-status.html",
+    "stability": "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/_ilm/status",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.move_to_step.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.move_to_step.json
index e3adf2d30e681..b8b12b3f4b7c1 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.move_to_step.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.move_to_step.json
@@ -1,6 +1,7 @@
 {
   "ilm.move_to_step": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ilm-move-to-step.html",
+    "stability": "stable",
     "description": "Triggers execution of a specific step in the lifecycle policy. Since this action is designed to only be run in emergency situations, clients should not implement this API",
     "methods": [ "POST" ],
     "url": {
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.put_lifecycle.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.put_lifecycle.json
index 4d93becbcc9a2..0e65929c4a848 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.put_lifecycle.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.put_lifecycle.json
@@ -1,6 +1,7 @@
 {
   "ilm.put_lifecycle": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ilm-put-lifecycle.html",
+    "stability": "stable",
     "methods": [ "PUT" ],
     "url": {
       "path": "/_ilm/policy/{policy}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.remove_policy.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.remove_policy.json
index d9903ff8dc40d..78f825609287f 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.remove_policy.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.remove_policy.json
@@ -1,6 +1,7 @@
 {
   "ilm.remove_policy": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ilm-remove-policy.html",
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/{index}/_ilm/remove",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.retry.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.retry.json
index 41edd6a83c2eb..6539b288594d0 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.retry.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.retry.json
@@ -1,6 +1,7 @@
 {
   "ilm.retry": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ilm-retry-policy.html",
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/{index}/_ilm/retry",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.start.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.start.json
index d20b3187b7e33..f0a6d8530e0a7 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.start.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.start.json
@@ -1,6 +1,7 @@
 {
   "ilm.start": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ilm-start.html",
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/_ilm/start",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.stop.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.stop.json
index eaf75a885b8aa..93be04a34311d 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.stop.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ilm.stop.json
@@ -1,6 +1,7 @@
 {
   "ilm.stop": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ilm-stop.html",
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/_ilm/stop",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/indices.freeze.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/indices.freeze.json
index a602f341e1524..044055c0ad3b9 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/indices.freeze.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/indices.freeze.json
@@ -1,6 +1,7 @@
 {
   "indices.freeze": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/frozen.html",
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/{index}/_freeze",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/indices.unfreeze.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/indices.unfreeze.json
index b10e869a95758..c121b0c63fbd2 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/indices.unfreeze.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/indices.unfreeze.json
@@ -1,6 +1,7 @@
 {
   "indices.unfreeze": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/frozen.html",
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/{index}/_unfreeze",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/license.delete.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/license.delete.json
index a85552e557597..2c19ffda0f72f 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/license.delete.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/license.delete.json
@@ -1,6 +1,7 @@
 {
   "license.delete": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/delete-license.html",
+    "stability": "stable",
     "methods": ["DELETE"],
     "url": {
       "path": "/_license",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/license.get.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/license.get.json
index 07a570935a6b7..e5da64e8855eb 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/license.get.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/license.get.json
@@ -1,6 +1,7 @@
 {
   "license.get": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/get-license.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_license",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/license.get_basic_status.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/license.get_basic_status.json
index cfb5608ac4063..4332eff0a351f 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/license.get_basic_status.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/license.get_basic_status.json
@@ -1,6 +1,7 @@
 {
   "license.get_basic_status": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/get-basic-status.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_license/basic_status",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/license.get_trial_status.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/license.get_trial_status.json
index daeb4913ad9eb..2fca7e9cebe8d 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/license.get_trial_status.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/license.get_trial_status.json
@@ -1,6 +1,7 @@
 {
   "license.get_trial_status": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/get-trial-status.html",
+    "stability": "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_license/trial_status",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/license.post.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/license.post.json
index 1bd78a1fb6af5..e0447be9bc75e 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/license.post.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/license.post.json
@@ -1,6 +1,7 @@
 {
   "license.post": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/update-license.html",
+    "stability": "stable",
     "methods": ["PUT", "POST"],
     "url": {
       "path": "/_license",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/license.post_start_basic.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/license.post_start_basic.json
index 91da4de9ff0a2..c6acbb0b46297 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/license.post_start_basic.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/license.post_start_basic.json
@@ -1,6 +1,7 @@
 {
   "license.post_start_basic": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/start-basic.html",
+    "stability": "stable",
     "methods": ["POST"],
     "url": {
       "path": "/_license/start_basic",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/license.post_start_trial.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/license.post_start_trial.json
index 55a73df4946b5..87966a6b7b11b 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/license.post_start_trial.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/license.post_start_trial.json
@@ -1,6 +1,7 @@
 {
   "license.post_start_trial": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/start-trial.html",
+    "stability": "stable",
     "methods": ["POST"],
     "url": {
       "path": "/_license/start_trial",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/migration.deprecations.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/migration.deprecations.json
index 7c7ad54f095a6..130fb213c520e 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/migration.deprecations.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/migration.deprecations.json
@@ -1,6 +1,7 @@
 {
   "migration.deprecations": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/migration-api-deprecation.html",
+    "stability": "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/{index}/_migration/deprecations",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.close_job.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.close_job.json
index ab32b89f9c264..62a5e5a21d4c7 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.close_job.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.close_job.json
@@ -1,5 +1,6 @@
 {
   "ml.close_job": {
+    "stability": "stable",
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-close-job.html",
     "methods": [ "POST" ],
     "url": {
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_calendar.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_calendar.json
index 0eb3a61cdf887..d6ea65c902fbf 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_calendar.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_calendar.json
@@ -1,5 +1,6 @@
 {
   "ml.delete_calendar": {
+    "stability": "stable",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_ml/calendars/{calendar_id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_calendar_event.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_calendar_event.json
index 91b041f6c5141..8c746c3c767b6 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_calendar_event.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_calendar_event.json
@@ -1,5 +1,6 @@
 {
   "ml.delete_calendar_event": {
+    "stability": "stable",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_ml/calendars/{calendar_id}/events/{event_id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_calendar_job.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_calendar_job.json
index 196eb78e9936d..ed850506fdf8a 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_calendar_job.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_calendar_job.json
@@ -1,5 +1,6 @@
 {
   "ml.delete_calendar_job": {
+    "stability": "stable",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_ml/calendars/{calendar_id}/jobs/{job_id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_datafeed.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_datafeed.json
index 039d6ee3273c3..b13672aa25629 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_datafeed.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_datafeed.json
@@ -1,5 +1,6 @@
 {
   "ml.delete_datafeed": {
+    "stability": "stable",
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-delete-datafeed.html",
     "methods": [ "DELETE" ],
     "url": {
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_expired_data.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_expired_data.json
index 2bb04bd286016..3f9a7107fd23b 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_expired_data.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_expired_data.json
@@ -1,5 +1,6 @@
 {
   "ml.delete_expired_data": {
+    "stability": "stable",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_ml/_delete_expired_data",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_filter.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_filter.json
index c4bd51988b030..f9b6073a86fd8 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_filter.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_filter.json
@@ -1,6 +1,7 @@
 {
   "ml.delete_filter": {
     "methods": [ "DELETE" ],
+    "stability": "stable",
     "url": {
       "path": "/_ml/filters/{filter_id}",
       "paths": [ "/_ml/filters/{filter_id}" ],
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_forecast.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_forecast.json
index ef6ad3406e6c0..c10b36290b33b 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_forecast.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_forecast.json
@@ -1,6 +1,7 @@
 {
   "ml.delete_forecast": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-delete-forecast.html",
+    "stability": "stable",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_ml/anomaly_detectors/{job_id}/_forecast/{forecast_id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_job.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_job.json
index 550505a263525..5ffad0a5653cf 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_job.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_job.json
@@ -1,6 +1,7 @@
 {
   "ml.delete_job": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-delete-job.html",
+    "stability": "stable",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_ml/anomaly_detectors/{job_id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_model_snapshot.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_model_snapshot.json
index d61c0ec46c5e5..3fec6d943c291 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_model_snapshot.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_model_snapshot.json
@@ -1,6 +1,7 @@
 {
   "ml.delete_model_snapshot": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-delete-snapshot.html",
+    "stability": "stable",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_ml/anomaly_detectors/{job_id}/model_snapshots/{snapshot_id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.flush_job.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.flush_job.json
index 22a59928fc2bf..a17405589682c 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.flush_job.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.flush_job.json
@@ -1,9 +1,8 @@
 {
   "ml.flush_job": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-flush-job.html",
-    "methods": [
-      "POST"
-    ],
+    "stability": "stable",
+    "methods": [ "POST" ],
     "url": {
       "path": "/_ml/anomaly_detectors/{job_id}/_flush",
       "paths": [
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.forecast.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.forecast.json
index 050b80be4c9bd..68f6cd257982d 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.forecast.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.forecast.json
@@ -1,5 +1,6 @@
 {
   "ml.forecast": {
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/_ml/anomaly_detectors/{job_id}/_forecast",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_buckets.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_buckets.json
index a861eb1f7d59f..3536ce407cebf 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_buckets.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_buckets.json
@@ -1,6 +1,7 @@
 {
   "ml.get_buckets": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-get-bucket.html",
+    "stability": "stable",
     "methods": [ "GET", "POST" ],
     "url": {
       "path": "/_ml/anomaly_detectors/{job_id}/results/buckets/{timestamp}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_calendar_events.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_calendar_events.json
index 2252db62618fb..e1566412cf9c3 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_calendar_events.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_calendar_events.json
@@ -1,5 +1,6 @@
 {
   "ml.get_calendar_events": {
+    "stability": "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/_ml/calendars/{calendar_id}/events",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_calendars.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_calendars.json
index de2e192d7e072..d5f014f5013c7 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_calendars.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_calendars.json
@@ -1,5 +1,6 @@
 {
   "ml.get_calendars": {
+    "stability": "stable",
     "methods": [ "GET", "POST" ],
     "url": {
       "path": "/_ml/calendars/{calendar_id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_categories.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_categories.json
index a096ba07986cc..785e8b777614f 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_categories.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_categories.json
@@ -1,6 +1,7 @@
 {
   "ml.get_categories": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-get-category.html",
+    "stability": "stable",
     "methods": [ "GET", "POST" ],
     "url": {
       "path": "/_ml/anomaly_detectors/{job_id}/results/categories/{category_id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_datafeed_stats.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_datafeed_stats.json
index 155701dbee5fa..c25dad32f2b53 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_datafeed_stats.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_datafeed_stats.json
@@ -1,6 +1,7 @@
 {
   "ml.get_datafeed_stats": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-get-datafeed-stats.html",
+    "stability": "stable",
     "methods": [ "GET"],
     "url": {
       "path": "/_ml/datafeeds/{datafeed_id}/_stats",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_datafeeds.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_datafeeds.json
index c911079cd2217..046229ab08e3c 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_datafeeds.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_datafeeds.json
@@ -1,6 +1,7 @@
 {
   "ml.get_datafeeds": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-get-datafeed.html",
+    "stability": "stable",
     "methods": [ "GET"],
     "url": {
       "path": "/_ml/datafeeds/{datafeed_id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_filters.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_filters.json
index c544b6dd37a34..85014c7a22801 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_filters.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_filters.json
@@ -1,5 +1,6 @@
 {
   "ml.get_filters": {
+    "stability": "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/_ml/filters/{filter_id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_influencers.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_influencers.json
index adb8206dbf03c..fa7babd87ea3b 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_influencers.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_influencers.json
@@ -1,6 +1,7 @@
 {
   "ml.get_influencers": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-get-influencer.html",
+    "stability": "stable",
     "methods": [ "GET", "POST" ],
     "url": {
       "path": "/_ml/anomaly_detectors/{job_id}/results/influencers",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_job_stats.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_job_stats.json
index 66b7c836df513..9126956fbc2a3 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_job_stats.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_job_stats.json
@@ -1,6 +1,7 @@
 {
   "ml.get_job_stats": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-get-job-stats.html",
+    "stability": "stable",
     "methods": [ "GET"],
     "url": {
       "path": "/_ml/anomaly_detectors/{job_id}/_stats",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_jobs.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_jobs.json
index 6777b9ffb7747..8d3c6f5c2f134 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_jobs.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_jobs.json
@@ -1,6 +1,7 @@
 {
   "ml.get_jobs": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-get-job.html",
+    "stability": "stable",
     "methods": [ "GET"],
     "url": {
       "path": "/_ml/anomaly_detectors/{job_id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_model_snapshots.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_model_snapshots.json
index 04a6eba021494..3b2fe255e45f0 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_model_snapshots.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_model_snapshots.json
@@ -1,6 +1,7 @@
 {
   "ml.get_model_snapshots": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-get-snapshot.html",
+    "stability": "stable",
     "methods": [ "GET", "POST" ],
     "url": {
       "path": "/_ml/anomaly_detectors/{job_id}/model_snapshots/{snapshot_id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_overall_buckets.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_overall_buckets.json
index 679aa67d3ccd6..66d620a05b3b3 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_overall_buckets.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_overall_buckets.json
@@ -1,6 +1,7 @@
 {
   "ml.get_overall_buckets": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-get-overall-buckets.html",
+    "stability": "stable",
     "methods": [ "GET", "POST" ],
     "url": {
       "path": "/_ml/anomaly_detectors/{job_id}/results/overall_buckets",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_records.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_records.json
index 4831629b90c6f..e80bb9ec73cc9 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_records.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.get_records.json
@@ -1,6 +1,7 @@
 {
   "ml.get_records": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-get-record.html",
+    "stability": "stable",
     "methods": ["GET", "POST"],
     "url": {
       "path": "/_ml/anomaly_detectors/{job_id}/results/records",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.info.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.info.json
index 5afbaffd1fcd6..2daa293d8b330 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.info.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.info.json
@@ -1,5 +1,6 @@
 {
   "ml.info": {
+    "stability": "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/_ml/info",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.open_job.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.open_job.json
index 331f71132b927..9c95f08993f14 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.open_job.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.open_job.json
@@ -1,5 +1,6 @@
 {
   "ml.open_job": {
+    "stability": "stable",
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-open-job.html",
     "methods": [ "POST" ],
     "url": {
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.post_calendar_events.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.post_calendar_events.json
index 6775317ec6aec..e844e2475cdb7 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.post_calendar_events.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.post_calendar_events.json
@@ -1,5 +1,6 @@
 {
   "ml.post_calendar_events": {
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/_ml/calendars/{calendar_id}/events",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.post_data.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.post_data.json
index 9acf4883e9344..9c6fc67efe493 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.post_data.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.post_data.json
@@ -1,6 +1,7 @@
 {
   "ml.post_data": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-post-data.html",
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/_ml/anomaly_detectors/{job_id}/_data",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.preview_datafeed.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.preview_datafeed.json
index 1d48948fb7c02..0e4b0bd300028 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.preview_datafeed.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.preview_datafeed.json
@@ -1,6 +1,7 @@
 {
   "ml.preview_datafeed": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-preview-datafeed.html",
+    "stability": "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/_ml/datafeeds/{datafeed_id}/_preview",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_calendar.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_calendar.json
index 4a5473cd49699..c8d84bf9862f6 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_calendar.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_calendar.json
@@ -1,5 +1,6 @@
 {
   "ml.put_calendar": {
+    "stability": "stable",
     "methods": [ "PUT" ],
     "url": {
       "path": "/_ml/calendars/{calendar_id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_calendar_job.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_calendar_job.json
index e17fdacd167f2..2dcc5c0b16d50 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_calendar_job.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_calendar_job.json
@@ -1,5 +1,6 @@
 {
   "ml.put_calendar_job": {
+    "stability": "stable",
     "methods": [ "PUT" ],
     "url": {
       "path": "/_ml/calendars/{calendar_id}/jobs/{job_id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_datafeed.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_datafeed.json
index 8545d0727d7d7..f2741b42d8770 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_datafeed.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_datafeed.json
@@ -1,6 +1,7 @@
 {
   "ml.put_datafeed": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-put-datafeed.html",
+    "stability": "stable",
     "methods": [ "PUT" ],
     "url": {
       "path": "/_ml/datafeeds/{datafeed_id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_filter.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_filter.json
index 3ef67502b6464..cffbc9d6536e5 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_filter.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_filter.json
@@ -1,5 +1,6 @@
 {
   "ml.put_filter": {
+    "stability": "stable",
     "methods": [ "PUT" ],
     "url": {
       "path": "/_ml/filters/{filter_id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_job.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_job.json
index 01bb28290acc6..8e3713a6ea964 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_job.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.put_job.json
@@ -1,6 +1,7 @@
 {
   "ml.put_job": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-put-job.html",
+    "stability": "stable",
     "methods": [ "PUT" ],
     "url": {
       "path": "/_ml/anomaly_detectors/{job_id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.revert_model_snapshot.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.revert_model_snapshot.json
index 3c71279c23bf0..47e216ac47946 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.revert_model_snapshot.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.revert_model_snapshot.json
@@ -1,6 +1,7 @@
 {
   "ml.revert_model_snapshot": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-revert-snapshot.html",
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/_ml/anomaly_detectors/{job_id}/model_snapshots/{snapshot_id}/_revert",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.set_upgrade_mode.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.set_upgrade_mode.json
index 5406d2d06eceb..5101b73c0b0a4 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.set_upgrade_mode.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.set_upgrade_mode.json
@@ -1,6 +1,7 @@
 {
   "ml.set_upgrade_mode": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-set-upgrade-mode.html",
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/_ml/set_upgrade_mode",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.start_datafeed.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.start_datafeed.json
index ce3fd9cdf4b80..4747e3d5fe86f 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.start_datafeed.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.start_datafeed.json
@@ -1,6 +1,7 @@
 {
   "ml.start_datafeed": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-start-datafeed.html",
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/_ml/datafeeds/{datafeed_id}/_start",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.stop_datafeed.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.stop_datafeed.json
index 96d28abc15118..97a24abd396e8 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.stop_datafeed.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.stop_datafeed.json
@@ -1,9 +1,8 @@
 {
   "ml.stop_datafeed": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-stop-datafeed.html",
-    "methods": [
-      "POST"
-    ],
+    "stability": "stable",
+    "methods": [ "POST" ],
     "url": {
       "path": "/_ml/datafeeds/{datafeed_id}/_stop",
       "paths": [
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.update_datafeed.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.update_datafeed.json
index aebeade84e20e..8e20a95d7ff01 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.update_datafeed.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.update_datafeed.json
@@ -1,6 +1,7 @@
 {
   "ml.update_datafeed": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-update-datafeed.html",
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/_ml/datafeeds/{datafeed_id}/_update",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.update_filter.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.update_filter.json
index d55fb80755a31..03ca1c45f5812 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.update_filter.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.update_filter.json
@@ -1,5 +1,6 @@
 {
   "ml.update_filter": {
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/_ml/filters/{filter_id}/_update",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.update_job.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.update_job.json
index f2a9a29a416b4..85135919ac33d 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.update_job.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.update_job.json
@@ -1,6 +1,7 @@
 {
   "ml.update_job": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-update-job.html",
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/_ml/anomaly_detectors/{job_id}/_update",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.update_model_snapshot.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.update_model_snapshot.json
index ba57e18b0aad6..2cb4f0a9ccfbb 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.update_model_snapshot.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.update_model_snapshot.json
@@ -1,6 +1,7 @@
 {
   "ml.update_model_snapshot": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-update-snapshot.html",
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/_ml/anomaly_detectors/{job_id}/model_snapshots/{snapshot_id}/_update",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.validate.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.validate.json
index 140057db9fcfd..5464566e52ebb 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.validate.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.validate.json
@@ -1,5 +1,6 @@
 {
   "ml.validate": {
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/_ml/anomaly_detectors/_validate",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.validate_detector.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.validate_detector.json
index 33e91b6832b9f..e8e9b3d064c47 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.validate_detector.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.validate_detector.json
@@ -1,5 +1,6 @@
 {
   "ml.validate_detector": {
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/_ml/anomaly_detectors/_validate/detector",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.authenticate.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.authenticate.json
index 394ad0d8dbe45..98f1ef7b6ddb7 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.authenticate.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.authenticate.json
@@ -1,6 +1,7 @@
 {
   "security.authenticate": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-authenticate.html",
+    "stability": "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/_security/_authenticate",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.change_password.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.change_password.json
index 9e94102fc23e9..42050e079b312 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.change_password.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.change_password.json
@@ -1,6 +1,7 @@
 {
   "security.change_password": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-change-password.html",
+    "stability": "stable",
     "methods": [ "PUT", "POST" ],
     "url": {
       "path": "/_security/user/{username}/_password",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.clear_cached_realms.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.clear_cached_realms.json
index 9e986d615a257..869a926ce250a 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.clear_cached_realms.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.clear_cached_realms.json
@@ -1,6 +1,7 @@
 {
   "security.clear_cached_realms": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-clear-cache.html",
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/_security/realm/{realms}/_clear_cache",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.clear_cached_roles.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.clear_cached_roles.json
index 1c39ea9ade349..d34f9a14c8a67 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.clear_cached_roles.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.clear_cached_roles.json
@@ -1,6 +1,7 @@
 {
   "security.clear_cached_roles": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-clear-role-cache.html",
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/_security/role/{name}/_clear_cache",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.create_api_key.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.create_api_key.json
index 30b5b30a52b61..2de0d1bd501b8 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.create_api_key.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.create_api_key.json
@@ -1,6 +1,7 @@
 {
   "security.create_api_key": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-create-api-key.html",
+    "stability": "stable",
     "methods": [ "PUT", "POST" ],
     "url": {
       "path": "/_security/api_key",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.delete_privileges.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.delete_privileges.json
index 13231572ab79a..e8a8c2cd4c7e0 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.delete_privileges.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.delete_privileges.json
@@ -1,6 +1,7 @@
 {
   "security.delete_privileges": {
     "documentation": "TODO",
+    "stability": "stable",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_security/privilege/{application}/{name}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.delete_role.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.delete_role.json
index 8e4a17988f536..224a01aed4e1d 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.delete_role.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.delete_role.json
@@ -1,6 +1,7 @@
 {
   "security.delete_role": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-delete-role.html",
+    "stability": "stable",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_security/role/{name}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.delete_role_mapping.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.delete_role_mapping.json
index 5aff743b45bdd..4342fafd06523 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.delete_role_mapping.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.delete_role_mapping.json
@@ -1,6 +1,7 @@
 {
   "security.delete_role_mapping": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-delete-role-mapping.html",
+    "stability": "stable",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_security/role_mapping/{name}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.delete_user.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.delete_user.json
index 175d9925f00a6..46c76ae4376e2 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.delete_user.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.delete_user.json
@@ -1,6 +1,7 @@
 {
   "security.delete_user": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-delete-user.html",
+    "stability": "stable",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_security/user/{username}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.disable_user.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.disable_user.json
index 3aa50467fb546..cb3e05d137272 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.disable_user.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.disable_user.json
@@ -1,6 +1,7 @@
 {
   "security.disable_user": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-disable-user.html",
+    "stability": "stable",
     "methods": [ "PUT", "POST" ],
     "url": {
       "path": "/_security/user/{username}/_disable",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.enable_user.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.enable_user.json
index 950a2b54939cd..e3e40d080e2f2 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.enable_user.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.enable_user.json
@@ -1,6 +1,7 @@
 {
   "security.enable_user": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-enable-user.html",
+    "stability": "stable",
     "methods": [ "PUT", "POST" ],
     "url": {
       "path": "/_security/user/{username}/_enable",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_api_key.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_api_key.json
index f534d2a220e84..79c2d4c0b142e 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_api_key.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_api_key.json
@@ -1,6 +1,7 @@
 {
   "security.get_api_key": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-get-api-key.html",
+    "stability": "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/_security/api_key",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_privileges.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_privileges.json
index 2cf10a872d519..77f505808957d 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_privileges.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_privileges.json
@@ -1,6 +1,7 @@
 {
   "security.get_privileges": {
     "documentation": "TODO",
+    "stability": "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/_security/privilege/{application}/{name}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_role.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_role.json
index 412127ce157e4..1b80f4297aa92 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_role.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_role.json
@@ -1,6 +1,7 @@
 {
   "security.get_role": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-get-role.html",
+    "stability": "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/_security/role/{name}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_role_mapping.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_role_mapping.json
index 169ef451b3cb8..e1d2d7e556a74 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_role_mapping.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_role_mapping.json
@@ -1,6 +1,7 @@
 {
   "security.get_role_mapping": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-get-role-mapping.html",
+    "stability": "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/_security/role_mapping/{name}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_token.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_token.json
index 9ecc8091797b8..d01160eaf49f0 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_token.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_token.json
@@ -1,6 +1,7 @@
 {
   "security.get_token": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-get-token.html",
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/_security/oauth2/token",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_user.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_user.json
index ed6e7069dca31..909e99128ad28 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_user.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_user.json
@@ -1,6 +1,7 @@
 {
   "security.get_user": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-get-user.html",
+    "stability": "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/_security/user/{username}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_user_privileges.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_user_privileges.json
index b60298f89e017..2304a578214b3 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_user_privileges.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.get_user_privileges.json
@@ -1,6 +1,7 @@
 {
   "security.get_user_privileges": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-get-privileges.html",
+    "stability": "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/_security/user/_privileges",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.has_privileges.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.has_privileges.json
index c388f766c9829..e29514ba40a25 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.has_privileges.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.has_privileges.json
@@ -1,6 +1,7 @@
 {
   "security.has_privileges": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-has-privileges.html",
+    "stability": "stable",
     "methods": [ "GET", "POST" ],
     "url": {
       "path": "/_security/user/_has_privileges",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.invalidate_api_key.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.invalidate_api_key.json
index fa0639704aa9a..b0c9405642296 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.invalidate_api_key.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.invalidate_api_key.json
@@ -1,6 +1,7 @@
 {
   "security.invalidate_api_key": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-invalidate-api-key.html",
+    "stability": "stable",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_security/api_key",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.invalidate_token.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.invalidate_token.json
index 7938825e5b12e..40dfd57b7535c 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.invalidate_token.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.invalidate_token.json
@@ -1,6 +1,7 @@
 {
   "security.invalidate_token": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-invalidate-token.html",
+    "stability": "stable",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_security/oauth2/token",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.put_privileges.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.put_privileges.json
index 20b8d8418ab1f..d21a2e88596cf 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.put_privileges.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.put_privileges.json
@@ -1,6 +1,7 @@
 {
   "security.put_privileges": {
     "documentation": "TODO",
+    "stability": "stable",
     "methods": [ "PUT", "POST" ],
     "url": {
       "path": "/_security/privilege/",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.put_role.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.put_role.json
index 8539d198c70e7..2c4f6890b68c1 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.put_role.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.put_role.json
@@ -1,6 +1,7 @@
 {
   "security.put_role": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-put-role.html",
+    "stability": "stable",
     "methods": [ "PUT", "POST" ],
     "url": {
       "path": "/_security/role/{name}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.put_role_mapping.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.put_role_mapping.json
index d65cf8f835833..17ed15e4ee39f 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.put_role_mapping.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.put_role_mapping.json
@@ -1,6 +1,7 @@
 {
   "security.put_role_mapping": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-put-role-mapping.html",
+    "stability": "stable",
     "methods": [ "PUT", "POST" ],
     "url": {
       "path": "/_security/role_mapping/{name}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.put_user.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.put_user.json
index a1a77c5bb4e9f..9dbec9649578e 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/security.put_user.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/security.put_user.json
@@ -1,6 +1,7 @@
 {
   "security.put_user": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-put-user.html",
+    "stability": "stable",
     "methods": [ "PUT", "POST" ],
     "url": {
       "path": "/_security/user/{username}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ssl.certificates.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ssl.certificates.json
index 10715cd5380fe..3c9d6529aecf9 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ssl.certificates.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ssl.certificates.json
@@ -1,6 +1,7 @@
 {
   "ssl.certificates": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-ssl.html",
+    "stability": "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/_ssl/certificates",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.ack_watch.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.ack_watch.json
index 4920c986a042f..9e74943be59a6 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.ack_watch.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.ack_watch.json
@@ -1,6 +1,7 @@
 {
   "watcher.ack_watch": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/watcher-api-ack-watch.html",
+    "stability": "stable",
     "methods": [ "PUT", "POST" ],
     "url": {
       "path": "/_watcher/watch/{watch_id}/_ack",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.activate_watch.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.activate_watch.json
index 49fb169dede77..cfbfa03f88d96 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.activate_watch.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.activate_watch.json
@@ -1,6 +1,7 @@
 {
   "watcher.activate_watch": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/watcher-api-activate-watch.html",
+    "stability": "stable",
     "methods": [ "PUT", "POST" ],
     "url": {
       "path": "/_watcher/watch/{watch_id}/_activate",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.deactivate_watch.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.deactivate_watch.json
index ddc68b439395e..db9f88301bf34 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.deactivate_watch.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.deactivate_watch.json
@@ -1,6 +1,7 @@
 {
   "watcher.deactivate_watch": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/watcher-api-deactivate-watch.html",
+    "stability": "stable",
     "methods": [ "PUT", "POST" ],
     "url": {
       "path": "/_watcher/watch/{watch_id}/_deactivate",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.delete_watch.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.delete_watch.json
index cdf61ad52023f..9db3093db8f78 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.delete_watch.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.delete_watch.json
@@ -1,7 +1,7 @@
 {
   "watcher.delete_watch": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/watcher-api-delete-watch.html",
-
+    "stability": "stable",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_watcher/watch/{id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.execute_watch.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.execute_watch.json
index 6db8f3ae115f5..f340040c8e129 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.execute_watch.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.execute_watch.json
@@ -1,6 +1,7 @@
 {
   "watcher.execute_watch": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/watcher-api-execute-watch.html",
+    "stability": "stable",
     "methods": [ "PUT", "POST" ],
     "url": {
       "path": "/_watcher/watch/{id}/_execute",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.get_watch.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.get_watch.json
index 81f21b4b0c1e5..55d25368c6242 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.get_watch.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.get_watch.json
@@ -1,6 +1,7 @@
 {
   "watcher.get_watch": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/watcher-api-get-watch.html",
+    "stability": "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/_watcher/watch/{id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.put_watch.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.put_watch.json
index 24f020a7b90b4..98f4b9fec7231 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.put_watch.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.put_watch.json
@@ -1,6 +1,7 @@
 {
   "watcher.put_watch": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/watcher-api-put-watch.html",
+    "stability": "stable",
     "methods": [ "PUT", "POST" ],
     "url": {
       "path": "/_watcher/watch/{id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.start.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.start.json
index 649b21c7db3f1..aff144c56593a 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.start.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.start.json
@@ -1,6 +1,7 @@
 {
   "watcher.start": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/watcher-api-start.html",
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/_watcher/_start",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.stats.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.stats.json
index 01241848ab9f3..3b77a50ce7b25 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.stats.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.stats.json
@@ -1,6 +1,7 @@
 {
   "watcher.stats": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/watcher-api-stats.html",
+    "stability": "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/_watcher/stats",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.stop.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.stop.json
index 4deee79436e2d..3f4f5b5b235a2 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.stop.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/watcher.stop.json
@@ -1,6 +1,7 @@
 {
   "watcher.stop": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/watcher-api-stop.html",
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/_watcher/_stop",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/xpack.info.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/xpack.info.json
index 9913bc3fba6df..157cbbbce110c 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/xpack.info.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/xpack.info.json
@@ -1,6 +1,7 @@
 {
   "xpack.info": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/info-api.html",
+    "stability": "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/_xpack",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/xpack.usage.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/xpack.usage.json
index 8476c1f06d61b..b6234aa5b7723 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/xpack.usage.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/xpack.usage.json
@@ -1,6 +1,7 @@
 {
   "xpack.usage": {
     "documentation": "Retrieve information about xpack features usage",
+    "stability": "stable",
     "methods": [ "GET" ],
     "url": {
       "path": "/_xpack/usage",

From 9bcaf2168f5854848c57c67990947506f7384160 Mon Sep 17 00:00:00 2001
From: Mpdreamz <Mpdreamz@gmail.com>
Date: Tue, 23 Apr 2019 15:24:00 +0200
Subject: [PATCH 08/15] Document the fact that stability needs to be defined

Otherwise the YAML test runner will fail (with a nice exception message)
---
 rest-api-spec/README.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/rest-api-spec/README.markdown b/rest-api-spec/README.markdown
index d6209f5683343..fa4d72819ff89 100644
--- a/rest-api-spec/README.markdown
+++ b/rest-api-spec/README.markdown
@@ -40,7 +40,7 @@ The specification contains:
 
 * The _name_ of the API (`indices.create`), which usually corresponds to the client calls
 * Link to the documentation at <http://elastic.co>
-* `stability` indicating the state of the API, defaults to `stable`
+* `stability` indicating the state of the API, has to be declared explicitly or YAML tests will fail
     * `private` this API should not be be implemented by clients
     * `experimental` highly likely to break in the near future (minor/path), no bwc guarantees. 
     Possibly removed in the future.

From 1467a6320957d85fb7828c61b3681e83550e7785 Mon Sep 17 00:00:00 2001
From: Mpdreamz <Mpdreamz@gmail.com>
Date: Tue, 23 Apr 2019 18:09:11 +0200
Subject: [PATCH 09/15] address check style violations

---
 .../test/rest/yaml/restspec/ClientYamlSuiteRestApi.java    | 7 ++++++-
 .../rest/yaml/restspec/ClientYamlSuiteRestApiParser.java   | 4 ++--
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApi.java b/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApi.java
index ff4f0c7179b79..a32e6b3ca03d5 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApi.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApi.java
@@ -21,7 +21,12 @@
 import org.apache.http.client.methods.HttpPost;
 import org.apache.http.client.methods.HttpPut;
 
-import java.util.*;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Set;
 
 /**
  * Specification of an Elasticsearch endpoint used by the YAML specs to generate REST requests.
diff --git a/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApiParser.java b/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApiParser.java
index f7edd1029fb98..cd797ae4e0705 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApiParser.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApiParser.java
@@ -23,7 +23,6 @@
 import org.elasticsearch.common.xcontent.XContentParser;
 
 import java.io.IOException;
-import java.util.Locale;
 
 /**
  * Parser for a {@link ClientYamlSuiteRestApi}.
@@ -60,7 +59,8 @@ public ClientYamlSuiteRestApi parse(String location, XContentParser parser) thro
                         restApi.setStability(stability);
                     } catch (IllegalArgumentException ex)
                     {
-                        throw new IllegalArgumentException("API [" + apiName + "] sets wrong state for stability (" + stability + ") [" + location + "]");
+                        throw new IllegalArgumentException("API [" + apiName + "] sets wrong state for stability ("
+                            + stability + ") [" + location + "]");
                     }
                 }
 

From 433f4dd18aef436dcad11da07b06d2f21415aab3 Mon Sep 17 00:00:00 2001
From: Mpdreamz <Mpdreamz@gmail.com>
Date: Tue, 23 Apr 2019 18:37:12 +0200
Subject: [PATCH 10/15] update rest spec unit tests to include stability

---
 .../restspec/ClientYamlSuiteRestApiParserFailingTests.java    | 4 ++++
 .../rest/yaml/restspec/ClientYamlSuiteRestApiParserTests.java | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/test/framework/src/test/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApiParserFailingTests.java b/test/framework/src/test/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApiParserFailingTests.java
index 8d1502577502e..3fd343a17e990 100644
--- a/test/framework/src/test/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApiParserFailingTests.java
+++ b/test/framework/src/test/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApiParserFailingTests.java
@@ -34,6 +34,7 @@ public void testDuplicateMethods() throws Exception {
        parseAndExpectFailure("{\n" +
                "  \"ping\": {" +
                "    \"documentation\": \"http://www.elasticsearch.org/guide/\"," +
+               "    \"stability\": \"stable\",\n" +
                "    \"methods\": [\"PUT\", \"PUT\"]," +
                "    \"url\": {" +
                "      \"path\": \"/\"," +
@@ -54,6 +55,7 @@ public void testDuplicatePaths() throws Exception {
         parseAndExpectFailure("{\n" +
                 "  \"ping\": {" +
                 "    \"documentation\": \"http://www.elasticsearch.org/guide/\"," +
+                "    \"stability\": \"stable\",\n" +
                 "    \"methods\": [\"PUT\"]," +
                 "    \"url\": {" +
                 "      \"path\": \"/pingone\"," +
@@ -94,6 +96,7 @@ private void parseAndExpectFailure(String brokenJson, String location, String ex
     private static final String BROKEN_SPEC_PARAMS = "{\n" +
             "  \"ping\": {" +
             "    \"documentation\": \"http://www.elasticsearch.org/guide/\"," +
+            "    \"stability\": \"stable\",\n" +
             "    \"methods\": [\"HEAD\"]," +
             "    \"url\": {" +
             "      \"path\": \"/\"," +
@@ -113,6 +116,7 @@ private void parseAndExpectFailure(String brokenJson, String location, String ex
     private static final String BROKEN_SPEC_PARTS = "{\n" +
             "  \"ping\": {" +
             "    \"documentation\": \"http://www.elasticsearch.org/guide/\"," +
+            "    \"stability\": \"stable\",\n" +
             "    \"methods\": [\"HEAD\"]," +
             "    \"url\": {" +
             "      \"path\": \"/\"," +
diff --git a/test/framework/src/test/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApiParserTests.java b/test/framework/src/test/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApiParserTests.java
index 9ba393966a363..f2211f8feacfe 100644
--- a/test/framework/src/test/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApiParserTests.java
+++ b/test/framework/src/test/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApiParserTests.java
@@ -95,6 +95,7 @@ public void testRequiredBodyWithoutUrlParts() throws Exception {
         String spec = "{\n" +
             "  \"count\": {\n" +
             "    \"documentation\": \"whatever\",\n" +
+            "    \"stability\": \"stable\",\n" +
             "    \"methods\": [ \"GET\", \"POST\" ],\n" +
             "    \"url\": {\n" +
             "      \"path\": \"/whatever\",\n" +
@@ -119,6 +120,7 @@ public void testRequiredBodyWithoutUrlParts() throws Exception {
     private static final String REST_SPEC_COUNT_API = "{\n" +
             "  \"count\": {\n" +
             "    \"documentation\": \"http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/search-count.html\",\n" +
+            "    \"stability\": \"stable\",\n" +
             "    \"methods\": [\"POST\", \"GET\"],\n" +
             "    \"url\": {\n" +
             "      \"path\": \"/_count\",\n" +
@@ -149,6 +151,7 @@ public void testRequiredBodyWithoutUrlParts() throws Exception {
     private static final String REST_SPEC_GET_TEMPLATE_API = "{\n" +
             "  \"indices.get_template\": {\n" +
             "    \"documentation\": \"http://www.elasticsearch.org/guide/reference/api/admin-indices-templates/\",\n" +
+            "    \"stability\": \"stable\",\n" +
             "    \"methods\": [\"GET\"],\n" +
             "    \"url\": {\n" +
             "      \"path\": \"/_template/{name}\",\n" +
@@ -170,6 +173,7 @@ public void testRequiredBodyWithoutUrlParts() throws Exception {
     private static final String REST_SPEC_INDEX_API = "{\n" +
             "  \"index\": {\n" +
             "    \"documentation\": \"http://elasticsearch.org/guide/reference/api/index_/\",\n" +
+            "    \"stability\": \"stable\",\n" +
             "    \"methods\": [\"POST\", \"PUT\"],\n" +
             "    \"url\": {\n" +
             "      \"path\": \"/{index}/{type}\",\n" +

From 130a75a0df62e2707a07b39e159eb01839cc8e60 Mon Sep 17 00:00:00 2001
From: Mpdreamz <Mpdreamz@gmail.com>
Date: Wed, 24 Apr 2019 08:59:13 +0200
Subject: [PATCH 11/15] found one more test spec file not declaring stability,
 made sure stability appears after documentation everywhere

---
 .../src/test/resources/rest-api-spec/api/cat.example.json       | 1 +
 .../src/test/resources/rest-api-spec/api/ml.close_job.json      | 2 +-
 .../test/resources/rest-api-spec/api/ml.delete_datafeed.json    | 2 +-
 .../src/test/resources/rest-api-spec/api/ml.open_job.json       | 2 +-
 4 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/plugins/examples/rest-handler/src/test/resources/rest-api-spec/api/cat.example.json b/plugins/examples/rest-handler/src/test/resources/rest-api-spec/api/cat.example.json
index e42617eef7bf7..113c5d563caa4 100644
--- a/plugins/examples/rest-handler/src/test/resources/rest-api-spec/api/cat.example.json
+++ b/plugins/examples/rest-handler/src/test/resources/rest-api-spec/api/cat.example.json
@@ -1,6 +1,7 @@
 {
   "cat.example": {
     "documentation": "",
+    "stability" : "stable",
     "methods": ["GET"],
     "url": {
       "path": "/_cat/example",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.close_job.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.close_job.json
index 62a5e5a21d4c7..2e7e54b113109 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.close_job.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.close_job.json
@@ -1,7 +1,7 @@
 {
   "ml.close_job": {
-    "stability": "stable",
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-close-job.html",
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/_ml/anomaly_detectors/{job_id}/_close",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_datafeed.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_datafeed.json
index b13672aa25629..dea009a8604b2 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_datafeed.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.delete_datafeed.json
@@ -1,7 +1,7 @@
 {
   "ml.delete_datafeed": {
-    "stability": "stable",
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-delete-datafeed.html",
+    "stability": "stable",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_ml/datafeeds/{datafeed_id}",
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.open_job.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.open_job.json
index 9c95f08993f14..b90def9bfb651 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.open_job.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/ml.open_job.json
@@ -1,7 +1,7 @@
 {
   "ml.open_job": {
-    "stability": "stable",
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/current/ml-open-job.html",
+    "stability": "stable",
     "methods": [ "POST" ],
     "url": {
       "path": "/_ml/anomaly_detectors/{job_id}/_open",

From 1aaa327f95fbda0a914d8624bb3aa0b9b9dba0b6 Mon Sep 17 00:00:00 2001
From: Mpdreamz <Mpdreamz@gmail.com>
Date: Tue, 11 Jun 2019 12:19:20 +0200
Subject: [PATCH 12/15] cluster.state is stable, mark response in some way to
 denote its a key value format that can be changed during minors

---
 .../main/resources/rest-api-spec/api/cluster.state.json    | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.state.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.state.json
index d163a2d971263..cd7f40cd86017 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.state.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.state.json
@@ -1,7 +1,7 @@
 {
   "cluster.state": {
     "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-state.html",
-    "stability" : "internal",
+    "stability" : "stable",
     "methods": ["GET"],
     "url": {
       "paths": [
@@ -57,6 +57,9 @@
         }
       }
     },
-    "body": null
+    "body": null,
+    "response": {
+      "treat_json_as_key_value" : true
+    }
   }
 }

From 73dea92a5e617a45080c91ba247df24b072ca980 Mon Sep 17 00:00:00 2001
From: Mpdreamz <Mpdreamz@gmail.com>
Date: Tue, 11 Jun 2019 12:26:04 +0200
Subject: [PATCH 13/15] mark data frame API's as beta

---
 .../api/data_frame.delete_data_frame_transform.json             | 2 +-
 .../rest-api-spec/api/data_frame.get_data_frame_transform.json  | 2 +-
 .../api/data_frame.get_data_frame_transform_stats.json          | 2 +-
 .../api/data_frame.preview_data_frame_transform.json            | 2 +-
 .../rest-api-spec/api/data_frame.put_data_frame_transform.json  | 2 +-
 .../api/data_frame.start_data_frame_transform.json              | 2 +-
 .../rest-api-spec/api/data_frame.stop_data_frame_transform.json | 2 +-
 7 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.delete_data_frame_transform.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.delete_data_frame_transform.json
index c872a3a63e596..30da72491df11 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.delete_data_frame_transform.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.delete_data_frame_transform.json
@@ -1,7 +1,7 @@
 {
   "data_frame.delete_data_frame_transform": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/delete-data-frame-transform.html",
-    "stability": "private",
+    "stability": "beta",
     "methods": [ "DELETE" ],
     "url": {
       "paths": [
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.get_data_frame_transform.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.get_data_frame_transform.json
index 301347656886a..10769a780da55 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.get_data_frame_transform.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.get_data_frame_transform.json
@@ -1,7 +1,7 @@
 {
   "data_frame.get_data_frame_transform": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/get-data-frame-transform.html",
-    "stability": "private",
+    "stability": "beta",
     "methods": [ "GET" ],
     "url": {
       "paths": [ "/_data_frame/transforms/{transform_id}", "/_data_frame/transforms"],
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.get_data_frame_transform_stats.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.get_data_frame_transform_stats.json
index a941f114b0591..cfbe22d703b7f 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.get_data_frame_transform_stats.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.get_data_frame_transform_stats.json
@@ -1,7 +1,7 @@
 {
   "data_frame.get_data_frame_transform_stats": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/get-data-frame-transform-stats.html",
-    "stability": "private",
+    "stability": "beta",
     "methods": [ "GET" ],
     "url": {
       "paths": [ "/_data_frame/transforms/{transform_id}/_stats" ],
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.preview_data_frame_transform.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.preview_data_frame_transform.json
index d13dcc9f5a397..bbfcf61640c43 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.preview_data_frame_transform.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.preview_data_frame_transform.json
@@ -1,7 +1,7 @@
 {
   "data_frame.preview_data_frame_transform": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/preview-data-frame-transform.html",
-    "stability": "private",
+    "stability": "beta",
     "methods": [ "POST" ],
     "url": {
       "paths": [ "/_data_frame/transforms/_preview" ]
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.put_data_frame_transform.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.put_data_frame_transform.json
index 18671d0a285df..919682676da3c 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.put_data_frame_transform.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.put_data_frame_transform.json
@@ -1,7 +1,7 @@
 {
   "data_frame.put_data_frame_transform": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/put-data-frame-transform.html",
-    "stability": "private",
+    "stability": "beta",
     "methods": [ "PUT" ],
     "url": {
       "paths": [ "/_data_frame/transforms/{transform_id}" ],
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.start_data_frame_transform.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.start_data_frame_transform.json
index e12a6ad736412..0a1368514f1f8 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.start_data_frame_transform.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.start_data_frame_transform.json
@@ -1,7 +1,7 @@
 {
   "data_frame.start_data_frame_transform": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/start-data-frame-transform.html",
-    "stability": "private",
+    "stability": "beta",
     "methods": [ "POST" ],
     "url": {
       "paths": [ "/_data_frame/transforms/{transform_id}/_start" ],
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.stop_data_frame_transform.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.stop_data_frame_transform.json
index d0e4ffcfc28d3..7c102bdb5a56a 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.stop_data_frame_transform.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/data_frame.stop_data_frame_transform.json
@@ -1,7 +1,7 @@
 {
   "data_frame.stop_data_frame_transform": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/current/stop-data-frame-transform.html",
-    "stability": "private",
+    "stability": "beta",
     "methods": [ "POST" ],
     "url": {
       "paths": [ "/_data_frame/transforms/{transform_id}/_stop" ],

From 0c0f6bad0c90d109c32730462bd887a6496955c2 Mon Sep 17 00:00:00 2001
From: Mpdreamz <Mpdreamz@gmail.com>
Date: Tue, 11 Jun 2019 12:34:01 +0200
Subject: [PATCH 14/15] remove internal and private as states for an API

---
 rest-api-spec/README.markdown                 | 19 +++++++++++++++----
 .../api/scripts_painless_context.json         |  2 +-
 .../yaml/restspec/ClientYamlSuiteRestApi.java |  2 +-
 .../rest-api-spec/api/monitoring.bulk.json    |  2 +-
 4 files changed, 18 insertions(+), 7 deletions(-)

diff --git a/rest-api-spec/README.markdown b/rest-api-spec/README.markdown
index c7ea59a8823f5..241433d8c5cc4 100644
--- a/rest-api-spec/README.markdown
+++ b/rest-api-spec/README.markdown
@@ -40,17 +40,28 @@ The specification contains:
 * The _name_ of the API (`indices.create`), which usually corresponds to the client calls
 * Link to the documentation at <http://elastic.co>
 * `stability` indicating the state of the API, has to be declared explicitly or YAML tests will fail
-    * `private` this API should not be be implemented by clients
     * `experimental` highly likely to break in the near future (minor/path), no bwc guarantees. 
     Possibly removed in the future.
     * `beta` less likely to break or be removed but still reserve the right to do so
-    * `internal` API that is stable with regards to its lifetime (here to stay) but makes no guarantees towards its
-     output format. Typically used by monitoring API's exposing internal representations.
-    * `stable` No backwards breaking changes in a minor (default if not specified)
+    * `stable` No backwards breaking changes in a minor 
 * List of HTTP methods for the endpoint
 * URL specification: path, parts, parameters
 * Whether body is allowed for the endpoint or not and its description
 
+**NOTE** 
+If an API is stable but it response should be treated as an arbitrary map of key values please notate this as followed
+
+```json
+{
+  "api.name": {
+    "stability" : "stable",
+    "response": {
+      "treat_json_as_key_value" : true
+    }
+  }
+}
+```
+
 
 The `methods` and `url.paths` elements list all possible HTTP methods and URLs for the endpoint;
 it is the responsibility of the developer to use this information for a sensible API on the target platform.
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/scripts_painless_context.json b/rest-api-spec/src/main/resources/rest-api-spec/api/scripts_painless_context.json
index 7d0799b979e91..cb078ec4a00b8 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/scripts_painless_context.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/scripts_painless_context.json
@@ -1,6 +1,6 @@
 {
   "scripts_painless_context": {
-    "stability": "private",
+    "stability": "experimental",
     "methods": ["GET"],
     "url": {
       "paths": ["/_scripts/painless/_context"],
diff --git a/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApi.java b/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApi.java
index a32e6b3ca03d5..5a6b5c87a7d43 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApi.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApi.java
@@ -44,7 +44,7 @@ public class ClientYamlSuiteRestApi {
 
     public enum Stability
     {
-        UNKNOWN, PRIVATE, EXPERIMENTAL, BETA, INTERNAL, STABLE
+        UNKNOWN, BETA, INTERNAL, STABLE
     }
 
     public enum Body {
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/monitoring.bulk.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/monitoring.bulk.json
index 58c7d19b294c6..f84cf6e7bb4f9 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/monitoring.bulk.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/monitoring.bulk.json
@@ -1,7 +1,7 @@
 {
   "monitoring.bulk": {
     "documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/es-monitoring.html",
-    "stability" : "private",
+    "stability" : "experimental",
     "methods": ["POST", "PUT"],
     "url": {
       "paths": ["/_monitoring/bulk"],

From 2437628db4c6da8dc3f0c487f87d3d9bc5893622 Mon Sep 17 00:00:00 2001
From: Mpdreamz <Mpdreamz@gmail.com>
Date: Tue, 11 Jun 2019 12:55:59 +0200
Subject: [PATCH 15/15] removed the wrong enum values in the Stability Enum in
 the previous commit

---
 .../test/rest/yaml/restspec/ClientYamlSuiteRestApi.java         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApi.java b/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApi.java
index 5a6b5c87a7d43..421da469f3b3a 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApi.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/restspec/ClientYamlSuiteRestApi.java
@@ -44,7 +44,7 @@ public class ClientYamlSuiteRestApi {
 
     public enum Stability
     {
-        UNKNOWN, BETA, INTERNAL, STABLE
+        UNKNOWN, EXPERIMENTAL, BETA, STABLE
     }
 
     public enum Body {