[DOCS] Add links to search and search application APIs

lcawl · lcawl · commit fbab7147da99 · 2024-12-30T15:34:14.000-08:00
diff --git a/docs/reference/scripting/apis/create-stored-script-api.asciidoc b/docs/reference/scripting/apis/create-stored-script-api.asciidoc
@@ -4,6 +4,12 @@
 <titleabbrev>Create or update stored script</titleabbrev>
 ++++
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-script[Script APIs].
+--
+
 Creates or updates a <<script-stored-scripts,stored script>> or
 <<search-template,search template>>.
 
diff --git a/docs/reference/scripting/apis/delete-stored-script-api.asciidoc b/docs/reference/scripting/apis/delete-stored-script-api.asciidoc
@@ -4,6 +4,12 @@
 <titleabbrev>Delete stored script</titleabbrev>
 ++++
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-script[Script APIs].
+--
+
 Deletes a <<script-stored-scripts,stored script>> or <<search-template,search
 template>>.
 
diff --git a/docs/reference/scripting/apis/get-script-contexts-api.asciidoc b/docs/reference/scripting/apis/get-script-contexts-api.asciidoc
@@ -4,6 +4,12 @@
 <titleabbrev>Get script contexts</titleabbrev>
 ++++
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-script[Script APIs].
+--
+
 Retrieves a list of supported script contexts and their methods.
 
 [source,console]
diff --git a/docs/reference/scripting/apis/get-script-languages-api.asciidoc b/docs/reference/scripting/apis/get-script-languages-api.asciidoc
@@ -4,6 +4,12 @@
 <titleabbrev>Get script languages</titleabbrev>
 ++++
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-script[Script APIs].
+--
+
 Retrieves a list of supported <<scripting-available-languages,script languages>>
 and their contexts.
 
diff --git a/docs/reference/scripting/apis/get-stored-script-api.asciidoc b/docs/reference/scripting/apis/get-stored-script-api.asciidoc
@@ -4,6 +4,12 @@
 <titleabbrev>Get stored script</titleabbrev>
 ++++
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-script[Script APIs].
+--
+
 Retrieves a <<script-stored-scripts,stored script>> or <<search-template,search
 template>>.
 
diff --git a/docs/reference/search-application/apis/delete-search-application.asciidoc b/docs/reference/search-application/apis/delete-search-application.asciidoc
@@ -1,13 +1,18 @@
 [role="xpack"]
 [[delete-search-application]]
 === Delete Search Application
-
-beta::[]
-
 ++++
 <titleabbrev>Delete Search Application</titleabbrev>
 ++++
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-search_application[Search application APIs].
+--
+
+beta::[]
+
 Removes a Search Application and its associated alias.
 Indices attached to the Search Application are not removed.
 
diff --git a/docs/reference/search-application/apis/get-search-application.asciidoc b/docs/reference/search-application/apis/get-search-application.asciidoc
@@ -1,13 +1,18 @@
 [role="xpack"]
 [[get-search-application]]
 === Get Search Application
-
-beta::[]
-
 ++++
 <titleabbrev>Get Search Application</titleabbrev>
 ++++
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-search_application[Search application APIs].
+--
+
+beta::[]
+
 Retrieves information about a search application.
 
 [[get-search-application-request]]
diff --git a/docs/reference/search-application/apis/index.asciidoc b/docs/reference/search-application/apis/index.asciidoc
@@ -9,6 +9,12 @@ beta::[]
 
 ---
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-search_application[Search application APIs].
+--
+
 Use Search Application APIs to manage tasks and resources related to Search Applications.
 
 * <<put-search-application>>
diff --git a/docs/reference/search-application/apis/list-search-applications.asciidoc b/docs/reference/search-application/apis/list-search-applications.asciidoc
@@ -1,13 +1,18 @@
 [role="xpack"]
 [[list-search-applications]]
 === List Search Applications
-
-beta::[]
-
 ++++
 <titleabbrev>List Search Applications</titleabbrev>
 ++++
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-search_application[Search application APIs].
+--
+
+beta::[]
+
 Returns information about Search Applications.
 
 [[list-search-applications-request]]
diff --git a/docs/reference/search-application/apis/put-search-application.asciidoc b/docs/reference/search-application/apis/put-search-application.asciidoc
@@ -1,13 +1,18 @@
 [role="xpack"]
 [[put-search-application]]
 === Put Search Application
-
-beta::[]
-
 ++++
 <titleabbrev>Put Search Application</titleabbrev>
 ++++
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-search_application[Search application APIs].
+--
+
+beta::[]
+
 Creates or updates a Search Application.
 
 [[put-search-application-request]]
diff --git a/docs/reference/search-application/apis/search-application-render-query.asciidoc b/docs/reference/search-application/apis/search-application-render-query.asciidoc
@@ -1,13 +1,18 @@
 [role="xpack"]
 [[search-application-render-query]]
 === Render Search Application Query
-
-preview::[]
-
 ++++
 <titleabbrev>Render Search Application Query</titleabbrev>
 ++++
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-search_application[Search application APIs].
+--
+
+preview::[]
+
 Given specified query parameters, generates an {es} query using the search template associated with the search
 application or a default template if none is specified.
 Unspecified template parameters will be assigned their default values (if applicable).
diff --git a/docs/reference/search-application/apis/search-application-search.asciidoc b/docs/reference/search-application/apis/search-application-search.asciidoc
@@ -1,13 +1,18 @@
 [role="xpack"]
 [[search-application-search]]
 === Search Application Search
-
-beta::[]
-
 ++++
 <titleabbrev>Search Application Search</titleabbrev>
 ++++
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-search_application[Search application APIs].
+--
+
+beta::[]
+
 Given specified query parameters, generates and executes an {es} query using the search template associated
 with the search application or a default template if none is specified.
 Unspecified template parameters will be assigned their default values (if applicable).
diff --git a/docs/reference/search.asciidoc b/docs/reference/search.asciidoc
@@ -1,6 +1,12 @@
 [[search]]
 == Search APIs
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-search[Search APIs].
+--
+
 Search APIs are used to search and aggregate data stored in {es} indices and
 data streams. For an overview and related tutorials, see <<search-your-data>>.
 
diff --git a/docs/reference/search/async-search.asciidoc b/docs/reference/search/async-search.asciidoc
@@ -2,6 +2,12 @@
 [[async-search]]
 === Async search
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-search[Search APIs].
+--
+
 The async search API let you asynchronously execute a search request, monitor
 its progress, and retrieve partial results as they become available.
 
diff --git a/docs/reference/search/clear-scroll-api.asciidoc b/docs/reference/search/clear-scroll-api.asciidoc
@@ -4,6 +4,12 @@
 <titleabbrev>Clear scroll</titleabbrev>
 ++++
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-search[Search APIs].
+--
+
 Clears the search context and results for a
 <<scroll-search-results,scrolling search>>.
 
diff --git a/docs/reference/search/count.asciidoc b/docs/reference/search/count.asciidoc
@@ -4,6 +4,12 @@
 <titleabbrev>Count</titleabbrev>
 ++++
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-search[Search APIs].
+--
+
 Gets the number of matches for a search query.
 
 [source,console]
diff --git a/docs/reference/search/explain.asciidoc b/docs/reference/search/explain.asciidoc
@@ -4,6 +4,12 @@
 <titleabbrev>Explain</titleabbrev>
 ++++
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-search[Search APIs].
+--
+
 Returns information about why a specific document matches (or doesn't match) a 
 query.
 
diff --git a/docs/reference/search/field-caps.asciidoc b/docs/reference/search/field-caps.asciidoc
@@ -4,6 +4,11 @@
 <titleabbrev>Field capabilities</titleabbrev>
 ++++
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-search[Search APIs].
+--
 
 Allows you to retrieve the capabilities of fields among multiple indices.
 For data streams, the API returns field capabilities among the stream's backing
diff --git a/docs/reference/search/multi-search-template-api.asciidoc b/docs/reference/search/multi-search-template-api.asciidoc
@@ -4,6 +4,12 @@
 <titleabbrev>Multi search template</titleabbrev>
 ++++
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-search[Search APIs].
+--
+
 Runs multiple <<run-multiple-templated-searches,templated searches>> with a single
 request.
 
diff --git a/docs/reference/search/multi-search.asciidoc b/docs/reference/search/multi-search.asciidoc
@@ -4,6 +4,12 @@
 <titleabbrev>Multi search</titleabbrev>
 ++++
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-search[Search APIs].
+--
+
 Executes several searches with a single API request.
 
 [source,console]
diff --git a/docs/reference/search/point-in-time-api.asciidoc b/docs/reference/search/point-in-time-api.asciidoc
@@ -4,6 +4,12 @@
 <titleabbrev>Point in time</titleabbrev>
 ++++
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-search[Search APIs].
+--
+
 A search request by default executes against the most recent visible data of
 the target indices, which is called point in time. Elasticsearch pit (point in time)
 is a lightweight view into the state of the data as it existed when initiated.
diff --git a/docs/reference/search/profile.asciidoc b/docs/reference/search/profile.asciidoc
@@ -24,6 +24,11 @@ The output from the Profile API is *very* verbose, especially for complicated
 requests executed across many shards. Pretty-printing the response is
 recommended to help understand the output.
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-search[Search APIs].
+--
 
 [[search-profile-api-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/search/rank-eval.asciidoc b/docs/reference/search/rank-eval.asciidoc
@@ -4,6 +4,12 @@
 <titleabbrev>Ranking evaluation</titleabbrev>
 ++++
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-search[Search APIs].
+--
+
 Allows you to evaluate the quality of ranked search results over a set of
 typical search queries.
 
diff --git a/docs/reference/search/render-search-template-api.asciidoc b/docs/reference/search/render-search-template-api.asciidoc
@@ -4,6 +4,12 @@
 <titleabbrev>Render search template</titleabbrev>
 ++++
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-search[Search APIs].
+--
+
 Renders a <<search-template,search
 template>> as a <<search-search,search request body>>.
 
diff --git a/docs/reference/search/retriever.asciidoc b/docs/reference/search/retriever.asciidoc
@@ -14,6 +14,12 @@ Refer to <<retrievers-overview>> for a high level overview of the retrievers abs
 Refer to <<retrievers-examples, Retrievers examples>> for additional examples.
 ====
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-search[Search APIs].
+--
+
 The following retrievers are available:
 
 `standard`::
diff --git a/docs/reference/search/rrf.asciidoc b/docs/reference/search/rrf.asciidoc
@@ -27,6 +27,12 @@ return score
 [[rrf-api]]
 ==== Reciprocal rank fusion API
 
+.New API reference
+[sidebar]
+--
+For the most up-to-date API details, refer to {api-es}/group/endpoint-search[Search APIs].
+--
+
 You can use RRF as part of a <<search-search, search>> to combine and rank documents using separate sets of top documents (result sets) from a combination of <<retriever, child retrievers>> using an
 <<rrf-retriever, RRF retriever>>.
 A minimum of *two* child retrievers is required for ranking.
diff --git a/docs/reference/search/scroll-api.asciidoc b/docs/reference/search/scroll-api.asciidoc
diff --git a/docs/reference/search/search-shards.asciidoc b/docs/reference/search/search-shards.asciidoc
diff --git a/docs/reference/search/search-template-api.asciidoc b/docs/reference/search/search-template-api.asciidoc
diff --git a/docs/reference/search/search-vector-tile-api.asciidoc b/docs/reference/search/search-vector-tile-api.asciidoc
diff --git a/docs/reference/search/search.asciidoc b/docs/reference/search/search.asciidoc
diff --git a/docs/reference/search/suggesters.asciidoc b/docs/reference/search/suggesters.asciidoc
diff --git a/docs/reference/search/terms-enum.asciidoc b/docs/reference/search/terms-enum.asciidoc
diff --git a/docs/reference/search/validate.asciidoc b/docs/reference/search/validate.asciidoc
