diff --git a/output/schema/schema.json b/output/schema/schema.json
index 3ec1aefb73..179effe8bd 100644
--- a/output/schema/schema.json
+++ b/output/schema/schema.json
@@ -8876,7 +8876,7 @@
         }
       },
       "deprecation": {
-        "description": "",
+        "description": "The kNN search API has been replaced by the `knn` option in the search API.",
         "version": "8.4.0"
       },
       "description": "Run a knn search.\n\nNOTE: The kNN search API has been replaced by the `knn` option in the search API.\n\nPerform a k-nearest neighbor (kNN) search on a dense_vector field and return the matching documents.\nGiven a query vector, the API finds the k closest vectors and returns those documents as search hits.\n\nElasticsearch uses the HNSW algorithm to support efficient kNN search.\nLike most kNN algorithms, HNSW is an approximate method that sacrifices result accuracy for improved search speed.\nThis means the results returned are not always the true k closest neighbors.\n\nThe kNN search API supports restricting the search using a filter.\nThe search will return the top k documents that also match the filter query.",
@@ -26955,7 +26955,7 @@
         ]
       },
       "deprecation": {
-        "description": "",
+        "description": "The kNN search API has been replaced by the `knn` option in the search API.",
         "version": "8.4.0"
       },
       "description": "Run a knn search.\n\nNOTE: The kNN search API has been replaced by the `knn` option in the search API.\n\nPerform a k-nearest neighbor (kNN) search on a dense_vector field and return the matching documents.\nGiven a query vector, the API finds the k closest vectors and returns those documents as search hits.\n\nElasticsearch uses the HNSW algorithm to support efficient kNN search.\nLike most kNN algorithms, HNSW is an approximate method that sacrifices result accuracy for improved search speed.\nThis means the results returned are not always the true k closest neighbors.\n\nThe kNN search API supports restricting the search using a filter.\nThe search will return the top k documents that also match the filter query.",
diff --git a/specification/_global/knn_search/KnnSearchRequest.ts b/specification/_global/knn_search/KnnSearchRequest.ts
index 2e826c9c82..c708a05440 100644
--- a/specification/_global/knn_search/KnnSearchRequest.ts
+++ b/specification/_global/knn_search/KnnSearchRequest.ts
@@ -39,7 +39,7 @@ import { Query } from './_types/Knn'
  * The search will return the top k documents that also match the filter query.
  * @rest_spec_name knn_search
  * @availability stack since=8.0.0 stability=experimental
- * @deprecated 8.4.0
+ * @deprecated 8.4.0 The kNN search API has been replaced by the `knn` option in the search API.
  * @doc_tag search
  */
 export interface Request extends RequestBase {