diff --git a/oas_docs/output/kibana.yaml b/oas_docs/output/kibana.yaml
index b2162e6901b30..a89fc448c2701 100644
--- a/oas_docs/output/kibana.yaml
+++ b/oas_docs/output/kibana.yaml
@@ -337,7 +337,12 @@ tags:
       url: https://www.elastic.co/docs/deploy-manage/distributed-architecture/kibana-tasks-management
     name: task manager
     x-displayName: Task manager
-  - description: The assistant helps you prepare for the next major version of Elasticsearch.
+  - description: |
+      The Kibana Upgrade Assistant API helps you prepare for the next major Elasticsearch release.
+      > warn
+      > This is a Kibana REST API (not an Elasticsearch API) and requests must target your Kibana URL:
+      > * Self-managed URL pattern: `https://localhost:5601`
+      > * Elastic Cloud URL pattern: `https://your-deployment.kb.us-east-1.aws.elastic.cloud:9243`
     name: upgrade
     x-displayName: Upgrade assistant
   - description: Uptime APIs enable you to view and update uptime monitoring settings.
diff --git a/x-pack/platform/plugins/private/upgrade_assistant/docs/openapi/upgrade_apis.yaml b/x-pack/platform/plugins/private/upgrade_assistant/docs/openapi/upgrade_apis.yaml
index 35960135336fe..cf65bd548d173 100644
--- a/x-pack/platform/plugins/private/upgrade_assistant/docs/openapi/upgrade_apis.yaml
+++ b/x-pack/platform/plugins/private/upgrade_assistant/docs/openapi/upgrade_apis.yaml
@@ -8,7 +8,12 @@ info:
     url: https://www.elastic.co/licensing/elastic-license
 tags:
   - name: upgrade
-    description: The assistant helps you prepare for the next major version of Elasticsearch.
+    description: |
+      The Kibana Upgrade Assistant API helps you prepare for the next major Elasticsearch release.
+      > warn
+      > This is a Kibana REST API (not an Elasticsearch API) and requests must target your Kibana URL:
+      > * Self-managed URL pattern: `https://localhost:5601`
+      > * Elastic Cloud URL pattern: `https://your-deployment.kb.us-east-1.aws.elastic.cloud:9243`
     x-displayName: Upgrade assistant
 servers:
   - url: /