diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/_internal.delete_desired_nodes.json b/rest-api-spec/src/main/resources/rest-api-spec/api/_internal.delete_desired_nodes.json
index a60f99d694953..03a9a1c8635ab 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/_internal.delete_desired_nodes.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/_internal.delete_desired_nodes.json
@@ -2,7 +2,7 @@
   "_internal.delete_desired_nodes":{
     "documentation":{
       "url": null,
-      "description": "Deletes the desired nodes"
+      "description": "Designed for indirect use by ECE/ESS and ECK, direct use is not supported."
     },
     "stability":"experimental",
     "visibility":"private",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/_internal.update_desired_nodes.json b/rest-api-spec/src/main/resources/rest-api-spec/api/_internal.update_desired_nodes.json
index 689dfc8064fda..ae5c3962790f8 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/_internal.update_desired_nodes.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/_internal.update_desired_nodes.json
@@ -2,7 +2,7 @@
   "_internal.update_desired_nodes":{
     "documentation":{
       "url": null,
-      "description": "Updates the desired nodes"
+      "description": "Designed for indirect use by ECE/ESS and ECK, direct use is not supported."
     },
     "stability":"experimental",
     "visibility":"private",