diff --git a/docs/build.gradle b/docs/build.gradle
index 25caddbb6d9..c80c16952e7 100644
--- a/docs/build.gradle
+++ b/docs/build.gradle
@@ -23,18 +23,18 @@ apply plugin: 'elasticsearch.docs-test'
 
 /* List of files that have snippets that will not work until platinum tests can occur ... */
 buildRestTests.expectedUnconvertedCandidates = [
-        'reference/ml/transforms.asciidoc',
-        'reference/ml/apis/delete-calendar-event.asciidoc',
-        'reference/ml/apis/get-bucket.asciidoc',
-        'reference/ml/apis/get-category.asciidoc',
-        'reference/ml/apis/get-influencer.asciidoc',
-        'reference/ml/apis/get-job-stats.asciidoc',
-        'reference/ml/apis/get-overall-buckets.asciidoc',
-        'reference/ml/apis/get-record.asciidoc',
-        'reference/ml/apis/get-snapshot.asciidoc',
-        'reference/ml/apis/post-data.asciidoc',
-        'reference/ml/apis/revert-snapshot.asciidoc',
-        'reference/ml/apis/update-snapshot.asciidoc',
+        'reference/ml/anomaly-detection/transforms.asciidoc',
+        'reference/ml/anomaly-detection/apis/delete-calendar-event.asciidoc',
+        'reference/ml/anomaly-detection/apis/get-bucket.asciidoc',
+        'reference/ml/anomaly-detection/apis/get-category.asciidoc',
+        'reference/ml/anomaly-detection/apis/get-influencer.asciidoc',
+        'reference/ml/anomaly-detection/apis/get-job-stats.asciidoc',
+        'reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc',
+        'reference/ml/anomaly-detection/apis/get-record.asciidoc',
+        'reference/ml/anomaly-detection/apis/get-snapshot.asciidoc',
+        'reference/ml/anomaly-detection/apis/post-data.asciidoc',
+        'reference/ml/anomaly-detection/apis/revert-snapshot.asciidoc',
+        'reference/ml/anomaly-detection/apis/update-snapshot.asciidoc',
 ]
 
 testClusters.integTest {
diff --git a/docs/reference/ml/aggregations.asciidoc b/docs/reference/ml/anomaly-detection/aggregations.asciidoc
similarity index 100%
rename from docs/reference/ml/aggregations.asciidoc
rename to docs/reference/ml/anomaly-detection/aggregations.asciidoc
diff --git a/docs/reference/ml/apis/close-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/close-job.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/close-job.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/close-job.asciidoc
diff --git a/docs/reference/ml/apis/datafeedresource.asciidoc b/docs/reference/ml/anomaly-detection/apis/datafeedresource.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/datafeedresource.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/datafeedresource.asciidoc
diff --git a/docs/reference/ml/apis/delete-calendar-event.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-calendar-event.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/delete-calendar-event.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/delete-calendar-event.asciidoc
diff --git a/docs/reference/ml/apis/delete-calendar-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-calendar-job.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/delete-calendar-job.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/delete-calendar-job.asciidoc
diff --git a/docs/reference/ml/apis/delete-calendar.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-calendar.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/delete-calendar.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/delete-calendar.asciidoc
diff --git a/docs/reference/ml/apis/delete-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-datafeed.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/delete-datafeed.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/delete-datafeed.asciidoc
diff --git a/docs/reference/ml/apis/delete-expired-data.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-expired-data.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/delete-expired-data.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/delete-expired-data.asciidoc
diff --git a/docs/reference/ml/apis/delete-filter.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-filter.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/delete-filter.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/delete-filter.asciidoc
diff --git a/docs/reference/ml/apis/delete-forecast.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-forecast.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/delete-forecast.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/delete-forecast.asciidoc
diff --git a/docs/reference/ml/apis/delete-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-job.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/delete-job.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/delete-job.asciidoc
diff --git a/docs/reference/ml/apis/delete-snapshot.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-snapshot.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/delete-snapshot.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/delete-snapshot.asciidoc
diff --git a/docs/reference/ml/apis/eventresource.asciidoc b/docs/reference/ml/anomaly-detection/apis/eventresource.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/eventresource.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/eventresource.asciidoc
diff --git a/docs/reference/ml/apis/filterresource.asciidoc b/docs/reference/ml/anomaly-detection/apis/filterresource.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/filterresource.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/filterresource.asciidoc
diff --git a/docs/reference/ml/apis/find-file-structure.asciidoc b/docs/reference/ml/anomaly-detection/apis/find-file-structure.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/find-file-structure.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/find-file-structure.asciidoc
diff --git a/docs/reference/ml/apis/flush-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/flush-job.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/flush-job.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/flush-job.asciidoc
diff --git a/docs/reference/ml/apis/forecast.asciidoc b/docs/reference/ml/anomaly-detection/apis/forecast.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/forecast.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/forecast.asciidoc
diff --git a/docs/reference/ml/apis/get-bucket.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-bucket.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/get-bucket.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/get-bucket.asciidoc
diff --git a/docs/reference/ml/apis/get-calendar-event.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-calendar-event.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/get-calendar-event.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/get-calendar-event.asciidoc
diff --git a/docs/reference/ml/apis/get-calendar.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-calendar.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/get-calendar.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/get-calendar.asciidoc
diff --git a/docs/reference/ml/apis/get-category.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-category.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/get-category.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/get-category.asciidoc
diff --git a/docs/reference/ml/apis/get-datafeed-stats.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-datafeed-stats.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/get-datafeed-stats.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/get-datafeed-stats.asciidoc
diff --git a/docs/reference/ml/apis/get-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-datafeed.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/get-datafeed.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/get-datafeed.asciidoc
diff --git a/docs/reference/ml/apis/get-filter.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-filter.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/get-filter.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/get-filter.asciidoc
diff --git a/docs/reference/ml/apis/get-influencer.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-influencer.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/get-influencer.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/get-influencer.asciidoc
diff --git a/docs/reference/ml/apis/get-job-stats.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/get-job-stats.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
diff --git a/docs/reference/ml/apis/get-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-job.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/get-job.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/get-job.asciidoc
diff --git a/docs/reference/ml/apis/get-ml-info.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-ml-info.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/get-ml-info.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/get-ml-info.asciidoc
diff --git a/docs/reference/ml/apis/get-overall-buckets.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/get-overall-buckets.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc
diff --git a/docs/reference/ml/apis/get-record.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-record.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/get-record.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/get-record.asciidoc
diff --git a/docs/reference/ml/apis/get-snapshot.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-snapshot.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/get-snapshot.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/get-snapshot.asciidoc
diff --git a/docs/reference/ml/apis/jobcounts.asciidoc b/docs/reference/ml/anomaly-detection/apis/jobcounts.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/jobcounts.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/jobcounts.asciidoc
diff --git a/docs/reference/ml/apis/jobresource.asciidoc b/docs/reference/ml/anomaly-detection/apis/jobresource.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/jobresource.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/jobresource.asciidoc
diff --git a/docs/reference/ml/apis/ml-api.asciidoc b/docs/reference/ml/anomaly-detection/apis/ml-api.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/ml-api.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/ml-api.asciidoc
diff --git a/docs/reference/ml/apis/open-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/open-job.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/open-job.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/open-job.asciidoc
diff --git a/docs/reference/ml/apis/post-calendar-event.asciidoc b/docs/reference/ml/anomaly-detection/apis/post-calendar-event.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/post-calendar-event.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/post-calendar-event.asciidoc
diff --git a/docs/reference/ml/apis/post-data.asciidoc b/docs/reference/ml/anomaly-detection/apis/post-data.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/post-data.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/post-data.asciidoc
diff --git a/docs/reference/ml/apis/preview-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/preview-datafeed.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/preview-datafeed.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/preview-datafeed.asciidoc
diff --git a/docs/reference/ml/apis/put-calendar-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-calendar-job.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/put-calendar-job.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/put-calendar-job.asciidoc
diff --git a/docs/reference/ml/apis/put-calendar.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-calendar.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/put-calendar.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/put-calendar.asciidoc
diff --git a/docs/reference/ml/apis/put-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/put-datafeed.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc
diff --git a/docs/reference/ml/apis/put-filter.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-filter.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/put-filter.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/put-filter.asciidoc
diff --git a/docs/reference/ml/apis/put-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/put-job.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/put-job.asciidoc
diff --git a/docs/reference/ml/apis/resultsresource.asciidoc b/docs/reference/ml/anomaly-detection/apis/resultsresource.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/resultsresource.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/resultsresource.asciidoc
diff --git a/docs/reference/ml/apis/revert-snapshot.asciidoc b/docs/reference/ml/anomaly-detection/apis/revert-snapshot.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/revert-snapshot.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/revert-snapshot.asciidoc
diff --git a/docs/reference/ml/apis/set-upgrade-mode.asciidoc b/docs/reference/ml/anomaly-detection/apis/set-upgrade-mode.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/set-upgrade-mode.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/set-upgrade-mode.asciidoc
diff --git a/docs/reference/ml/apis/snapshotresource.asciidoc b/docs/reference/ml/anomaly-detection/apis/snapshotresource.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/snapshotresource.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/snapshotresource.asciidoc
diff --git a/docs/reference/ml/apis/start-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/start-datafeed.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/start-datafeed.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/start-datafeed.asciidoc
diff --git a/docs/reference/ml/apis/stop-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/stop-datafeed.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/stop-datafeed.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/stop-datafeed.asciidoc
diff --git a/docs/reference/ml/apis/update-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/update-datafeed.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/update-datafeed.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/update-datafeed.asciidoc
diff --git a/docs/reference/ml/apis/update-filter.asciidoc b/docs/reference/ml/anomaly-detection/apis/update-filter.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/update-filter.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/update-filter.asciidoc
diff --git a/docs/reference/ml/apis/update-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/update-job.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/update-job.asciidoc
diff --git a/docs/reference/ml/apis/update-snapshot.asciidoc b/docs/reference/ml/anomaly-detection/apis/update-snapshot.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/update-snapshot.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/update-snapshot.asciidoc
diff --git a/docs/reference/ml/apis/validate-detector.asciidoc b/docs/reference/ml/anomaly-detection/apis/validate-detector.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/validate-detector.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/validate-detector.asciidoc
diff --git a/docs/reference/ml/apis/validate-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/validate-job.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/validate-job.asciidoc
rename to docs/reference/ml/anomaly-detection/apis/validate-job.asciidoc
diff --git a/docs/reference/ml/categories.asciidoc b/docs/reference/ml/anomaly-detection/categories.asciidoc
similarity index 100%
rename from docs/reference/ml/categories.asciidoc
rename to docs/reference/ml/anomaly-detection/categories.asciidoc
diff --git a/docs/reference/ml/configuring.asciidoc b/docs/reference/ml/anomaly-detection/configuring.asciidoc
similarity index 100%
rename from docs/reference/ml/configuring.asciidoc
rename to docs/reference/ml/anomaly-detection/configuring.asciidoc
diff --git a/docs/reference/ml/customurl.asciidoc b/docs/reference/ml/anomaly-detection/customurl.asciidoc
similarity index 100%
rename from docs/reference/ml/customurl.asciidoc
rename to docs/reference/ml/anomaly-detection/customurl.asciidoc
diff --git a/docs/reference/ml/delayed-data-detection.asciidoc b/docs/reference/ml/anomaly-detection/delayed-data-detection.asciidoc
similarity index 100%
rename from docs/reference/ml/delayed-data-detection.asciidoc
rename to docs/reference/ml/anomaly-detection/delayed-data-detection.asciidoc
diff --git a/docs/reference/ml/detector-custom-rules.asciidoc b/docs/reference/ml/anomaly-detection/detector-custom-rules.asciidoc
similarity index 100%
rename from docs/reference/ml/detector-custom-rules.asciidoc
rename to docs/reference/ml/anomaly-detection/detector-custom-rules.asciidoc
diff --git a/docs/reference/ml/functions.asciidoc b/docs/reference/ml/anomaly-detection/functions.asciidoc
similarity index 100%
rename from docs/reference/ml/functions.asciidoc
rename to docs/reference/ml/anomaly-detection/functions.asciidoc
diff --git a/docs/reference/ml/functions/count.asciidoc b/docs/reference/ml/anomaly-detection/functions/count.asciidoc
similarity index 100%
rename from docs/reference/ml/functions/count.asciidoc
rename to docs/reference/ml/anomaly-detection/functions/count.asciidoc
diff --git a/docs/reference/ml/functions/geo.asciidoc b/docs/reference/ml/anomaly-detection/functions/geo.asciidoc
similarity index 100%
rename from docs/reference/ml/functions/geo.asciidoc
rename to docs/reference/ml/anomaly-detection/functions/geo.asciidoc
diff --git a/docs/reference/ml/functions/info.asciidoc b/docs/reference/ml/anomaly-detection/functions/info.asciidoc
similarity index 100%
rename from docs/reference/ml/functions/info.asciidoc
rename to docs/reference/ml/anomaly-detection/functions/info.asciidoc
diff --git a/docs/reference/ml/functions/metric.asciidoc b/docs/reference/ml/anomaly-detection/functions/metric.asciidoc
similarity index 100%
rename from docs/reference/ml/functions/metric.asciidoc
rename to docs/reference/ml/anomaly-detection/functions/metric.asciidoc
diff --git a/docs/reference/ml/functions/rare.asciidoc b/docs/reference/ml/anomaly-detection/functions/rare.asciidoc
similarity index 100%
rename from docs/reference/ml/functions/rare.asciidoc
rename to docs/reference/ml/anomaly-detection/functions/rare.asciidoc
diff --git a/docs/reference/ml/functions/sum.asciidoc b/docs/reference/ml/anomaly-detection/functions/sum.asciidoc
similarity index 100%
rename from docs/reference/ml/functions/sum.asciidoc
rename to docs/reference/ml/anomaly-detection/functions/sum.asciidoc
diff --git a/docs/reference/ml/functions/time.asciidoc b/docs/reference/ml/anomaly-detection/functions/time.asciidoc
similarity index 100%
rename from docs/reference/ml/functions/time.asciidoc
rename to docs/reference/ml/anomaly-detection/functions/time.asciidoc
diff --git a/docs/reference/ml/populations.asciidoc b/docs/reference/ml/anomaly-detection/populations.asciidoc
similarity index 100%
rename from docs/reference/ml/populations.asciidoc
rename to docs/reference/ml/anomaly-detection/populations.asciidoc
diff --git a/docs/reference/ml/stopping-ml.asciidoc b/docs/reference/ml/anomaly-detection/stopping-ml.asciidoc
similarity index 100%
rename from docs/reference/ml/stopping-ml.asciidoc
rename to docs/reference/ml/anomaly-detection/stopping-ml.asciidoc
diff --git a/docs/reference/ml/transforms.asciidoc b/docs/reference/ml/anomaly-detection/transforms.asciidoc
similarity index 100%
rename from docs/reference/ml/transforms.asciidoc
rename to docs/reference/ml/anomaly-detection/transforms.asciidoc
diff --git a/docs/reference/ml/apis/evaluateresources.asciidoc b/docs/reference/ml/df-analytics/apis/evaluateresources.asciidoc
similarity index 100%
rename from docs/reference/ml/apis/evaluateresources.asciidoc
rename to docs/reference/ml/df-analytics/apis/evaluateresources.asciidoc
diff --git a/docs/reference/rest-api/defs.asciidoc b/docs/reference/rest-api/defs.asciidoc
index 34edfc389ef..efeb6c60923 100644
--- a/docs/reference/rest-api/defs.asciidoc
+++ b/docs/reference/rest-api/defs.asciidoc
@@ -10,18 +10,18 @@ These resource definitions are used in APIs related to {ml-features} and
 * <<ml-dfanalytics-resources,{dfanalytics-cap}>>
 * <<data-frame-transform-resource,{dataframe-transforms-cap}>>
 * <<ml-evaluate-dfanalytics-resources,Evaluate {dfanalytics}>>
-* <<ml-job-resource,Jobs>>
-* <<ml-jobstats,Job statistics>>
-* <<ml-snapshot-resource,Model snapshots>>
-* <<ml-results-resource,Results>>
+* <<ml-job-resource,{anomaly-jobs-cap}>>
+* <<ml-jobstats,{anomaly-jobs-cap} statistics>>
+* <<ml-snapshot-resource,{anomaly-detect-cap} model snapshots>>
+* <<ml-results-resource,{anomaly-detect-cap} results>>
 * <<role-mapping-resources,Role mappings>>
 
-include::{es-repo-dir}/ml/apis/datafeedresource.asciidoc[]
+include::{es-repo-dir}/ml/anomaly-detection/apis/datafeedresource.asciidoc[]
 include::{es-repo-dir}/ml/df-analytics/apis/dfanalyticsresources.asciidoc[]
 include::{es-repo-dir}/data-frames/apis/transformresource.asciidoc[]
-include::{es-repo-dir}/ml/apis/evaluateresources.asciidoc[]
-include::{es-repo-dir}/ml/apis/jobresource.asciidoc[]
-include::{es-repo-dir}/ml/apis/jobcounts.asciidoc[]
-include::{es-repo-dir}/ml/apis/snapshotresource.asciidoc[]
+include::{es-repo-dir}/ml/df-analytics/apis/evaluateresources.asciidoc[]
+include::{es-repo-dir}/ml/anomaly-detection/apis/jobresource.asciidoc[]
+include::{es-repo-dir}/ml/anomaly-detection/apis/jobcounts.asciidoc[]
+include::{es-repo-dir}/ml/anomaly-detection/apis/snapshotresource.asciidoc[]
 include::{xes-repo-dir}/rest-api/security/role-mapping-resources.asciidoc[]
-include::{es-repo-dir}/ml/apis/resultsresource.asciidoc[]
+include::{es-repo-dir}/ml/anomaly-detection/apis/resultsresource.asciidoc[]
diff --git a/docs/reference/rest-api/index.asciidoc b/docs/reference/rest-api/index.asciidoc
index 3646d848788..857627f32ee 100644
--- a/docs/reference/rest-api/index.asciidoc
+++ b/docs/reference/rest-api/index.asciidoc
@@ -48,7 +48,7 @@ include::{es-repo-dir}/ilm/apis/ilm-api.asciidoc[]
 include::{es-repo-dir}/ilm/apis/slm-api.asciidoc[]
 include::{es-repo-dir}/licensing/index.asciidoc[]
 include::{es-repo-dir}/migration/migration.asciidoc[]
-include::{es-repo-dir}/ml/apis/ml-api.asciidoc[]
+include::{es-repo-dir}/ml/anomaly-detection/apis/ml-api.asciidoc[]
 include::{es-repo-dir}/ml/df-analytics/apis/index.asciidoc[]
 include::{es-repo-dir}/rollup/rollup-api.asciidoc[]
 include::{xes-repo-dir}/rest-api/security.asciidoc[]