[DOCS] Relocate several APIs to REST APIs section (#44238)

docs/reference/api-conventions.asciidoc

@@ -1,8 +1,6 @@
 [[api-conventions]]
 = API conventions
 
-[partintro]
---
 The *Elasticsearch* REST APIs are exposed using <<modules-http,JSON over HTTP>>.
 
 The conventions listed in this chapter can be applied throughout the REST
@@ -13,8 +11,6 @@ API, unless otherwise specified.
 * <<common-options>>
 * <<url-access-control>>
 
---
-
 [[multi-index]]
 == Multiple Indices
 

docs/reference/cat.asciidoc

@@ -1,9 +1,6 @@
 [[cat]]
 = cat APIs
 
-[partintro]
---
-
 ["float",id="intro"]
 == Introduction
 
@@ -210,8 +207,6 @@ sushi_california_roll [*avocado*]    1     1
 pizza_hawaiian        [*pineapples*] 1
 --------------------------------------------------
 
---
-
 include::cat/alias.asciidoc[]
 
 include::cat/allocation.asciidoc[]

docs/reference/cluster.asciidoc

@@ -1,8 +1,6 @@
 [[cluster]]
 = Cluster APIs
 
-[partintro]
---
 ["float",id="cluster-nodes"]
 == Node specification
 
@@ -81,7 +79,6 @@ GET /_nodes/ra*:2
 GET /_nodes/ra*:2*
 --------------------------------------------------
 // CONSOLE
---
 
 include::cluster/health.asciidoc[]
 

docs/reference/docs.asciidoc

@@ -1,9 +1,6 @@
 [[docs]]
 = Document APIs
 
-[partintro]
---
-
 This section starts with a short introduction to Elasticsearch's <<docs-replication,data replication model>>, followed by a
 detailed description of the following CRUD APIs:
 
@@ -23,8 +20,6 @@ detailed description of the following CRUD APIs:
 NOTE: All CRUD APIs are single-index APIs. The `index` parameter accepts a single
 index name, or an `alias` which points to a single index.
 
---
-
 include::docs/data-replication.asciidoc[]
 
 include::docs/index_.asciidoc[]

docs/reference/index.asciidoc

@@ -29,20 +29,8 @@ include::setup/bootstrap-checks-xes.asciidoc[]
 :edit_url:
 include::upgrade.asciidoc[]
 
-include::api-conventions.asciidoc[]
-
-include::docs.asciidoc[]
-
-include::search.asciidoc[]
-
 include::aggregations.asciidoc[]
 
-include::indices.asciidoc[]
-
-include::cat.asciidoc[]
-
-include::cluster.asciidoc[]
-
 include::query-dsl.asciidoc[]
 
 include::scripting.asciidoc[]

docs/reference/indices.asciidoc

@@ -1,9 +1,7 @@
 [[indices]]
 = Indices APIs
 
-[partintro]
---
-The indices APIs are used to manage individual indices,
+Index APIs are used to manage individual indices,
 index settings, aliases, mappings, and index templates.
 
 [float]
@@ -18,6 +16,9 @@ index settings, aliases, mappings, and index templates.
 * <<indices-shrink-index>>
 * <<indices-split-index>>
 * <<indices-rollover-index>>
+* <<freeze-index-api>>
+* <<unfreeze-index-api>>
+
 
 [float]
 [[mapping-management]]
@@ -57,8 +58,6 @@ index settings, aliases, mappings, and index templates.
 * <<indices-flush>>
 * <<indices-forcemerge>>
 
---
-
 include::indices/create-index.asciidoc[]
 
 include::indices/delete-index.asciidoc[]
@@ -75,6 +74,12 @@ include::indices/split-index.asciidoc[]
 
 include::indices/rollover-index.asciidoc[]
 
+:leveloffset: -1
+include::indices/apis/freeze.asciidoc[]
+
+include::indices/apis/unfreeze.asciidoc[]
+
+:leveloffset: +1
 include::indices/put-mapping.asciidoc[]
 
 include::indices/get-mapping.asciidoc[]

docs/reference/indices/apis/index.asciidoc

@@ -1,11 +0,0 @@
-[[index-apis]]
-== Index APIs
-
-The index APIs are used to manage individual indices.
-
-* <<freeze-index-api>>, <<unfreeze-index-api>>
-
-See also <<indices>>.
-
-include::freeze.asciidoc[]
-include::unfreeze.asciidoc[]

docs/reference/redirects.asciidoc

@@ -607,3 +607,7 @@ See <<faster-prefix-queries>>.
 === X-Pack APIs
 
 {es} {xpack} APIs are now documented in <<rest-apis, REST APIs>>. 
+
+[role="exclude",id="index-apis"]
+=== Index APIs
+{es} index APIs are now documented in <<indices>>.

docs/reference/rest-api/index.asciidoc

@@ -10,11 +10,15 @@ directly to configure and access {es} features.
 We are working on including more {es} APIs in this section. Some content might
 not be included yet.
 
+* <<docs>>
+* <<search>>
+* <<indices>>
+* <<cat>>
+* <<cluster>>
 * <<info-api,Info API>>
 * <<ccr-apis,{ccr-cap} APIs>>
 * <<data-frame-apis,{dataframe-cap} APIs>>
 * <<graph-explore-api,Graph Explore API>>
-* <<index-apis>>
 * <<indices-reload-analyzers,Reload Search Analyzers API>>
 * <<index-lifecycle-management-api,Index lifecycle management APIs>>
 * <<licensing-apis,Licensing APIs>>
@@ -25,13 +29,20 @@ not be included yet.
 * <<migration-api,Migration APIs>>
 --
 
+:leveloffset: +1
+include::{es-repo-dir}/api-conventions.asciidoc[]
+include::{es-repo-dir}/docs.asciidoc[]
+include::{es-repo-dir}/search.asciidoc[]
+include::{es-repo-dir}/indices.asciidoc[]
+include::{es-repo-dir}/cat.asciidoc[]
+include::{es-repo-dir}/cluster.asciidoc[]
 
+:leveloffset: -1
 include::info.asciidoc[]
 include::{es-repo-dir}/ccr/apis/ccr-apis.asciidoc[]
 include::{es-repo-dir}/data-frames/apis/index.asciidoc[]
 include::{es-repo-dir}/graph/explore.asciidoc[]
 include::{es-repo-dir}/ilm/apis/ilm-api.asciidoc[]
-include::{es-repo-dir}/indices/apis/index.asciidoc[]
 include::{es-repo-dir}/licensing/index.asciidoc[]
 include::{es-repo-dir}/migration/migration.asciidoc[]
 include::{es-repo-dir}/ml/apis/ml-api.asciidoc[]

docs/reference/search.asciidoc

@@ -1,9 +1,6 @@
 [[search]]
 = Search APIs
 
-[partintro]
---
-
 Most search APIs are <<search-multi-index,multi-index>>, with the
 exception of the <<search-explain>> endpoints.
 
@@ -160,8 +157,6 @@ overloading a cluster (e.g., a default request will hit all indices in a cluster
 which could cause shard request rejections if the number of shards per node is
 high). This default value is `5`.
 
---
-
 include::search/search.asciidoc[]
 
 include::search/uri-request.asciidoc[]