diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json
index 67c12225ee..18c23fb23f 100644
--- a/output/openapi/elasticsearch-openapi.json
+++ b/output/openapi/elasticsearch-openapi.json
@@ -16477,7 +16477,8 @@
         "tags": [
           "migration"
         ],
-        "summary": "Retrieves information about different cluster, node, and index level settings that use deprecated features that will be removed or changed in the next major version",
+        "summary": "Get deprecation information",
+        "description": "Get information about different cluster, node, and index level settings that use deprecated features that will be removed or changed in the next major version.\n\nTIP: This APIs is designed for indirect use by the Upgrade Assistant. We strongly recommend you use the Upgrade Assistant.",
         "operationId": "migration-deprecations",
         "responses": {
           "200": {
@@ -16492,7 +16493,8 @@
         "tags": [
           "migration"
         ],
-        "summary": "Retrieves information about different cluster, node, and index level settings that use deprecated features that will be removed or changed in the next major version",
+        "summary": "Get deprecation information",
+        "description": "Get information about different cluster, node, and index level settings that use deprecated features that will be removed or changed in the next major version.\n\nTIP: This APIs is designed for indirect use by the Upgrade Assistant. We strongly recommend you use the Upgrade Assistant.",
         "operationId": "migration-deprecations-1",
         "parameters": [
           {
@@ -16512,7 +16514,8 @@
         "tags": [
           "migration"
         ],
-        "summary": "Find out whether system features need to be upgraded or not",
+        "summary": "Get feature migration information",
+        "description": "Version upgrades sometimes require changes to how features store configuration information and data in system indices.\nCheck which features need to be migrated and the status of any migrations that are in progress.\n\nTIP: This API is designed for indirect use by the Upgrade Assistant.\nWe strongly recommend you use the Upgrade Assistant.",
         "operationId": "migration-get-feature-upgrade-status",
         "responses": {
           "200": {
@@ -16547,7 +16550,8 @@
         "tags": [
           "migration"
         ],
-        "summary": "Begin upgrades for system features",
+        "summary": "Start the feature migration",
+        "description": "Version upgrades sometimes require changes to how features store configuration information and data in system indices.\nThis API starts the automatic migration process.\n\nSome functionality might be temporarily unavailable during the migration process.\n\nTIP: The API is designed for indirect use by the Upgrade Assistant. We strongly recommend you use the Upgrade Assistant.",
         "operationId": "migration-post-feature-upgrade",
         "responses": {
           "200": {
diff --git a/output/schema/schema.json b/output/schema/schema.json
index 478520ccf2..aa01964544 100644
--- a/output/schema/schema.json
+++ b/output/schema/schema.json
@@ -9546,9 +9546,14 @@
           "stability": "stable"
         }
       },
-      "description": "Retrieves information about different cluster, node, and index level settings that use deprecated features that will be removed or changed in the next major version.",
+      "description": "Get deprecation information.\nGet information about different cluster, node, and index level settings that use deprecated features that will be removed or changed in the next major version.\n\nTIP: This APIs is designed for indirect use by the Upgrade Assistant. We strongly recommend you use the Upgrade Assistant.",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/current/migration-api-deprecation.html",
       "name": "migration.deprecations",
+      "privileges": {
+        "cluster": [
+          "manage"
+        ]
+      },
       "request": {
         "name": "Request",
         "namespace": "migration.deprecations"
@@ -9583,10 +9588,13 @@
           "stability": "stable"
         }
       },
-      "description": "Find out whether system features need to be upgraded or not",
+      "description": "Get feature migration information.\nVersion upgrades sometimes require changes to how features store configuration information and data in system indices.\nCheck which features need to be migrated and the status of any migrations that are in progress.\n\nTIP: This API is designed for indirect use by the Upgrade Assistant.\nWe strongly recommend you use the Upgrade Assistant.",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/current/migration-api-feature-upgrade.html",
       "name": "migration.get_feature_upgrade_status",
       "privileges": {
+        "cluster": [
+          "manage"
+        ],
         "index": [
           "manage"
         ]
@@ -9619,10 +9627,13 @@
           "stability": "stable"
         }
       },
-      "description": "Begin upgrades for system features",
+      "description": "Start the feature migration.\nVersion upgrades sometimes require changes to how features store configuration information and data in system indices.\nThis API starts the automatic migration process.\n\nSome functionality might be temporarily unavailable during the migration process.\n\nTIP: The API is designed for indirect use by the Upgrade Assistant. We strongly recommend you use the Upgrade Assistant.",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/current/migration-api-feature-upgrade.html",
       "name": "migration.post_feature_upgrade",
       "privileges": {
+        "cluster": [
+          "manage"
+        ],
         "index": [
           "manage"
         ]
@@ -149447,7 +149458,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Retrieves information about different cluster, node, and index level settings that use deprecated features that will be removed or changed in the next major version.",
+      "description": "Get deprecation information.\nGet information about different cluster, node, and index level settings that use deprecated features that will be removed or changed in the next major version.\n\nTIP: This APIs is designed for indirect use by the Upgrade Assistant. We strongly recommend you use the Upgrade Assistant.",
       "inherits": {
         "type": {
           "name": "RequestBase",
@@ -149473,7 +149484,7 @@
         }
       ],
       "query": [],
-      "specLocation": "migration/deprecations/DeprecationInfoRequest.ts#L23-L32"
+      "specLocation": "migration/deprecations/DeprecationInfoRequest.ts#L23-L37"
     },
     {
       "kind": "response",
@@ -149710,7 +149721,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Find out whether system features need to be upgraded or not",
+      "description": "Get feature migration information.\nVersion upgrades sometimes require changes to how features store configuration information and data in system indices.\nCheck which features need to be migrated and the status of any migrations that are in progress.\n\nTIP: This API is designed for indirect use by the Upgrade Assistant.\nWe strongly recommend you use the Upgrade Assistant.",
       "inherits": {
         "type": {
           "name": "RequestBase",
@@ -149723,7 +149734,7 @@
       },
       "path": [],
       "query": [],
-      "specLocation": "migration/get_feature_upgrade_status/GetFeatureUpgradeStatusRequest.ts#L22-L27"
+      "specLocation": "migration/get_feature_upgrade_status/GetFeatureUpgradeStatusRequest.ts#L22-L34"
     },
     {
       "kind": "response",
@@ -149792,7 +149803,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Begin upgrades for system features",
+      "description": "Start the feature migration.\nVersion upgrades sometimes require changes to how features store configuration information and data in system indices.\nThis API starts the automatic migration process.\n\nSome functionality might be temporarily unavailable during the migration process.\n\nTIP: The API is designed for indirect use by the Upgrade Assistant. We strongly recommend you use the Upgrade Assistant.",
       "inherits": {
         "type": {
           "name": "RequestBase",
@@ -149805,7 +149816,7 @@
       },
       "path": [],
       "query": [],
-      "specLocation": "migration/post_feature_upgrade/PostFeatureUpgradeRequest.ts#L22-L27"
+      "specLocation": "migration/post_feature_upgrade/PostFeatureUpgradeRequest.ts#L22-L35"
     },
     {
       "kind": "response",