diff --git a/docs/reference/rest-api/defs.asciidoc b/docs/reference/rest-api/defs.asciidoc
index 0fb37b573a26e..fcda35df664e4 100644
--- a/docs/reference/rest-api/defs.asciidoc
+++ b/docs/reference/rest-api/defs.asciidoc
@@ -8,20 +8,20 @@ These resource definitions are used in APIs related to {ml-features} and
 * <<ml-datafeed-resource,{dfeeds-cap}>>
 * <<ml-datafeed-counts,{dfeed-cap} counts>>
 * <<ml-dfanalytics-resources,{dfanalytics-cap}>>
-* <<data-frame-transform-resource,{transforms-cap}>>
 * <<ml-evaluate-dfanalytics-resources,Evaluate {dfanalytics}>>
 * <<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>>
+* <<data-frame-transform-resource,{transforms-cap}>>
 
 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/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/anomaly-detection/apis/resultsresource.asciidoc[]
+include::{es-repo-dir}/transform/apis/transformresource.asciidoc[]
diff --git a/docs/reference/rest-api/index.asciidoc b/docs/reference/rest-api/index.asciidoc
index e6179ffed2294..4b2acc675d813 100644
--- a/docs/reference/rest-api/index.asciidoc
+++ b/docs/reference/rest-api/index.asciidoc
@@ -14,7 +14,6 @@ not be included yet.
 * <<cat, cat APIs>>
 * <<cluster, Cluster APIs>>
 * <<ccr-apis,{ccr-cap} APIs>>
-* <<data-frame-apis,{transform-cap} APIs>>
 * <<docs, Document APIs>>
 * <<graph-explore-api,Graph Explore API>>
 * <<indices, Index APIs>>
@@ -30,6 +29,7 @@ not be included yet.
 * <<search, Search APIs>>
 * <<security-api,Security APIs>>
 * <<snapshot-lifecycle-management-api,Snapshot lifecycle management APIs>>
+* <<data-frame-apis,{transform-cap} APIs>>
 * <<watcher-api,Watcher APIs>>
 --
 
@@ -37,7 +37,6 @@ include::{es-repo-dir}/api-conventions.asciidoc[]
 include::{es-repo-dir}/cat.asciidoc[]
 include::{es-repo-dir}/cluster.asciidoc[]
 include::{es-repo-dir}/ccr/apis/ccr-apis.asciidoc[]
-include::{es-repo-dir}/data-frames/apis/index.asciidoc[]
 include::{es-repo-dir}/docs.asciidoc[]
 include::{es-repo-dir}/graph/explore.asciidoc[]
 include::{es-repo-dir}/indices.asciidoc[]
@@ -53,5 +52,6 @@ include::{es-repo-dir}/rollup/rollup-api.asciidoc[]
 include::{es-repo-dir}/search.asciidoc[]
 include::{xes-repo-dir}/rest-api/security.asciidoc[]
 include::{es-repo-dir}/ilm/apis/slm-api.asciidoc[]
+include::{es-repo-dir}/transform/apis/index.asciidoc[]
 include::{xes-repo-dir}/rest-api/watcher.asciidoc[]
 include::defs.asciidoc[]
diff --git a/docs/reference/data-frames/apis/delete-transform.asciidoc b/docs/reference/transform/apis/delete-transform.asciidoc
similarity index 100%
rename from docs/reference/data-frames/apis/delete-transform.asciidoc
rename to docs/reference/transform/apis/delete-transform.asciidoc
diff --git a/docs/reference/data-frames/apis/get-transform-stats.asciidoc b/docs/reference/transform/apis/get-transform-stats.asciidoc
similarity index 100%
rename from docs/reference/data-frames/apis/get-transform-stats.asciidoc
rename to docs/reference/transform/apis/get-transform-stats.asciidoc
diff --git a/docs/reference/data-frames/apis/get-transform.asciidoc b/docs/reference/transform/apis/get-transform.asciidoc
similarity index 100%
rename from docs/reference/data-frames/apis/get-transform.asciidoc
rename to docs/reference/transform/apis/get-transform.asciidoc
diff --git a/docs/reference/data-frames/apis/index.asciidoc b/docs/reference/transform/apis/index.asciidoc
similarity index 100%
rename from docs/reference/data-frames/apis/index.asciidoc
rename to docs/reference/transform/apis/index.asciidoc
diff --git a/docs/reference/data-frames/apis/preview-transform.asciidoc b/docs/reference/transform/apis/preview-transform.asciidoc
similarity index 100%
rename from docs/reference/data-frames/apis/preview-transform.asciidoc
rename to docs/reference/transform/apis/preview-transform.asciidoc
diff --git a/docs/reference/data-frames/apis/put-transform.asciidoc b/docs/reference/transform/apis/put-transform.asciidoc
similarity index 100%
rename from docs/reference/data-frames/apis/put-transform.asciidoc
rename to docs/reference/transform/apis/put-transform.asciidoc
diff --git a/docs/reference/data-frames/apis/start-transform.asciidoc b/docs/reference/transform/apis/start-transform.asciidoc
similarity index 100%
rename from docs/reference/data-frames/apis/start-transform.asciidoc
rename to docs/reference/transform/apis/start-transform.asciidoc
diff --git a/docs/reference/data-frames/apis/stop-transform.asciidoc b/docs/reference/transform/apis/stop-transform.asciidoc
similarity index 100%
rename from docs/reference/data-frames/apis/stop-transform.asciidoc
rename to docs/reference/transform/apis/stop-transform.asciidoc
diff --git a/docs/reference/data-frames/apis/transformresource.asciidoc b/docs/reference/transform/apis/transformresource.asciidoc
similarity index 100%
rename from docs/reference/data-frames/apis/transformresource.asciidoc
rename to docs/reference/transform/apis/transformresource.asciidoc
diff --git a/docs/reference/data-frames/apis/update-transform.asciidoc b/docs/reference/transform/apis/update-transform.asciidoc
similarity index 100%
rename from docs/reference/data-frames/apis/update-transform.asciidoc
rename to docs/reference/transform/apis/update-transform.asciidoc