diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.close_job.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.close_job.json
index 8a20b294948..93385db95a7 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.close_job.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.close_job.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.close_job": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-close-job.html",
     "methods": [ "POST" ],
     "url": {
       "path": "/_xpack/ml/anomaly_detectors/{job_id}/_close",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.delete_datafeed.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.delete_datafeed.json
index dcb32a6cce4..6c634720df9 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.delete_datafeed.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.delete_datafeed.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.delete_datafeed": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-delete-datafeed.html",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_xpack/ml/datafeeds/{datafeed_id}",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.delete_job.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.delete_job.json
index b94cda77216..924af13224c 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.delete_job.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.delete_job.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.delete_job": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-delete-job.html",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_xpack/ml/anomaly_detectors/{job_id}",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.delete_model_snapshot.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.delete_model_snapshot.json
index c120b2ce0ba..6d0693db6a5 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.delete_model_snapshot.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.delete_model_snapshot.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.delete_model_snapshot": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-delete-snapshot.html",
     "methods": [ "DELETE" ],
     "url": {
       "path": "/_xpack/ml/anomaly_detectors/{job_id}/model_snapshots/{snapshot_id}",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.flush_job.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.flush_job.json
index a928ad4e731..92561ec5511 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.flush_job.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.flush_job.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.flush_job": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-flush-job.html",
     "methods": [
       "POST"
     ],
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_buckets.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_buckets.json
index 81fc7324255..f67edeb517f 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_buckets.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_buckets.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.get_buckets": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-get-bucket.html",
     "methods": [ "GET", "POST" ],
     "url": {
       "path": "/_xpack/ml/anomaly_detectors/{job_id}/results/buckets/{timestamp}",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_categories.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_categories.json
index 2a6a5e84b41..b5337e4d4e5 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_categories.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_categories.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.get_categories": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-get-category.html",
     "methods": [ "GET", "POST" ],
     "url": {
       "path": "/_xpack/ml/anomaly_detectors/{job_id}/results/categories/{category_id}",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_datafeed_stats.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_datafeed_stats.json
index 2bb23b7eabe..c399966bff2 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_datafeed_stats.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_datafeed_stats.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.get_datafeed_stats": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-get-datafeed-stats.html",
     "methods": [ "GET"],
     "url": {
       "path": "/_xpack/ml/datafeeds/{datafeed_id}/_stats",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_datafeeds.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_datafeeds.json
index 6773f984385..cf2073c582c 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_datafeeds.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_datafeeds.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.get_datafeeds": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-get-datafeed.html",
     "methods": [ "GET"],
     "url": {
       "path": "/_xpack/ml/datafeeds/{datafeed_id}",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_influencers.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_influencers.json
index a1798eca664..756015b68ec 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_influencers.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_influencers.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.get_influencers": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-get-influencer.html",
     "methods": [ "GET", "POST" ],
     "url": {
       "path": "/_xpack/ml/anomaly_detectors/{job_id}/results/influencers",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_job_stats.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_job_stats.json
index 85f599dd52d..b5d7a545454 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_job_stats.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_job_stats.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.get_job_stats": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-get-job-stats.html",
     "methods": [ "GET"],
     "url": {
       "path": "/_xpack/ml/anomaly_detectors/{job_id}/_stats",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_jobs.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_jobs.json
index 9f0489f6760..28e268578fd 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_jobs.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_jobs.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.get_jobs": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-get-job.html",
     "methods": [ "GET"],
     "url": {
       "path": "/_xpack/ml/anomaly_detectors/{job_id}",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_model_snapshots.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_model_snapshots.json
index 61c647d2f0c..a22420c942b 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_model_snapshots.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_model_snapshots.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.get_model_snapshots": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-get-snapshot.html",
     "methods": [ "GET", "POST" ],
     "url": {
       "path": "/_xpack/ml/anomaly_detectors/{job_id}/model_snapshots/{snapshot_id}",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_records.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_records.json
index 4685d522583..4c2ba767f70 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_records.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.get_records.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.get_records": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-get-record.html",
     "methods": ["GET", "POST"],
     "url": {
       "path": "/_xpack/ml/anomaly_detectors/{job_id}/results/records",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.open_job.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.open_job.json
index 0b25d51da80..01fa614982f 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.open_job.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.open_job.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.open_job": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-open-job.html",
     "methods": [ "POST" ],
     "url": {
       "path": "/_xpack/ml/anomaly_detectors/{job_id}/_open",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.post_data.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.post_data.json
index 938e134e6d3..54e39a7c88d 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.post_data.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.post_data.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.post_data": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-post-data.html",
     "methods": [ "POST" ],
     "url": {
       "path": "/_xpack/ml/anomaly_detectors/{job_id}/_data",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.preview_datafeed.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.preview_datafeed.json
index 96b37267532..b7d19c01b41 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.preview_datafeed.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.preview_datafeed.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.preview_datafeed": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-preview-datafeed.html",
     "methods": [ "GET" ],
     "url": {
       "path": "/_xpack/ml/datafeeds/{datafeed_id}/_preview",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.put_datafeed.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.put_datafeed.json
index 3f0d8610944..321ece66949 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.put_datafeed.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.put_datafeed.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.put_datafeed": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-put-datafeed.html",
     "methods": [ "PUT" ],
     "url": {
       "path": "/_xpack/ml/datafeeds/{datafeed_id}",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.put_job.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.put_job.json
index 16a58391046..63887a9731f 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.put_job.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.put_job.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.put_job": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-put-job.html",
     "methods": [ "PUT" ],
     "url": {
       "path": "/_xpack/ml/anomaly_detectors/{job_id}",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.revert_model_snapshot.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.revert_model_snapshot.json
index 11003ecea7f..937f25fc685 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.revert_model_snapshot.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.revert_model_snapshot.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.revert_model_snapshot": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-revert-snapshot.html",
     "methods": [ "POST" ],
     "url": {
       "path": "/_xpack/ml/anomaly_detectors/{job_id}/model_snapshots/{snapshot_id}/_revert",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.start_datafeed.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.start_datafeed.json
index e6d055fcc76..b52df9e0fc8 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.start_datafeed.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.start_datafeed.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.start_datafeed": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-start-datafeed.html",
     "methods": [ "POST" ],
     "url": {
       "path": "/_xpack/ml/datafeeds/{datafeed_id}/_start",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.stop_datafeed.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.stop_datafeed.json
index a6f53f6ace1..8f1267276c7 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.stop_datafeed.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.stop_datafeed.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.stop_datafeed": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-stop-datafeed.html",
     "methods": [
       "POST"
     ],
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.update_datafeed.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.update_datafeed.json
index 3bf0b4692f3..7ea0d9fbda5 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.update_datafeed.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.update_datafeed.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.update_datafeed": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-update-datafeed.html",
     "methods": [ "POST" ],
     "url": {
       "path": "/_xpack/ml/datafeeds/{datafeed_id}/_update",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.update_job.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.update_job.json
index d5da57b305b..e5f856f725d 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.update_job.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.update_job.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.update_job": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-update-job.html",
     "methods": [ "POST" ],
     "url": {
       "path": "/_xpack/ml/anomaly_detectors/{job_id}/_update",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.update_model_snapshot.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.update_model_snapshot.json
index 1aa10595b72..3be9e156b32 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.update_model_snapshot.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.update_model_snapshot.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.update_model_snapshot": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-update-snapshot.html",
     "methods": [ "POST" ],
     "url": {
       "path": "/_xpack/ml/anomaly_detectors/{job_id}/model_snapshots/{snapshot_id}/_update",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.validate.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.validate.json
index 823efe53810..38543605374 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.validate.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.validate.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.validate": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-valid-job.html",
     "methods": [ "POST" ],
     "url": {
       "path": "/_xpack/ml/anomaly_detectors/_validate",
diff --git a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.validate_detector.json b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.validate_detector.json
index c6e00213db4..96816784d53 100644
--- a/plugin/src/test/resources/rest-api-spec/api/xpack.ml.validate_detector.json
+++ b/plugin/src/test/resources/rest-api-spec/api/xpack.ml.validate_detector.json
@@ -1,5 +1,6 @@
 {
   "xpack.ml.validate_detector": {
+    "documentation": "http://www.elastic.co/guide/en/x-pack/current/ml-valid-detector.html",
     "methods": [ "POST" ],
     "url": {
       "path": "/_xpack/ml/anomaly_detectors/_validate/detector",