diff --git a/docs/overlays/elasticsearch-shared-overlays.yaml b/docs/overlays/elasticsearch-shared-overlays.yaml
index 1a4828c983..d465e4f405 100644
--- a/docs/overlays/elasticsearch-shared-overlays.yaml
+++ b/docs/overlays/elasticsearch-shared-overlays.yaml
@@ -1360,6 +1360,293 @@ actions:
           examples:
             getBehavioralAnalyticsCollectionsResponseExample1:
               $ref: "../../specification/search_application/get_behavioral_analytics/examples/200_response/BehavioralAnalyticsGetResponseExample1.yaml"
+## Examples for cat
+  - target: "$.components['responses']['cat.aliases#200']"
+    description: "Add example for cat aliases response"
+    update: 
+      content:
+        text/plain:
+          schema:
+            type: string
+          examples:
+            catAliasesResponseExample1:
+              $ref: "../../specification/cat/aliases/examples/200_response/CatAliasesResponseExample1.yaml"
+  - target: "$.components['responses']['cat.allocation#200']"
+    description: "Add example for cat allocation response"
+    update: 
+      content:
+        text/plain:
+          schema:
+            type: string
+          examples:
+            catAllocationResponseExample1:
+              $ref: "../../specification/cat/allocation/examples/200_response/CatAllocationResponseExample1.yaml"
+  - target: "$.components['responses']['cat.component_templates#200']"
+    description: "Add example for cat component templates response"
+    update: 
+      content:
+        text/plain:
+          schema:
+            type: string
+          examples:
+            catComponentTemplatesResponseExample1:
+              $ref: "../../specification/cat/component_templates/examples/200_response/CatComponentTemplatesResponseExample1.yaml"
+  - target: "$.components['responses']['cat.count#200']"
+    description: "Add example for cat count response"
+    update: 
+      content:
+        text/plain:
+          schema:
+            type: string
+          examples:
+            catCountResponseExample1:
+              $ref: "../../specification/cat/count/examples/200_response/CatCountResponseExample1.yaml"
+            catCountResponseExample2:
+              $ref: "../../specification/cat/count/examples/200_response/CatCountResponseExample2.yaml" 
+  - target: "$.components['responses']['cat.fielddata#200']"
+    description: "Add example for cat fielddata response"
+    update: 
+      content:
+        text/plain:
+          schema:
+            type: string
+          examples:
+            catFieldDataResponseExample1:
+              $ref: "../../specification/cat/fielddata/examples/200_response/CatFielddataResponseExample1.yaml"
+            catFieldDataResponseExample2:
+              $ref: "../../specification/cat/fielddata/examples/200_response/CatFielddataResponseExample2.yaml" 
+  - target: "$.components['responses']['cat.indices#200']"
+    description: "Add example for cat indices response"
+    update: 
+      content:
+        text/plain:
+          schema:
+            type: string
+          examples:
+            catIndicesResponseExample1:
+              $ref: "../../specification/cat/indices/examples/200_response/CatIndicesResponseExample1.yaml" 
+  - target: "$.components['responses']['cat.ml_datafeeds#200']"
+    description: "Add example for cat datafeeds response"
+    update: 
+      content:
+        text/plain:
+          schema:
+            type: string
+          examples:
+            catDatafeedsResponseExample1:
+              $ref: "../../specification/cat/ml_datafeeds/examples/200_response/CatDatafeedsResponseExample1.yaml"
+  - target: "$.components['responses']['cat.ml_data_frame_analytics#200']"
+    description: "Add example for cat data frame analytics response"
+    update: 
+      content:
+        text/plain:
+          schema:
+            type: string
+          examples:
+            catDataFrameAnalyticsResponseExample1:
+              $ref: "../../specification/cat/ml_data_frame_analytics/examples/200_response/CatDataFrameAnalyticsResponseExample1.yaml" 
+  - target: "$.components['responses']['cat.ml_jobs#200']"
+    description: "Add example for cat anomaly detectors response"
+    update: 
+      content:
+        text/plain:
+          schema:
+            type: string
+          examples:
+            catAnomalyDetectorsResponseExample1:
+              $ref: "../../specification/cat/ml_jobs/examples/200_response/CatJobsResponseExample1.yaml"
+  - target: "$.components['responses']['cat.ml_trained_models#200']"
+    description: "Add example for cat trained models response"
+    update: 
+      content:
+        text/plain:
+          schema:
+            type: string
+          examples:
+            catTrainedModelsResponseExample1:
+              $ref: "../../specification/cat/ml_trained_models/examples/200_response/CatTrainedModelsResponseExample1.yaml"
+  - target: "$.components['responses']['cat.recovery#200']"
+    description: "Add example for cat recovery response"
+    update: 
+      content:
+        text/plain:
+          schema:
+            type: string
+          examples:
+            catRecoveryResponseExample1:
+              $ref: "../../specification/cat/recovery/examples/200_response/CatRecoveryResponseExample1.yaml"
+            catRecoveryResponseExample2:
+              $ref: "../../specification/cat/recovery/examples/200_response/CatRecoveryResponseExample2.yaml"
+            catRecoveryResponseExample3:
+              $ref: "../../specification/cat/recovery/examples/200_response/CatRecoveryResponseExample3.yaml"
+  - target: "$.components['responses']['cat.segments#200']"
+    description: "Add example for cat segments response"
+    update: 
+      content:
+        text/plain:
+          schema:
+            type: string
+          examples:
+            catSegmentsResponseExample1:
+              $ref: "../../specification/cat/segments/examples/200_response/CatSegmentsResponseExample1.yaml"
+  - target: "$.components['responses']['cat.shards#200']"
+    description: "Add example for cat shards response"
+    update: 
+      content:
+        text/plain:
+          schema:
+            type: string
+          examples:
+            catShardsResponseExample1:
+              $ref: "../../specification/cat/shards/examples/200_response/CatShardsResponseExample1.yaml"
+            catShardsResponseExample2:
+              $ref: "../../specification/cat/shards/examples/200_response/CatShardsResponseExample2.yaml"
+            catShardsResponseExample3:
+              $ref: "../../specification/cat/shards/examples/200_response/CatShardsResponseExample3.yaml"
+            catShardsResponseExample4:
+              $ref: "../../specification/cat/shards/examples/200_response/CatShardsResponseExample4.yaml"
+            catShardsResponseExample5:
+              $ref: "../../specification/cat/shards/examples/200_response/CatShardsResponseExample5.yaml"
+  - target: "$.components['responses']['cat.snapshots#200']"
+    description: "Add example for cat snapshot response"
+    update: 
+      content:
+        text/plain:
+          schema:
+            type: string
+          examples:
+            catSnapshotsResponseExample1:
+              $ref: "../../specification/cat/snapshots/examples/200_response/CatSnapshotsResponseExample1.yaml"
+  - target: "$.components['responses']['cat.templates#200']"
+    description: "Add example for cat templates response"
+    update: 
+      content:
+        text/plain:
+          schema:
+            type: string
+          examples:
+            catTemplatesResponseExample1:
+              $ref: "../../specification/cat/templates/examples/200_response/CatTemplatesResponseExample1.yaml"
+  - target: "$.components['responses']['cat.thread_pool#200']"
+    description: "Add example for cat thread pool response"
+    update: 
+      content:
+        text/plain:
+          schema:
+            type: string
+          examples:
+            catThreadPoolResponseExample1:
+              $ref: "../../specification/cat/thread_pool/examples/200_response/CatThreadPoolResponseExample1.yaml"
+            catThreadPoolResponseExample2:
+              $ref: "../../specification/cat/thread_pool/examples/200_response/CatThreadPoolResponseExample2.yaml"
+  - target: "$.components['responses']['cat.transforms#200']"
+    description: "Add example for cat transforms response"
+    update: 
+      content:
+        application/json:
+          examples:
+            catTransformsResponseExample1:
+              $ref: "../../specification/cat/transforms/examples/200_response/CatTransformsResponseExample1.yaml"
+  - target: "$.paths['/_cat/health']['get']"
+    description: "Add examples for cat health operation"
+    update: 
+      responses:
+        200: 
+          content:
+            text/plain:
+              schema:
+                type: string
+              examples:
+                catMasterResponseExample1: 
+                  $ref: "../../specification/cat/health/examples/200_response/CatHealthResponseExample1.yaml"
+  - target: "$.paths['/_cat/master']['get']"
+    description: "Add examples for cat master operation"
+    update: 
+      responses:
+        200: 
+          content:
+            text/plain:
+              schema:
+                type: string
+              examples:
+                catMasterResponseExample1: 
+                  $ref: "../../specification/cat/master/examples/200_response/CatMasterResponseExample1.yaml"
+  - target: "$.paths['/_cat/nodeattrs']['get']"
+    description: "Add examples for cat node attributes operation"
+    update: 
+      responses:
+        200: 
+          content:
+            text/plain:
+              schema:
+                type: string
+              examples:
+                catNodeAttributesResponseExample1: 
+                  $ref: "../../specification/cat/nodeattrs/examples/200_response/CatNodeAttributesResponseExample1.yaml"
+                catNodeAttributesResponseExample2: 
+                  $ref: "../../specification/cat/nodeattrs/examples/200_response/CatNodeAttributesResponseExample2.yaml"
+  - target: "$.paths['/_cat/nodes']['get']"
+    description: "Add examples for cat nodes operation"
+    update: 
+      responses:
+        200: 
+          content:
+            text/plain:
+              schema:
+                type: string
+              examples:
+                catNodesResponseExample1: 
+                  $ref: "../../specification/cat/nodes/examples/200_response/CatNodesResponseExample1.yaml"
+                catNodesResponseExample2: 
+                  $ref: "../../specification/cat/nodes/examples/200_response/CatNodesResponseExample2.yaml"
+  - target: "$.paths['/_cat/pending_tasks']['get']"
+    description: "Add examples for cat pending tasks operation"
+    update: 
+      responses:
+        200: 
+          content:
+            text/plain:
+              schema:
+                type: string
+              examples:
+                catPendingTasksResponseExample1: 
+                  $ref: "../../specification/cat/pending_tasks/examples/200_response/CatPendingTasksResponseExample1.yaml"
+  - target: "$.paths['/_cat/plugins']['get']"
+    description: "Add examples for cat plugins operation"
+    update: 
+      responses:
+        200: 
+          content:
+            text/plain:
+              schema:
+                type: string
+              examples:
+                catPluginsResponseExample1: 
+                  $ref: "../../specification/cat/plugins/examples/200_response/CatPluginsResponseExample1.yaml"
+  - target: "$.paths['/_cat/repositories']['get']"
+    description: "Add examples for cat repositories operation"
+    update: 
+      responses:
+        200: 
+          content:
+            text/plain:
+              schema:
+                type: string
+              examples:
+                catRepositoriesResponseExample1: 
+                  $ref: "../../specification/cat/repositories/examples/200_response/CatRepositoriesResponseExample1.yaml"
+  - target: "$.paths['/_cat/tasks']['get']"
+    description: "Add examples for cat tasks operation"
+    update: 
+      responses:
+        200: 
+          content:
+            text/plain:
+              schema:
+                type: string
+              examples:
+                catTasksResponseExample1: 
+                  $ref: "../../specification/cat/tasks/examples/200_response/CatTasksResponseExample1.yaml"
 ## Examples for licensing
   - target: "$.paths['/_license']['get']"
     description: "Add example for get license response"
@@ -1408,4 +1695,4 @@ actions:
         application/json:
           examples:
             searchApplicationSearchRequestExample1:
-              $ref: "../../specification/search_application/search/examples/request/SearchApplicationsSearchRequestExample1.yaml"
\ No newline at end of file
+              $ref: "../../specification/search_application/search/examples/request/SearchApplicationsSearchRequestExample1.yaml"
diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json
index dc0a00296e..271662b49b 100644
--- a/output/openapi/elasticsearch-openapi.json
+++ b/output/openapi/elasticsearch-openapi.json
@@ -894,7 +894,7 @@
           "cat"
         ],
         "summary": "Get aliases",
-        "description": "Retrieves the cluster’s index aliases, including filter and routing information.\nThe API does not return data stream aliases.\n\nCAT APIs are only intended for human consumption using the command line or the Kibana console. They are not intended for use by applications. For application consumption, use the aliases API.",
+        "description": "Get the cluster's index aliases, including filter and routing information.\nThis API does not return data stream aliases.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or the Kibana console. They are not intended for use by applications. For application consumption, use the aliases API.",
         "operationId": "cat-aliases",
         "parameters": [
           {
@@ -917,7 +917,7 @@
           "cat"
         ],
         "summary": "Get aliases",
-        "description": "Retrieves the cluster’s index aliases, including filter and routing information.\nThe API does not return data stream aliases.\n\nCAT APIs are only intended for human consumption using the command line or the Kibana console. They are not intended for use by applications. For application consumption, use the aliases API.",
+        "description": "Get the cluster's index aliases, including filter and routing information.\nThis API does not return data stream aliases.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or the Kibana console. They are not intended for use by applications. For application consumption, use the aliases API.",
         "operationId": "cat-aliases-1",
         "parameters": [
           {
@@ -943,7 +943,7 @@
           "cat"
         ],
         "summary": "Get shard allocation information",
-        "description": "Get a snapshot of the number of shards allocated to each data node and their disk space.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications.",
+        "description": "Get a snapshot of the number of shards allocated to each data node and their disk space.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications.",
         "operationId": "cat-allocation",
         "parameters": [
           {
@@ -969,7 +969,7 @@
           "cat"
         ],
         "summary": "Get shard allocation information",
-        "description": "Get a snapshot of the number of shards allocated to each data node and their disk space.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications.",
+        "description": "Get a snapshot of the number of shards allocated to each data node and their disk space.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications.",
         "operationId": "cat-allocation-1",
         "parameters": [
           {
@@ -998,7 +998,7 @@
           "cat"
         ],
         "summary": "Get component templates",
-        "description": "Returns information about component templates in a cluster.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the get component template API.",
+        "description": "Get information about component templates in a cluster.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the get component template API.",
         "operationId": "cat-component-templates",
         "parameters": [
           {
@@ -1022,7 +1022,7 @@
           "cat"
         ],
         "summary": "Get component templates",
-        "description": "Returns information about component templates in a cluster.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the get component template API.",
+        "description": "Get information about component templates in a cluster.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the get component template API.",
         "operationId": "cat-component-templates-1",
         "parameters": [
           {
@@ -1049,7 +1049,7 @@
           "cat"
         ],
         "summary": "Get a document count",
-        "description": "Provides quick access to a document count for a data stream, an index, or an entire cluster.\nThe document count only includes live documents, not deleted documents which have not yet been removed by the merge process.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the count API.",
+        "description": "Get quick access to a document count for a data stream, an index, or an entire cluster.\nThe document count only includes live documents, not deleted documents which have not yet been removed by the merge process.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the count API.",
         "operationId": "cat-count",
         "responses": {
           "200": {
@@ -1064,7 +1064,7 @@
           "cat"
         ],
         "summary": "Get a document count",
-        "description": "Provides quick access to a document count for a data stream, an index, or an entire cluster.\nThe document count only includes live documents, not deleted documents which have not yet been removed by the merge process.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the count API.",
+        "description": "Get quick access to a document count for a data stream, an index, or an entire cluster.\nThe document count only includes live documents, not deleted documents which have not yet been removed by the merge process.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the count API.",
         "operationId": "cat-count-1",
         "parameters": [
           {
@@ -1084,7 +1084,7 @@
           "cat"
         ],
         "summary": "Get field data cache information",
-        "description": "Get the amount of heap memory currently used by the field data cache on every data node in the cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the nodes stats API.",
+        "description": "Get the amount of heap memory currently used by the field data cache on every data node in the cluster.\n\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the nodes stats API.",
         "operationId": "cat-fielddata",
         "parameters": [
           {
@@ -1107,7 +1107,7 @@
           "cat"
         ],
         "summary": "Get field data cache information",
-        "description": "Get the amount of heap memory currently used by the field data cache on every data node in the cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the nodes stats API.",
+        "description": "Get the amount of heap memory currently used by the field data cache on every data node in the cluster.\n\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the nodes stats API.",
         "operationId": "cat-fielddata-1",
         "parameters": [
           {
@@ -1133,7 +1133,7 @@
           "cat"
         ],
         "summary": "Get the cluster health status",
-        "description": "IMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the cluster health API.\nThis API is often used to check malfunctioning clusters.\nTo help you track cluster health alongside log files and alerting systems, the API returns timestamps in two formats:\n`HH:MM:SS`, which is human-readable but includes no date information;\n`Unix epoch time`, which is machine-sortable and includes date information.\nThe latter format is useful for cluster recoveries that take multiple days.\nYou can use the cat health API to verify cluster health across multiple nodes.\nYou also can use the API to track the recovery of a large cluster over a longer period of time.",
+        "description": "IMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the cluster health API.\nThis API is often used to check malfunctioning clusters.\nTo help you track cluster health alongside log files and alerting systems, the API returns timestamps in two formats:\n`HH:MM:SS`, which is human-readable but includes no date information;\n`Unix epoch time`, which is machine-sortable and includes date information.\nThe latter format is useful for cluster recoveries that take multiple days.\nYou can use the cat health API to verify cluster health across multiple nodes.\nYou also can use the API to track the recovery of a large cluster over a longer period of time.",
         "operationId": "cat-health",
         "parameters": [
           {
@@ -1180,7 +1180,7 @@
           "cat"
         ],
         "summary": "Get CAT help",
-        "description": "Returns help for the CAT APIs.",
+        "description": "Get help for the CAT APIs.",
         "operationId": "cat-help",
         "responses": {
           "200": {
@@ -1202,7 +1202,7 @@
           "cat"
         ],
         "summary": "Get index information",
-        "description": "Returns high-level information about indices in a cluster, including backing indices for data streams.\n\nUse this request to get the following information for each index in a cluster:\n- shard count\n- document count\n- deleted document count\n- primary store size\n- total store size of all shards, including shard replicas\n\nThese metrics are retrieved directly from Lucene, which Elasticsearch uses internally to power indexing and search. As a result, all document counts include hidden nested documents.\nTo get an accurate count of Elasticsearch documents, use the cat count or count APIs.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use an index endpoint.",
+        "description": "Get high-level information about indices in a cluster, including backing indices for data streams.\n\nUse this request to get the following information for each index in a cluster:\n- shard count\n- document count\n- deleted document count\n- primary store size\n- total store size of all shards, including shard replicas\n\nThese metrics are retrieved directly from Lucene, which Elasticsearch uses internally to power indexing and search. As a result, all document counts include hidden nested documents.\nTo get an accurate count of Elasticsearch documents, use the cat count or count APIs.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use an index endpoint.",
         "operationId": "cat-indices",
         "parameters": [
           {
@@ -1240,7 +1240,7 @@
           "cat"
         ],
         "summary": "Get index information",
-        "description": "Returns high-level information about indices in a cluster, including backing indices for data streams.\n\nUse this request to get the following information for each index in a cluster:\n- shard count\n- document count\n- deleted document count\n- primary store size\n- total store size of all shards, including shard replicas\n\nThese metrics are retrieved directly from Lucene, which Elasticsearch uses internally to power indexing and search. As a result, all document counts include hidden nested documents.\nTo get an accurate count of Elasticsearch documents, use the cat count or count APIs.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use an index endpoint.",
+        "description": "Get high-level information about indices in a cluster, including backing indices for data streams.\n\nUse this request to get the following information for each index in a cluster:\n- shard count\n- document count\n- deleted document count\n- primary store size\n- total store size of all shards, including shard replicas\n\nThese metrics are retrieved directly from Lucene, which Elasticsearch uses internally to power indexing and search. As a result, all document counts include hidden nested documents.\nTo get an accurate count of Elasticsearch documents, use the cat count or count APIs.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use an index endpoint.",
         "operationId": "cat-indices-1",
         "parameters": [
           {
@@ -1281,7 +1281,7 @@
           "cat"
         ],
         "summary": "Get master node information",
-        "description": "Get information about the master node, including the ID, bound IP address, and name.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.",
+        "description": "Get information about the master node, including the ID, bound IP address, and name.\n\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.",
         "operationId": "cat-master",
         "parameters": [
           {
@@ -1328,7 +1328,7 @@
           "cat"
         ],
         "summary": "Get data frame analytics jobs",
-        "description": "Returns configuration and usage information about data frame analytics jobs.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get data frame analytics jobs statistics API.",
+        "description": "Get configuration and usage information about data frame analytics jobs.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get data frame analytics jobs statistics API.",
         "operationId": "cat-ml-data-frame-analytics",
         "parameters": [
           {
@@ -1361,7 +1361,7 @@
           "cat"
         ],
         "summary": "Get data frame analytics jobs",
-        "description": "Returns configuration and usage information about data frame analytics jobs.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get data frame analytics jobs statistics API.",
+        "description": "Get configuration and usage information about data frame analytics jobs.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get data frame analytics jobs statistics API.",
         "operationId": "cat-ml-data-frame-analytics-1",
         "parameters": [
           {
@@ -1397,7 +1397,7 @@
           "cat"
         ],
         "summary": "Get datafeeds",
-        "description": "Returns configuration and usage information about datafeeds.\nThis API returns a maximum of 10,000 datafeeds.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`, `monitor`, `manage_ml`, or `manage`\ncluster privileges to use this API.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get datafeed statistics API.",
+        "description": "Get configuration and usage information about datafeeds.\nThis API returns a maximum of 10,000 datafeeds.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`, `monitor`, `manage_ml`, or `manage`\ncluster privileges to use this API.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get datafeed statistics API.",
         "operationId": "cat-ml-datafeeds",
         "parameters": [
           {
@@ -1427,7 +1427,7 @@
           "cat"
         ],
         "summary": "Get datafeeds",
-        "description": "Returns configuration and usage information about datafeeds.\nThis API returns a maximum of 10,000 datafeeds.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`, `monitor`, `manage_ml`, or `manage`\ncluster privileges to use this API.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get datafeed statistics API.",
+        "description": "Get configuration and usage information about datafeeds.\nThis API returns a maximum of 10,000 datafeeds.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`, `monitor`, `manage_ml`, or `manage`\ncluster privileges to use this API.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get datafeed statistics API.",
         "operationId": "cat-ml-datafeeds-1",
         "parameters": [
           {
@@ -1460,7 +1460,7 @@
           "cat"
         ],
         "summary": "Get anomaly detection jobs",
-        "description": "Returns configuration and usage information for anomaly detection jobs.\nThis API returns a maximum of 10,000 jobs.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`,\n`monitor`, `manage_ml`, or `manage` cluster privileges to use this API.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get anomaly detection job statistics API.",
+        "description": "Get configuration and usage information for anomaly detection jobs.\nThis API returns a maximum of 10,000 jobs.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`,\n`monitor`, `manage_ml`, or `manage` cluster privileges to use this API.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get anomaly detection job statistics API.",
         "operationId": "cat-ml-jobs",
         "parameters": [
           {
@@ -1493,7 +1493,7 @@
           "cat"
         ],
         "summary": "Get anomaly detection jobs",
-        "description": "Returns configuration and usage information for anomaly detection jobs.\nThis API returns a maximum of 10,000 jobs.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`,\n`monitor`, `manage_ml`, or `manage` cluster privileges to use this API.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get anomaly detection job statistics API.",
+        "description": "Get configuration and usage information for anomaly detection jobs.\nThis API returns a maximum of 10,000 jobs.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`,\n`monitor`, `manage_ml`, or `manage` cluster privileges to use this API.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get anomaly detection job statistics API.",
         "operationId": "cat-ml-jobs-1",
         "parameters": [
           {
@@ -1529,7 +1529,7 @@
           "cat"
         ],
         "summary": "Get trained models",
-        "description": "Returns configuration and usage information about inference trained models.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get trained models statistics API.",
+        "description": "Get configuration and usage information about inference trained models.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get trained models statistics API.",
         "operationId": "cat-ml-trained-models",
         "parameters": [
           {
@@ -1568,7 +1568,7 @@
           "cat"
         ],
         "summary": "Get trained models",
-        "description": "Returns configuration and usage information about inference trained models.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get trained models statistics API.",
+        "description": "Get configuration and usage information about inference trained models.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get trained models statistics API.",
         "operationId": "cat-ml-trained-models-1",
         "parameters": [
           {
@@ -2073,7 +2073,7 @@
         "tags": [
           "cat"
         ],
-        "summary": "Get snapshot information\n",
+        "summary": "Get snapshot information",
         "description": "Get information about the snapshots stored in one or more repositories.\nA snapshot is a backup of an index or running Elasticsearch cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the get snapshot API.",
         "operationId": "cat-snapshots",
         "parameters": [
@@ -2100,7 +2100,7 @@
         "tags": [
           "cat"
         ],
-        "summary": "Get snapshot information\n",
+        "summary": "Get snapshot information",
         "description": "Get information about the snapshots stored in one or more repositories.\nA snapshot is a backup of an index or running Elasticsearch cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the get snapshot API.",
         "operationId": "cat-snapshots-1",
         "parameters": [
@@ -98399,7 +98399,7 @@
       "cat.aliases#expand_wildcards": {
         "in": "query",
         "name": "expand_wildcards",
-        "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.",
+        "description": "The type of index that wildcard patterns can match.\nIf the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.\nIt supports comma-separated values, such as `open,hidden`.",
         "deprecated": false,
         "schema": {
           "$ref": "#/components/schemas/_types:ExpandWildcards"
@@ -98409,7 +98409,7 @@
       "cat.aliases#master_timeout": {
         "in": "query",
         "name": "master_timeout",
-        "description": "Period to wait for a connection to the master node.",
+        "description": "The period to wait for a connection to the master node.\nIf the master node is not available before the timeout expires, the request fails and returns an error.\nTo indicated that the request should never timeout, you can set it to `-1`.",
         "deprecated": false,
         "schema": {
           "$ref": "#/components/schemas/_types:Duration"
@@ -98419,7 +98419,7 @@
       "cat.allocation#node_id": {
         "in": "path",
         "name": "node_id",
-        "description": "Comma-separated list of node identifiers or names used to limit the returned information.",
+        "description": "A comma-separated list of node identifiers or names used to limit the returned information.",
         "required": true,
         "deprecated": false,
         "schema": {
@@ -98460,7 +98460,7 @@
       "cat.component_templates#name": {
         "in": "path",
         "name": "name",
-        "description": "The name of the component template. Accepts wildcard expressions. If omitted, all component templates are returned.",
+        "description": "The name of the component template.\nIt accepts wildcard expressions.\nIf it is omitted, all component templates are returned.",
         "required": true,
         "deprecated": false,
         "schema": {
@@ -98481,7 +98481,7 @@
       "cat.component_templates#master_timeout": {
         "in": "query",
         "name": "master_timeout",
-        "description": "Period to wait for a connection to the master node.",
+        "description": "The period to wait for a connection to the master node.",
         "deprecated": false,
         "schema": {
           "$ref": "#/components/schemas/_types:Duration"
@@ -98491,7 +98491,7 @@
       "cat.count#index": {
         "in": "path",
         "name": "index",
-        "description": "Comma-separated list of data streams, indices, and aliases used to limit the request.\nSupports wildcards (`*`). To target all data streams and indices, omit this parameter or use `*` or `_all`.",
+        "description": "A comma-separated list of data streams, indices, and aliases used to limit the request.\nIt supports wildcards (`*`).\nTo target all data streams and indices, omit this parameter or use `*` or `_all`.",
         "required": true,
         "deprecated": false,
         "schema": {
diff --git a/output/openapi/elasticsearch-serverless-openapi.json b/output/openapi/elasticsearch-serverless-openapi.json
index 7746d1861f..fcb1a3da9d 100644
--- a/output/openapi/elasticsearch-serverless-openapi.json
+++ b/output/openapi/elasticsearch-serverless-openapi.json
@@ -672,7 +672,7 @@
           "cat"
         ],
         "summary": "Get aliases",
-        "description": "Retrieves the cluster’s index aliases, including filter and routing information.\nThe API does not return data stream aliases.\n\nCAT APIs are only intended for human consumption using the command line or the Kibana console. They are not intended for use by applications. For application consumption, use the aliases API.",
+        "description": "Get the cluster's index aliases, including filter and routing information.\nThis API does not return data stream aliases.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or the Kibana console. They are not intended for use by applications. For application consumption, use the aliases API.",
         "operationId": "cat-aliases",
         "parameters": [
           {
@@ -695,7 +695,7 @@
           "cat"
         ],
         "summary": "Get aliases",
-        "description": "Retrieves the cluster’s index aliases, including filter and routing information.\nThe API does not return data stream aliases.\n\nCAT APIs are only intended for human consumption using the command line or the Kibana console. They are not intended for use by applications. For application consumption, use the aliases API.",
+        "description": "Get the cluster's index aliases, including filter and routing information.\nThis API does not return data stream aliases.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or the Kibana console. They are not intended for use by applications. For application consumption, use the aliases API.",
         "operationId": "cat-aliases-1",
         "parameters": [
           {
@@ -721,7 +721,7 @@
           "cat"
         ],
         "summary": "Get component templates",
-        "description": "Returns information about component templates in a cluster.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the get component template API.",
+        "description": "Get information about component templates in a cluster.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the get component template API.",
         "operationId": "cat-component-templates",
         "parameters": [
           {
@@ -745,7 +745,7 @@
           "cat"
         ],
         "summary": "Get component templates",
-        "description": "Returns information about component templates in a cluster.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the get component template API.",
+        "description": "Get information about component templates in a cluster.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the get component template API.",
         "operationId": "cat-component-templates-1",
         "parameters": [
           {
@@ -772,7 +772,7 @@
           "cat"
         ],
         "summary": "Get a document count",
-        "description": "Provides quick access to a document count for a data stream, an index, or an entire cluster.\nThe document count only includes live documents, not deleted documents which have not yet been removed by the merge process.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the count API.",
+        "description": "Get quick access to a document count for a data stream, an index, or an entire cluster.\nThe document count only includes live documents, not deleted documents which have not yet been removed by the merge process.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the count API.",
         "operationId": "cat-count",
         "responses": {
           "200": {
@@ -787,7 +787,7 @@
           "cat"
         ],
         "summary": "Get a document count",
-        "description": "Provides quick access to a document count for a data stream, an index, or an entire cluster.\nThe document count only includes live documents, not deleted documents which have not yet been removed by the merge process.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the count API.",
+        "description": "Get quick access to a document count for a data stream, an index, or an entire cluster.\nThe document count only includes live documents, not deleted documents which have not yet been removed by the merge process.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the count API.",
         "operationId": "cat-count-1",
         "parameters": [
           {
@@ -807,7 +807,7 @@
           "cat"
         ],
         "summary": "Get CAT help",
-        "description": "Returns help for the CAT APIs.",
+        "description": "Get help for the CAT APIs.",
         "operationId": "cat-help",
         "responses": {
           "200": {
@@ -829,7 +829,7 @@
           "cat"
         ],
         "summary": "Get index information",
-        "description": "Returns high-level information about indices in a cluster, including backing indices for data streams.\n\nUse this request to get the following information for each index in a cluster:\n- shard count\n- document count\n- deleted document count\n- primary store size\n- total store size of all shards, including shard replicas\n\nThese metrics are retrieved directly from Lucene, which Elasticsearch uses internally to power indexing and search. As a result, all document counts include hidden nested documents.\nTo get an accurate count of Elasticsearch documents, use the cat count or count APIs.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use an index endpoint.",
+        "description": "Get high-level information about indices in a cluster, including backing indices for data streams.\n\nUse this request to get the following information for each index in a cluster:\n- shard count\n- document count\n- deleted document count\n- primary store size\n- total store size of all shards, including shard replicas\n\nThese metrics are retrieved directly from Lucene, which Elasticsearch uses internally to power indexing and search. As a result, all document counts include hidden nested documents.\nTo get an accurate count of Elasticsearch documents, use the cat count or count APIs.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use an index endpoint.",
         "operationId": "cat-indices",
         "parameters": [
           {
@@ -867,7 +867,7 @@
           "cat"
         ],
         "summary": "Get index information",
-        "description": "Returns high-level information about indices in a cluster, including backing indices for data streams.\n\nUse this request to get the following information for each index in a cluster:\n- shard count\n- document count\n- deleted document count\n- primary store size\n- total store size of all shards, including shard replicas\n\nThese metrics are retrieved directly from Lucene, which Elasticsearch uses internally to power indexing and search. As a result, all document counts include hidden nested documents.\nTo get an accurate count of Elasticsearch documents, use the cat count or count APIs.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use an index endpoint.",
+        "description": "Get high-level information about indices in a cluster, including backing indices for data streams.\n\nUse this request to get the following information for each index in a cluster:\n- shard count\n- document count\n- deleted document count\n- primary store size\n- total store size of all shards, including shard replicas\n\nThese metrics are retrieved directly from Lucene, which Elasticsearch uses internally to power indexing and search. As a result, all document counts include hidden nested documents.\nTo get an accurate count of Elasticsearch documents, use the cat count or count APIs.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use an index endpoint.",
         "operationId": "cat-indices-1",
         "parameters": [
           {
@@ -908,7 +908,7 @@
           "cat"
         ],
         "summary": "Get data frame analytics jobs",
-        "description": "Returns configuration and usage information about data frame analytics jobs.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get data frame analytics jobs statistics API.",
+        "description": "Get configuration and usage information about data frame analytics jobs.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get data frame analytics jobs statistics API.",
         "operationId": "cat-ml-data-frame-analytics",
         "parameters": [
           {
@@ -941,7 +941,7 @@
           "cat"
         ],
         "summary": "Get data frame analytics jobs",
-        "description": "Returns configuration and usage information about data frame analytics jobs.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get data frame analytics jobs statistics API.",
+        "description": "Get configuration and usage information about data frame analytics jobs.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get data frame analytics jobs statistics API.",
         "operationId": "cat-ml-data-frame-analytics-1",
         "parameters": [
           {
@@ -977,7 +977,7 @@
           "cat"
         ],
         "summary": "Get datafeeds",
-        "description": "Returns configuration and usage information about datafeeds.\nThis API returns a maximum of 10,000 datafeeds.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`, `monitor`, `manage_ml`, or `manage`\ncluster privileges to use this API.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get datafeed statistics API.",
+        "description": "Get configuration and usage information about datafeeds.\nThis API returns a maximum of 10,000 datafeeds.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`, `monitor`, `manage_ml`, or `manage`\ncluster privileges to use this API.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get datafeed statistics API.",
         "operationId": "cat-ml-datafeeds",
         "parameters": [
           {
@@ -1007,7 +1007,7 @@
           "cat"
         ],
         "summary": "Get datafeeds",
-        "description": "Returns configuration and usage information about datafeeds.\nThis API returns a maximum of 10,000 datafeeds.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`, `monitor`, `manage_ml`, or `manage`\ncluster privileges to use this API.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get datafeed statistics API.",
+        "description": "Get configuration and usage information about datafeeds.\nThis API returns a maximum of 10,000 datafeeds.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`, `monitor`, `manage_ml`, or `manage`\ncluster privileges to use this API.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get datafeed statistics API.",
         "operationId": "cat-ml-datafeeds-1",
         "parameters": [
           {
@@ -1040,7 +1040,7 @@
           "cat"
         ],
         "summary": "Get anomaly detection jobs",
-        "description": "Returns configuration and usage information for anomaly detection jobs.\nThis API returns a maximum of 10,000 jobs.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`,\n`monitor`, `manage_ml`, or `manage` cluster privileges to use this API.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get anomaly detection job statistics API.",
+        "description": "Get configuration and usage information for anomaly detection jobs.\nThis API returns a maximum of 10,000 jobs.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`,\n`monitor`, `manage_ml`, or `manage` cluster privileges to use this API.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get anomaly detection job statistics API.",
         "operationId": "cat-ml-jobs",
         "parameters": [
           {
@@ -1073,7 +1073,7 @@
           "cat"
         ],
         "summary": "Get anomaly detection jobs",
-        "description": "Returns configuration and usage information for anomaly detection jobs.\nThis API returns a maximum of 10,000 jobs.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`,\n`monitor`, `manage_ml`, or `manage` cluster privileges to use this API.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get anomaly detection job statistics API.",
+        "description": "Get configuration and usage information for anomaly detection jobs.\nThis API returns a maximum of 10,000 jobs.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`,\n`monitor`, `manage_ml`, or `manage` cluster privileges to use this API.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get anomaly detection job statistics API.",
         "operationId": "cat-ml-jobs-1",
         "parameters": [
           {
@@ -1109,7 +1109,7 @@
           "cat"
         ],
         "summary": "Get trained models",
-        "description": "Returns configuration and usage information about inference trained models.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get trained models statistics API.",
+        "description": "Get configuration and usage information about inference trained models.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get trained models statistics API.",
         "operationId": "cat-ml-trained-models",
         "parameters": [
           {
@@ -1148,7 +1148,7 @@
           "cat"
         ],
         "summary": "Get trained models",
-        "description": "Returns configuration and usage information about inference trained models.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get trained models statistics API.",
+        "description": "Get configuration and usage information about inference trained models.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get trained models statistics API.",
         "operationId": "cat-ml-trained-models-1",
         "parameters": [
           {
@@ -58376,7 +58376,7 @@
       "cat.aliases#expand_wildcards": {
         "in": "query",
         "name": "expand_wildcards",
-        "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.",
+        "description": "The type of index that wildcard patterns can match.\nIf the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.\nIt supports comma-separated values, such as `open,hidden`.",
         "deprecated": false,
         "schema": {
           "$ref": "#/components/schemas/_types:ExpandWildcards"
@@ -58386,7 +58386,7 @@
       "cat.aliases#master_timeout": {
         "in": "query",
         "name": "master_timeout",
-        "description": "Period to wait for a connection to the master node.",
+        "description": "The period to wait for a connection to the master node.\nIf the master node is not available before the timeout expires, the request fails and returns an error.\nTo indicated that the request should never timeout, you can set it to `-1`.",
         "deprecated": false,
         "schema": {
           "$ref": "#/components/schemas/_types:Duration"
@@ -58396,7 +58396,7 @@
       "cat.component_templates#name": {
         "in": "path",
         "name": "name",
-        "description": "The name of the component template. Accepts wildcard expressions. If omitted, all component templates are returned.",
+        "description": "The name of the component template.\nIt accepts wildcard expressions.\nIf it is omitted, all component templates are returned.",
         "required": true,
         "deprecated": false,
         "schema": {
@@ -58417,7 +58417,7 @@
       "cat.component_templates#master_timeout": {
         "in": "query",
         "name": "master_timeout",
-        "description": "Period to wait for a connection to the master node.",
+        "description": "The period to wait for a connection to the master node.",
         "deprecated": false,
         "schema": {
           "$ref": "#/components/schemas/_types:Duration"
@@ -58427,7 +58427,7 @@
       "cat.count#index": {
         "in": "path",
         "name": "index",
-        "description": "Comma-separated list of data streams, indices, and aliases used to limit the request.\nSupports wildcards (`*`). To target all data streams and indices, omit this parameter or use `*` or `_all`.",
+        "description": "A comma-separated list of data streams, indices, and aliases used to limit the request.\nIt supports wildcards (`*`).\nTo target all data streams and indices, omit this parameter or use `*` or `_all`.",
         "required": true,
         "deprecated": false,
         "schema": {
diff --git a/output/schema/schema.json b/output/schema/schema.json
index 05e0da9b54..b44cb8dd8f 100644
--- a/output/schema/schema.json
+++ b/output/schema/schema.json
@@ -538,7 +538,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get aliases.\nRetrieves the cluster’s index aliases, including filter and routing information.\nThe API does not return data stream aliases.\n\nCAT APIs are only intended for human consumption using the command line or the Kibana console. They are not intended for use by applications. For application consumption, use the aliases API.",
+      "description": "Get aliases.\n\nGet the cluster's index aliases, including filter and routing information.\nThis API does not return data stream aliases.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or the Kibana console. They are not intended for use by applications. For application consumption, use the aliases API.",
       "docId": "cat-alias",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-alias.html",
       "name": "cat.aliases",
@@ -585,7 +585,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get shard allocation information.\nGet a snapshot of the number of shards allocated to each data node and their disk space.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications.",
+      "description": "Get shard allocation information.\n\nGet a snapshot of the number of shards allocated to each data node and their disk space.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications.",
       "docId": "cat-allocation",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-allocation.html",
       "name": "cat.allocation",
@@ -633,8 +633,9 @@
           "stability": "stable"
         }
       },
-      "description": "Get component templates.\nReturns information about component templates in a cluster.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the get component template API.",
-      "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/cat-component-templates.html",
+      "description": "Get component templates.\n\nGet information about component templates in a cluster.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the get component template API.",
+      "docId": "cat-component-templates",
+      "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-component-templates.html",
       "name": "cat.component_templates",
       "privileges": {
         "cluster": [
@@ -679,7 +680,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get a document count.\nProvides quick access to a document count for a data stream, an index, or an entire cluster.\nThe document count only includes live documents, not deleted documents which have not yet been removed by the merge process.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the count API.",
+      "description": "Get a document count.\n\nGet quick access to a document count for a data stream, an index, or an entire cluster.\nThe document count only includes live documents, not deleted documents which have not yet been removed by the merge process.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the count API.",
       "docId": "cat-count",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-count.html",
       "name": "cat.count",
@@ -726,7 +727,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get field data cache information.\nGet the amount of heap memory currently used by the field data cache on every data node in the cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the nodes stats API.",
+      "description": "Get field data cache information.\n\nGet the amount of heap memory currently used by the field data cache on every data node in the cluster.\n\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the nodes stats API.",
       "docId": "cat-fielddata",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-fielddata.html",
       "name": "cat.fielddata",
@@ -773,7 +774,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get the cluster health status.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the cluster health API.\nThis API is often used to check malfunctioning clusters.\nTo help you track cluster health alongside log files and alerting systems, the API returns timestamps in two formats:\n`HH:MM:SS`, which is human-readable but includes no date information;\n`Unix epoch time`, which is machine-sortable and includes date information.\nThe latter format is useful for cluster recoveries that take multiple days.\nYou can use the cat health API to verify cluster health across multiple nodes.\nYou also can use the API to track the recovery of a large cluster over a longer period of time.",
+      "description": "Get the cluster health status.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the cluster health API.\nThis API is often used to check malfunctioning clusters.\nTo help you track cluster health alongside log files and alerting systems, the API returns timestamps in two formats:\n`HH:MM:SS`, which is human-readable but includes no date information;\n`Unix epoch time`, which is machine-sortable and includes date information.\nThe latter format is useful for cluster recoveries that take multiple days.\nYou can use the cat health API to verify cluster health across multiple nodes.\nYou also can use the API to track the recovery of a large cluster over a longer period of time.",
       "docId": "cat-health",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-health.html",
       "name": "cat.health",
@@ -814,7 +815,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get CAT help.\nReturns help for the CAT APIs.",
+      "description": "Get CAT help.\n\nGet help for the CAT APIs.",
       "docId": "cat",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat.html",
       "name": "cat.help",
@@ -849,7 +850,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get index information.\nReturns high-level information about indices in a cluster, including backing indices for data streams.\n\nUse this request to get the following information for each index in a cluster:\n- shard count\n- document count\n- deleted document count\n- primary store size\n- total store size of all shards, including shard replicas\n\nThese metrics are retrieved directly from Lucene, which Elasticsearch uses internally to power indexing and search. As a result, all document counts include hidden nested documents.\nTo get an accurate count of Elasticsearch documents, use the cat count or count APIs.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use an index endpoint.",
+      "description": "Get index information.\n\nGet high-level information about indices in a cluster, including backing indices for data streams.\n\nUse this request to get the following information for each index in a cluster:\n- shard count\n- document count\n- deleted document count\n- primary store size\n- total store size of all shards, including shard replicas\n\nThese metrics are retrieved directly from Lucene, which Elasticsearch uses internally to power indexing and search. As a result, all document counts include hidden nested documents.\nTo get an accurate count of Elasticsearch documents, use the cat count or count APIs.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use an index endpoint.",
       "docId": "cat-indices",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-indices.html",
       "name": "cat.indices",
@@ -899,7 +900,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get master node information.\nGet information about the master node, including the ID, bound IP address, and name.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.",
+      "description": "Get master node information.\n\nGet information about the master node, including the ID, bound IP address, and name.\n\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.",
       "docId": "cat-master",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-master.html",
       "name": "cat.master",
@@ -941,7 +942,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get data frame analytics jobs.\nReturns configuration and usage information about data frame analytics jobs.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get data frame analytics jobs statistics API.",
+      "description": "Get data frame analytics jobs.\n\nGet configuration and usage information about data frame analytics jobs.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get data frame analytics jobs statistics API.",
       "docId": "cat-dfanalytics",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-dfanalytics.html",
       "name": "cat.ml_data_frame_analytics",
@@ -989,7 +990,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get datafeeds.\nReturns configuration and usage information about datafeeds.\nThis API returns a maximum of 10,000 datafeeds.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`, `monitor`, `manage_ml`, or `manage`\ncluster privileges to use this API.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get datafeed statistics API.",
+      "description": "Get datafeeds.\n\nGet configuration and usage information about datafeeds.\nThis API returns a maximum of 10,000 datafeeds.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`, `monitor`, `manage_ml`, or `manage`\ncluster privileges to use this API.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get datafeed statistics API.",
       "docId": "cat-datafeeds",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-datafeeds.html",
       "name": "cat.ml_datafeeds",
@@ -1037,7 +1038,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get anomaly detection jobs.\nReturns configuration and usage information for anomaly detection jobs.\nThis API returns a maximum of 10,000 jobs.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`,\n`monitor`, `manage_ml`, or `manage` cluster privileges to use this API.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get anomaly detection job statistics API.",
+      "description": "Get anomaly detection jobs.\n\nGet configuration and usage information for anomaly detection jobs.\nThis API returns a maximum of 10,000 jobs.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`,\n`monitor`, `manage_ml`, or `manage` cluster privileges to use this API.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get anomaly detection job statistics API.",
       "docId": "cat-anomaly-detectors",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-anomaly-detectors.html",
       "name": "cat.ml_jobs",
@@ -1085,7 +1086,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get trained models.\nReturns configuration and usage information about inference trained models.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get trained models statistics API.",
+      "description": "Get trained models.\n\nGet configuration and usage information about inference trained models.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get trained models statistics API.",
       "docId": "cat-trained-model",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-trained-model.html",
       "name": "cat.ml_trained_models",
@@ -1132,7 +1133,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get node attribute information.\nGet information about custom node attributes.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.",
+      "description": "Get node attribute information.\n\nGet information about custom node attributes.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.",
       "docId": "cat-nodeattrs",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-nodeattrs.html",
       "name": "cat.nodeattrs",
@@ -1173,7 +1174,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get node information.\nGet information about the nodes in a cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.",
+      "description": "Get node information.\n\nGet information about the nodes in a cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.",
       "docId": "cat-nodes",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-nodes.html",
       "name": "cat.nodes",
@@ -1214,7 +1215,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get pending task information.\nGet information about cluster-level changes that have not yet taken effect.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the pending cluster tasks API.",
+      "description": "Get pending task information.\n\nGet information about cluster-level changes that have not yet taken effect.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the pending cluster tasks API.",
       "docId": "cat-pending-tasks",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-pending-tasks.html",
       "name": "cat.pending_tasks",
@@ -1255,7 +1256,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get plugin information.\nGet a list of plugins running on each node of a cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.",
+      "description": "Get plugin information.\n\nGet a list of plugins running on each node of a cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.",
       "docId": "cat-plugins",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-plugins.html",
       "name": "cat.plugins",
@@ -1296,7 +1297,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get shard recovery information.\nGet information about ongoing and completed shard recoveries.\nShard recovery is the process of initializing a shard copy, such as restoring a primary shard from a snapshot or syncing a replica shard from a primary shard. When a shard recovery completes, the recovered shard is available for search and indexing.\nFor data streams, the API returns information about the stream’s backing indices.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the index recovery API.",
+      "description": "Get shard recovery information.\n\nGet information about ongoing and completed shard recoveries.\nShard recovery is the process of initializing a shard copy, such as restoring a primary shard from a snapshot or syncing a replica shard from a primary shard. When a shard recovery completes, the recovered shard is available for search and indexing.\nFor data streams, the API returns information about the stream’s backing indices.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the index recovery API.",
       "docId": "cat-recovery",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-recovery.html",
       "name": "cat.recovery",
@@ -1347,7 +1348,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get snapshot repository information.\nGet a list of snapshot repositories for a cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the get snapshot repository API.",
+      "description": "Get snapshot repository information.\n\nGet a list of snapshot repositories for a cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the get snapshot repository API.",
       "docId": "cat-repositories",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-repositories.html",
       "name": "cat.repositories",
@@ -1388,7 +1389,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get segment information.\nGet low-level information about the Lucene segments in index shards.\nFor data streams, the API returns information about the backing indices.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the index segments API.",
+      "description": "Get segment information.\n\nGet low-level information about the Lucene segments in index shards.\nFor data streams, the API returns information about the backing indices.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the index segments API.",
       "docId": "cat-segments",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-segments.html",
       "name": "cat.segments",
@@ -1438,7 +1439,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get shard information.\nGet information about the shards in a cluster.\nFor data streams, the API returns information about the backing indices.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications.",
+      "description": "Get shard information.\n\nGet information about the shards in a cluster.\nFor data streams, the API returns information about the backing indices.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications.",
       "docId": "cat-shards",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-shards.html",
       "name": "cat.shards",
@@ -1489,7 +1490,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get snapshot information\nGet information about the snapshots stored in one or more repositories.\nA snapshot is a backup of an index or running Elasticsearch cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the get snapshot API.",
+      "description": "Get snapshot information.\n\nGet information about the snapshots stored in one or more repositories.\nA snapshot is a backup of an index or running Elasticsearch cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the get snapshot API.",
       "docId": "cat-snapshots",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-snapshots.html",
       "name": "cat.snapshots",
@@ -1537,7 +1538,7 @@
           "stability": "experimental"
         }
       },
-      "description": "Get task information.\nGet information about tasks currently running in the cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the task management API.",
+      "description": "Get task information.\n\nGet information about tasks currently running in the cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the task management API.",
       "docId": "tasks",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/tasks.html",
       "name": "cat.tasks",
@@ -1579,7 +1580,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get index template information.\nGet information about the index templates in a cluster.\nYou can use index templates to apply index settings and field mappings to new indices at creation.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the get index template API.",
+      "description": "Get index template information.\n\nGet information about the index templates in a cluster.\nYou can use index templates to apply index settings and field mappings to new indices at creation.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the get index template API.",
       "docId": "cat-templates",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-templates.html",
       "name": "cat.templates",
@@ -1626,7 +1627,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get thread pool statistics.\nGet thread pool statistics for each node in a cluster.\nReturned information includes all built-in thread pools and custom thread pools.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.",
+      "description": "Get thread pool statistics.\n\nGet thread pool statistics for each node in a cluster.\nReturned information includes all built-in thread pools and custom thread pools.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.",
       "docId": "cat-thread-pool",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-thread-pool.html",
       "name": "cat.thread_pool",
@@ -1674,7 +1675,7 @@
           "stability": "stable"
         }
       },
-      "description": "Get transform information.\nGet configuration and usage information about transforms.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get transform statistics API.",
+      "description": "Get transform information.\n\nGet configuration and usage information about transforms.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get transform statistics API.",
       "docId": "cat-transforms",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-transforms.html",
       "name": "cat.transforms",
@@ -45941,7 +45942,7 @@
           "name": "closed"
         },
         {
-          "description": "Match hidden data streams and hidden indices. Must be combined with open, closed, or both.",
+          "description": "Match hidden data streams and hidden indices. Must be combined with `open`, `closed`, or `both`.",
           "name": "hidden"
         },
         {
@@ -92591,7 +92592,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get aliases.\nRetrieves the cluster’s index aliases, including filter and routing information.\nThe API does not return data stream aliases.\n\nCAT APIs are only intended for human consumption using the command line or the Kibana console. They are not intended for use by applications. For application consumption, use the aliases API.",
+      "description": "Get aliases.\n\nGet the cluster's index aliases, including filter and routing information.\nThis API does not return data stream aliases.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or the Kibana console. They are not intended for use by applications. For application consumption, use the aliases API.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -92618,7 +92619,7 @@
       ],
       "query": [
         {
-          "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.",
+          "description": "The type of index that wildcard patterns can match.\nIf the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.\nIt supports comma-separated values, such as `open,hidden`.",
           "name": "expand_wildcards",
           "required": false,
           "type": {
@@ -92630,7 +92631,7 @@
           }
         },
         {
-          "description": "Period to wait for a connection to the master node.",
+          "description": "The period to wait for a connection to the master node.\nIf the master node is not available before the timeout expires, the request fails and returns an error.\nTo indicated that the request should never timeout, you can set it to `-1`.",
           "name": "master_timeout",
           "required": false,
           "serverDefault": "30s",
@@ -92643,7 +92644,7 @@
           }
         }
       ],
-      "specLocation": "cat/aliases/CatAliasesRequest.ts#L24-L59"
+      "specLocation": "cat/aliases/CatAliasesRequest.ts#L24-L67"
     },
     {
       "kind": "response",
@@ -93024,7 +93025,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get shard allocation information.\nGet a snapshot of the number of shards allocated to each data node and their disk space.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications.",
+      "description": "Get shard allocation information.\n\nGet a snapshot of the number of shards allocated to each data node and their disk space.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -93037,7 +93038,7 @@
       },
       "path": [
         {
-          "description": "Comma-separated list of node identifiers or names used to limit the returned information.",
+          "description": "A comma-separated list of node identifiers or names used to limit the returned information.",
           "name": "node_id",
           "required": false,
           "type": {
@@ -93089,7 +93090,7 @@
           }
         }
       ],
-      "specLocation": "cat/allocation/CatAllocationRequest.ts#L24-L66"
+      "specLocation": "cat/allocation/CatAllocationRequest.ts#L24-L68"
     },
     {
       "kind": "response",
@@ -93220,7 +93221,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get component templates.\nReturns information about component templates in a cluster.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the get component template API.",
+      "description": "Get component templates.\n\nGet information about component templates in a cluster.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the get component template API.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -93233,7 +93234,7 @@
       },
       "path": [
         {
-          "description": "The name of the component template. Accepts wildcard expressions. If omitted, all component templates are returned.",
+          "description": "The name of the component template.\nIt accepts wildcard expressions.\nIf it is omitted, all component templates are returned.",
           "name": "name",
           "required": false,
           "type": {
@@ -93260,7 +93261,7 @@
           }
         },
         {
-          "description": "Period to wait for a connection to the master node.",
+          "description": "The period to wait for a connection to the master node.",
           "name": "master_timeout",
           "required": false,
           "serverDefault": "30s",
@@ -93273,7 +93274,7 @@
           }
         }
       ],
-      "specLocation": "cat/component_templates/CatComponentTemplatesRequest.ts#L23-L65"
+      "specLocation": "cat/component_templates/CatComponentTemplatesRequest.ts#L23-L70"
     },
     {
       "kind": "response",
@@ -93383,7 +93384,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get a document count.\nProvides quick access to a document count for a data stream, an index, or an entire cluster.\nThe document count only includes live documents, not deleted documents which have not yet been removed by the merge process.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the count API.",
+      "description": "Get a document count.\n\nGet quick access to a document count for a data stream, an index, or an entire cluster.\nThe document count only includes live documents, not deleted documents which have not yet been removed by the merge process.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the count API.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -93396,7 +93397,7 @@
       },
       "path": [
         {
-          "description": "Comma-separated list of data streams, indices, and aliases used to limit the request.\nSupports wildcards (`*`). To target all data streams and indices, omit this parameter or use `*` or `_all`.",
+          "description": "A comma-separated list of data streams, indices, and aliases used to limit the request.\nIt supports wildcards (`*`).\nTo target all data streams and indices, omit this parameter or use `*` or `_all`.",
           "name": "index",
           "required": false,
           "type": {
@@ -93409,7 +93410,7 @@
         }
       ],
       "query": [],
-      "specLocation": "cat/count/CatCountRequest.ts#L23-L54"
+      "specLocation": "cat/count/CatCountRequest.ts#L23-L56"
     },
     {
       "kind": "response",
@@ -93532,7 +93533,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get field data cache information.\nGet the amount of heap memory currently used by the field data cache on every data node in the cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the nodes stats API.",
+      "description": "Get field data cache information.\n\nGet the amount of heap memory currently used by the field data cache on every data node in the cluster.\n\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the nodes stats API.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -93583,7 +93584,7 @@
           }
         }
       ],
-      "specLocation": "cat/fielddata/CatFielddataRequest.ts#L23-L58"
+      "specLocation": "cat/fielddata/CatFielddataRequest.ts#L23-L60"
     },
     {
       "kind": "response",
@@ -93888,7 +93889,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get the cluster health status.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the cluster health API.\nThis API is often used to check malfunctioning clusters.\nTo help you track cluster health alongside log files and alerting systems, the API returns timestamps in two formats:\n`HH:MM:SS`, which is human-readable but includes no date information;\n`Unix epoch time`, which is machine-sortable and includes date information.\nThe latter format is useful for cluster recoveries that take multiple days.\nYou can use the cat health API to verify cluster health across multiple nodes.\nYou also can use the API to track the recovery of a large cluster over a longer period of time.",
+      "description": "Get the cluster health status.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use the cluster health API.\nThis API is often used to check malfunctioning clusters.\nTo help you track cluster health alongside log files and alerting systems, the API returns timestamps in two formats:\n`HH:MM:SS`, which is human-readable but includes no date information;\n`Unix epoch time`, which is machine-sortable and includes date information.\nThe latter format is useful for cluster recoveries that take multiple days.\nYou can use the cat health API to verify cluster health across multiple nodes.\nYou also can use the API to track the recovery of a large cluster over a longer period of time.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -93927,7 +93928,7 @@
           }
         }
       ],
-      "specLocation": "cat/health/CatHealthRequest.ts#L23-L58"
+      "specLocation": "cat/health/CatHealthRequest.ts#L23-L59"
     },
     {
       "kind": "response",
@@ -93955,14 +93956,14 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get CAT help.\nReturns help for the CAT APIs.",
+      "description": "Get CAT help.\n\nGet help for the CAT APIs.",
       "name": {
         "name": "Request",
         "namespace": "cat.help"
       },
       "path": [],
       "query": [],
-      "specLocation": "cat/help/CatHelpRequest.ts#L20-L35"
+      "specLocation": "cat/help/CatHelpRequest.ts#L20-L36"
     },
     {
       "kind": "response",
@@ -96067,7 +96068,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get index information.\nReturns high-level information about indices in a cluster, including backing indices for data streams.\n\nUse this request to get the following information for each index in a cluster:\n- shard count\n- document count\n- deleted document count\n- primary store size\n- total store size of all shards, including shard replicas\n\nThese metrics are retrieved directly from Lucene, which Elasticsearch uses internally to power indexing and search. As a result, all document counts include hidden nested documents.\nTo get an accurate count of Elasticsearch documents, use the cat count or count APIs.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use an index endpoint.",
+      "description": "Get index information.\n\nGet high-level information about indices in a cluster, including backing indices for data streams.\n\nUse this request to get the following information for each index in a cluster:\n- shard count\n- document count\n- deleted document count\n- primary store size\n- total store size of all shards, including shard replicas\n\nThese metrics are retrieved directly from Lucene, which Elasticsearch uses internally to power indexing and search. As a result, all document counts include hidden nested documents.\nTo get an accurate count of Elasticsearch documents, use the cat count or count APIs.\n\nCAT APIs are only intended for human consumption using the command line or Kibana console.\nThey are not intended for use by applications. For application consumption, use an index endpoint.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -96181,7 +96182,7 @@
           }
         }
       ],
-      "specLocation": "cat/indices/CatIndicesRequest.ts#L24-L92"
+      "specLocation": "cat/indices/CatIndicesRequest.ts#L24-L93"
     },
     {
       "kind": "response",
@@ -96277,7 +96278,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get master node information.\nGet information about the master node, including the ID, bound IP address, and name.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.",
+      "description": "Get master node information.\n\nGet information about the master node, including the ID, bound IP address, and name.\n\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -96317,7 +96318,7 @@
           }
         }
       ],
-      "specLocation": "cat/master/CatMasterRequest.ts#L23-L55"
+      "specLocation": "cat/master/CatMasterRequest.ts#L23-L57"
     },
     {
       "kind": "response",
@@ -96606,7 +96607,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get data frame analytics jobs.\nReturns configuration and usage information about data frame analytics jobs.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get data frame analytics jobs statistics API.",
+      "description": "Get data frame analytics jobs.\n\nGet configuration and usage information about data frame analytics jobs.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get data frame analytics jobs statistics API.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -96694,7 +96695,7 @@
           }
         }
       ],
-      "specLocation": "cat/ml_data_frame_analytics/CatDataFrameAnalyticsRequest.ts#L24-L69"
+      "specLocation": "cat/ml_data_frame_analytics/CatDataFrameAnalyticsRequest.ts#L24-L70"
     },
     {
       "kind": "response",
@@ -96922,7 +96923,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get datafeeds.\nReturns configuration and usage information about datafeeds.\nThis API returns a maximum of 10,000 datafeeds.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`, `monitor`, `manage_ml`, or `manage`\ncluster privileges to use this API.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get datafeed statistics API.",
+      "description": "Get datafeeds.\n\nGet configuration and usage information about datafeeds.\nThis API returns a maximum of 10,000 datafeeds.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`, `monitor`, `manage_ml`, or `manage`\ncluster privileges to use this API.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get datafeed statistics API.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -96999,7 +97000,7 @@
           }
         }
       ],
-      "specLocation": "cat/ml_datafeeds/CatDatafeedsRequest.ts#L24-L84"
+      "specLocation": "cat/ml_datafeeds/CatDatafeedsRequest.ts#L24-L85"
     },
     {
       "kind": "response",
@@ -97993,7 +97994,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get anomaly detection jobs.\nReturns configuration and usage information for anomaly detection jobs.\nThis API returns a maximum of 10,000 jobs.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`,\n`monitor`, `manage_ml`, or `manage` cluster privileges to use this API.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get anomaly detection job statistics API.",
+      "description": "Get anomaly detection jobs.\n\nGet configuration and usage information for anomaly detection jobs.\nThis API returns a maximum of 10,000 jobs.\nIf the Elasticsearch security features are enabled, you must have `monitor_ml`,\n`monitor`, `manage_ml`, or `manage` cluster privileges to use this API.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get anomaly detection job statistics API.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -98082,7 +98083,7 @@
           }
         }
       ],
-      "specLocation": "cat/ml_jobs/CatJobsRequest.ts#L24-L88"
+      "specLocation": "cat/ml_jobs/CatJobsRequest.ts#L24-L89"
     },
     {
       "kind": "response",
@@ -98114,7 +98115,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get trained models.\nReturns configuration and usage information about inference trained models.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get trained models statistics API.",
+      "description": "Get trained models.\n\nGet configuration and usage information about inference trained models.\n\nIMPORTANT: CAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get trained models statistics API.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -98226,7 +98227,7 @@
           }
         }
       ],
-      "specLocation": "cat/ml_trained_models/CatTrainedModelsRequest.ts#L25-L79"
+      "specLocation": "cat/ml_trained_models/CatTrainedModelsRequest.ts#L25-L80"
     },
     {
       "kind": "response",
@@ -98661,7 +98662,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get node attribute information.\nGet information about custom node attributes.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.",
+      "description": "Get node attribute information.\n\nGet information about custom node attributes.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -98701,7 +98702,7 @@
           }
         }
       ],
-      "specLocation": "cat/nodeattrs/CatNodeAttributesRequest.ts#L23-L55"
+      "specLocation": "cat/nodeattrs/CatNodeAttributesRequest.ts#L23-L56"
     },
     {
       "kind": "response",
@@ -100248,7 +100249,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get node information.\nGet information about the nodes in a cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.",
+      "description": "Get node information.\n\nGet information about the nodes in a cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -100337,7 +100338,7 @@
           }
         }
       ],
-      "specLocation": "cat/nodes/CatNodesRequest.ts#L24-L66"
+      "specLocation": "cat/nodes/CatNodesRequest.ts#L24-L67"
     },
     {
       "kind": "response",
@@ -100439,7 +100440,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get pending task information.\nGet information about cluster-level changes that have not yet taken effect.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the pending cluster tasks API.",
+      "description": "Get pending task information.\n\nGet information about cluster-level changes that have not yet taken effect.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the pending cluster tasks API.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -100491,7 +100492,7 @@
           }
         }
       ],
-      "specLocation": "cat/pending_tasks/CatPendingTasksRequest.ts#L23-L59"
+      "specLocation": "cat/pending_tasks/CatPendingTasksRequest.ts#L23-L60"
     },
     {
       "kind": "response",
@@ -100620,7 +100621,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get plugin information.\nGet a list of plugins running on each node of a cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.",
+      "description": "Get plugin information.\n\nGet a list of plugins running on each node of a cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -100673,7 +100674,7 @@
           }
         }
       ],
-      "specLocation": "cat/plugins/CatPluginsRequest.ts#L23-L60"
+      "specLocation": "cat/plugins/CatPluginsRequest.ts#L23-L61"
     },
     {
       "kind": "response",
@@ -101126,7 +101127,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get shard recovery information.\nGet information about ongoing and completed shard recoveries.\nShard recovery is the process of initializing a shard copy, such as restoring a primary shard from a snapshot or syncing a replica shard from a primary shard. When a shard recovery completes, the recovered shard is available for search and indexing.\nFor data streams, the API returns information about the stream’s backing indices.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the index recovery API.",
+      "description": "Get shard recovery information.\n\nGet information about ongoing and completed shard recoveries.\nShard recovery is the process of initializing a shard copy, such as restoring a primary shard from a snapshot or syncing a replica shard from a primary shard. When a shard recovery completes, the recovered shard is available for search and indexing.\nFor data streams, the API returns information about the stream’s backing indices.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the index recovery API.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -101203,7 +101204,7 @@
           }
         }
       ],
-      "specLocation": "cat/recovery/CatRecoveryRequest.ts#L24-L75"
+      "specLocation": "cat/recovery/CatRecoveryRequest.ts#L24-L76"
     },
     {
       "kind": "response",
@@ -101275,7 +101276,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get snapshot repository information.\nGet a list of snapshot repositories for a cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the get snapshot repository API.",
+      "description": "Get snapshot repository information.\n\nGet a list of snapshot repositories for a cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the get snapshot repository API.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -101315,7 +101316,7 @@
           }
         }
       ],
-      "specLocation": "cat/repositories/CatRepositoriesRequest.ts#L23-L55"
+      "specLocation": "cat/repositories/CatRepositoriesRequest.ts#L23-L56"
     },
     {
       "kind": "response",
@@ -101347,7 +101348,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get segment information.\nGet low-level information about the Lucene segments in index shards.\nFor data streams, the API returns information about the backing indices.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the index segments API.",
+      "description": "Get segment information.\n\nGet low-level information about the Lucene segments in index shards.\nFor data streams, the API returns information about the backing indices.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the index segments API.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -101412,7 +101413,7 @@
           }
         }
       ],
-      "specLocation": "cat/segments/CatSegmentsRequest.ts#L24-L74"
+      "specLocation": "cat/segments/CatSegmentsRequest.ts#L24-L75"
     },
     {
       "kind": "response",
@@ -101684,7 +101685,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get shard information.\nGet information about the shards in a cluster.\nFor data streams, the API returns information about the backing indices.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications.",
+      "description": "Get shard information.\n\nGet information about the shards in a cluster.\nFor data streams, the API returns information about the backing indices.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -101748,7 +101749,7 @@
           }
         }
       ],
-      "specLocation": "cat/shards/CatShardsRequest.ts#L24-L70"
+      "specLocation": "cat/shards/CatShardsRequest.ts#L24-L71"
     },
     {
       "kind": "response",
@@ -103061,7 +103062,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get snapshot information\nGet information about the snapshots stored in one or more repositories.\nA snapshot is a backup of an index or running Elasticsearch cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the get snapshot API.",
+      "description": "Get snapshot information.\n\nGet information about the snapshots stored in one or more repositories.\nA snapshot is a backup of an index or running Elasticsearch cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the get snapshot API.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -103126,7 +103127,7 @@
           }
         }
       ],
-      "specLocation": "cat/snapshots/CatSnapshotsRequest.ts#L24-L71"
+      "specLocation": "cat/snapshots/CatSnapshotsRequest.ts#L24-L72"
     },
     {
       "kind": "response",
@@ -103404,7 +103405,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get task information.\nGet information about tasks currently running in the cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the task management API.",
+      "description": "Get task information.\n\nGet information about tasks currently running in the cluster.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the task management API.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -103511,7 +103512,7 @@
           }
         }
       ],
-      "specLocation": "cat/tasks/CatTasksRequest.ts#L23-L70"
+      "specLocation": "cat/tasks/CatTasksRequest.ts#L23-L71"
     },
     {
       "kind": "response",
@@ -103789,7 +103790,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get index template information.\nGet information about the index templates in a cluster.\nYou can use index templates to apply index settings and field mappings to new indices at creation.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the get index template API.",
+      "description": "Get index template information.\n\nGet information about the index templates in a cluster.\nYou can use index templates to apply index settings and field mappings to new indices at creation.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the get index template API.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -103842,7 +103843,7 @@
           }
         }
       ],
-      "specLocation": "cat/templates/CatTemplatesRequest.ts#L24-L68"
+      "specLocation": "cat/templates/CatTemplatesRequest.ts#L24-L69"
     },
     {
       "kind": "response",
@@ -103972,7 +103973,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get thread pool statistics.\nGet thread pool statistics for each node in a cluster.\nReturned information includes all built-in thread pools and custom thread pools.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.",
+      "description": "Get thread pool statistics.\n\nGet thread pool statistics for each node in a cluster.\nReturned information includes all built-in thread pools and custom thread pools.\nIMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -104037,7 +104038,7 @@
           }
         }
       ],
-      "specLocation": "cat/thread_pool/CatThreadPoolRequest.ts#L24-L72"
+      "specLocation": "cat/thread_pool/CatThreadPoolRequest.ts#L24-L73"
     },
     {
       "kind": "response",
@@ -104427,7 +104428,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Get transform information.\nGet configuration and usage information about transforms.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get transform statistics API.",
+      "description": "Get transform information.\n\nGet configuration and usage information about transforms.\n\nCAT APIs are only intended for human consumption using the Kibana\nconsole or command line. They are not intended for use by applications. For\napplication consumption, use the get transform statistics API.",
       "inherits": {
         "type": {
           "name": "CatRequestBase",
@@ -104530,7 +104531,7 @@
           }
         }
       ],
-      "specLocation": "cat/transforms/CatTransformsRequest.ts#L25-L88"
+      "specLocation": "cat/transforms/CatTransformsRequest.ts#L25-L89"
     },
     {
       "kind": "response",
diff --git a/specification/_doc_ids/table.csv b/specification/_doc_ids/table.csv
index 530cb5856a..03fb5e1977 100644
--- a/specification/_doc_ids/table.csv
+++ b/specification/_doc_ids/table.csv
@@ -28,6 +28,7 @@ calendar-and-fixed-intervals,https://www.elastic.co/guide/en/elasticsearch/refer
 cat-alias,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-alias.html
 cat-allocation,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-allocation.html
 cat-anomaly-detectors,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-anomaly-detectors.html
+cat-component-templates,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-component-templates.html
 cat-count,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-count.html
 cat-datafeeds,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-datafeeds.html
 cat-dfanalytics,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cat-dfanalytics.html
diff --git a/specification/_types/common.ts b/specification/_types/common.ts
index a29ec7f8ae..1e822cf7f4 100644
--- a/specification/_types/common.ts
+++ b/specification/_types/common.ts
@@ -212,7 +212,7 @@ export enum ExpandWildcard {
   open,
   /** Match closed, non-hidden indices. Also matches any non-hidden data stream. Data streams cannot be closed. */
   closed,
-  /** Match hidden data streams and hidden indices. Must be combined with open, closed, or both. */
+  /** Match hidden data streams and hidden indices. Must be combined with `open`, `closed`, or `both`. */
   hidden,
   /** Wildcard expressions are not accepted. */
   none
diff --git a/specification/cat/aliases/CatAliasesRequest.ts b/specification/cat/aliases/CatAliasesRequest.ts
index 1fb3a1f830..c03867dab4 100644
--- a/specification/cat/aliases/CatAliasesRequest.ts
+++ b/specification/cat/aliases/CatAliasesRequest.ts
@@ -23,10 +23,11 @@ import { Duration } from '@_types/Time'
 
 /**
  * Get aliases.
- * Retrieves the cluster’s index aliases, including filter and routing information.
- * The API does not return data stream aliases.
  *
- * CAT APIs are only intended for human consumption using the command line or the Kibana console. They are not intended for use by applications. For application consumption, use the aliases API.
+ * Get the cluster's index aliases, including filter and routing information.
+ * This API does not return data stream aliases.
+ *
+ * IMPORTANT: CAT APIs are only intended for human consumption using the command line or the Kibana console. They are not intended for use by applications. For application consumption, use the aliases API.
  * @rest_spec_name cat.aliases
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public
@@ -49,9 +50,16 @@ export interface Request extends CatRequestBase {
     name?: Names
   }
   query_parameters: {
+    /**
+     * The type of index that wildcard patterns can match.
+     * If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.
+     * It supports comma-separated values, such as `open,hidden`.
+     */
     expand_wildcards?: ExpandWildcards
     /**
-     * Period to wait for a connection to the master node.
+     * The period to wait for a connection to the master node.
+     * If the master node is not available before the timeout expires, the request fails and returns an error.
+     * To indicated that the request should never timeout, you can set it to `-1`.
      * @server_default 30s
      */
     master_timeout?: Duration
diff --git a/specification/cat/aliases/examples/200_response/CatAliasesResponseExample1.yaml b/specification/cat/aliases/examples/200_response/CatAliasesResponseExample1.yaml
new file mode 100644
index 0000000000..f26b38c391
--- /dev/null
+++ b/specification/cat/aliases/examples/200_response/CatAliasesResponseExample1.yaml
@@ -0,0 +1,12 @@
+# summary:
+description: >
+  A successful response from `GET _cat/aliases?v=true`.
+  This response shows that `alias2` has configured a filter and `alias3` and `alias4` have routing configurations.
+# type: response
+# response_code: 200
+value: |-
+  alias  index filter routing.index routing.search is_write_index
+  alias1 test1 -      -            -              -
+  alias2 test1 *      -            -              -
+  alias3 test1 -      1            1              -
+  alias4 test1 -      2            1,2            -
diff --git a/specification/cat/allocation/CatAllocationRequest.ts b/specification/cat/allocation/CatAllocationRequest.ts
index d92f620b41..0f0cf114b9 100644
--- a/specification/cat/allocation/CatAllocationRequest.ts
+++ b/specification/cat/allocation/CatAllocationRequest.ts
@@ -23,8 +23,10 @@ import { Duration } from '@_types/Time'
 
 /**
  * Get shard allocation information.
+ *
  * Get a snapshot of the number of shards allocated to each data node and their disk space.
- * IMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications.
+ *
+ * IMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications.
  * @rest_spec_name cat.allocation
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=private
@@ -43,7 +45,7 @@ export interface Request extends CatRequestBase {
     }
   ]
   path_parts: {
-    /** Comma-separated list of node identifiers or names used to limit the returned information. */
+    /** A comma-separated list of node identifiers or names used to limit the returned information. */
     node_id?: NodeIds
   }
   query_parameters: {
diff --git a/specification/cat/allocation/examples/200_response/CatAllocationResponseExample1.yaml b/specification/cat/allocation/examples/200_response/CatAllocationResponseExample1.yaml
new file mode 100644
index 0000000000..679eb5ec63
--- /dev/null
+++ b/specification/cat/allocation/examples/200_response/CatAllocationResponseExample1.yaml
@@ -0,0 +1,9 @@
+# summary:
+description: >
+  A successful response from `GET /_cat/allocation?v=true`.
+  It shows a single shard is allocated to the one node available.
+# type: response
+# response_code: 200
+value: |-
+  shards shards.undesired write_load.forecast disk.indices.forecast disk.indices disk.used disk.avail disk.total disk.percent host      ip        node    node.role
+       1                0                 0.0                  260b         260b    47.3gb     43.4gb    100.7gb           46 127.0.0.1 127.0.0.1 CSUXak2 himrst
diff --git a/specification/cat/component_templates/CatComponentTemplatesRequest.ts b/specification/cat/component_templates/CatComponentTemplatesRequest.ts
index 045ad055cc..824db3bf32 100644
--- a/specification/cat/component_templates/CatComponentTemplatesRequest.ts
+++ b/specification/cat/component_templates/CatComponentTemplatesRequest.ts
@@ -22,15 +22,17 @@ import { Duration } from '@_types/Time'
 
 /**
  * Get component templates.
- * Returns information about component templates in a cluster.
+ *
+ * Get information about component templates in a cluster.
  * Component templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.
  *
- * CAT APIs are only intended for human consumption using the command line or Kibana console.
+ * IMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console.
  * They are not intended for use by applications. For application consumption, use the get component template API.
  * @rest_spec_name cat.component_templates
  * @availability stack since=5.1.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges monitor
+ * @doc_id cat-component-templates
  */
 export interface Request extends CatRequestBase {
   urls: [
@@ -44,7 +46,10 @@ export interface Request extends CatRequestBase {
     }
   ]
   path_parts: {
-    /** The name of the component template. Accepts wildcard expressions. If omitted, all component templates are returned. */
+    /**
+     * The name of the component template.
+     * It accepts wildcard expressions.
+     * If it is omitted, all component templates are returned. */
     name?: string
   }
   query_parameters: {
@@ -57,7 +62,7 @@ export interface Request extends CatRequestBase {
      */
     local?: boolean
     /**
-     * Period to wait for a connection to the master node.
+     * The period to wait for a connection to the master node.
      * @server_default 30s
      */
     master_timeout?: Duration
diff --git a/specification/cat/component_templates/examples/200_response/CatComponentTemplatesResponseExample1.yaml b/specification/cat/component_templates/examples/200_response/CatComponentTemplatesResponseExample1.yaml
new file mode 100644
index 0000000000..f26b38c391
--- /dev/null
+++ b/specification/cat/component_templates/examples/200_response/CatComponentTemplatesResponseExample1.yaml
@@ -0,0 +1,12 @@
+# summary:
+description: >
+  A successful response from `GET _cat/aliases?v=true`.
+  This response shows that `alias2` has configured a filter and `alias3` and `alias4` have routing configurations.
+# type: response
+# response_code: 200
+value: |-
+  alias  index filter routing.index routing.search is_write_index
+  alias1 test1 -      -            -              -
+  alias2 test1 *      -            -              -
+  alias3 test1 -      1            1              -
+  alias4 test1 -      2            1,2            -
diff --git a/specification/cat/count/CatCountRequest.ts b/specification/cat/count/CatCountRequest.ts
index 82baf5fa5c..69f72cbe92 100644
--- a/specification/cat/count/CatCountRequest.ts
+++ b/specification/cat/count/CatCountRequest.ts
@@ -22,10 +22,11 @@ import { Indices } from '@_types/common'
 
 /**
  * Get a document count.
- * Provides quick access to a document count for a data stream, an index, or an entire cluster.
+ *
+ * Get quick access to a document count for a data stream, an index, or an entire cluster.
  * The document count only includes live documents, not deleted documents which have not yet been removed by the merge process.
  *
- * CAT APIs are only intended for human consumption using the command line or Kibana console.
+ * IMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console.
  * They are not intended for use by applications. For application consumption, use the count API.
  * @rest_spec_name cat.count
  * @availability stack stability=stable
@@ -46,8 +47,9 @@ export interface Request extends CatRequestBase {
   ]
   path_parts: {
     /**
-     * Comma-separated list of data streams, indices, and aliases used to limit the request.
-     * Supports wildcards (`*`). To target all data streams and indices, omit this parameter or use `*` or `_all`.
+     * A comma-separated list of data streams, indices, and aliases used to limit the request.
+     * It supports wildcards (`*`).
+     * To target all data streams and indices, omit this parameter or use `*` or `_all`.
      */
     index?: Indices
   }
diff --git a/specification/cat/count/examples/200_response/CatCountResponseExample1.yaml b/specification/cat/count/examples/200_response/CatCountResponseExample1.yaml
new file mode 100644
index 0000000000..af1f820407
--- /dev/null
+++ b/specification/cat/count/examples/200_response/CatCountResponseExample1.yaml
@@ -0,0 +1,9 @@
+summary: Single data stream or index count
+description: >
+  A successful response from `GET /_cat/count/my-index-000001?v=true`.
+  It retrieves the document count for the `my-index-000001` data stream or index.
+# type: response
+# response_code: 200
+value: |-
+  epoch      timestamp count
+  1475868259 15:24:20  120
diff --git a/specification/cat/count/examples/200_response/CatCountResponseExample2.yaml b/specification/cat/count/examples/200_response/CatCountResponseExample2.yaml
new file mode 100644
index 0000000000..326450b3a2
--- /dev/null
+++ b/specification/cat/count/examples/200_response/CatCountResponseExample2.yaml
@@ -0,0 +1,9 @@
+summary: All data streams and indices count
+description: >
+  A successful response from `GET /_cat/count?v=true`.
+  It retrieves the document count for all data streams and indices in the cluster.
+# type: response
+# response_code: 200
+value: |-
+  epoch      timestamp count
+  1475868259 15:24:20  121
diff --git a/specification/cat/fielddata/CatFielddataRequest.ts b/specification/cat/fielddata/CatFielddataRequest.ts
index 276df5af0a..b495da9c08 100644
--- a/specification/cat/fielddata/CatFielddataRequest.ts
+++ b/specification/cat/fielddata/CatFielddataRequest.ts
@@ -22,7 +22,9 @@ import { Bytes, Fields } from '@_types/common'
 
 /**
  * Get field data cache information.
+ *
  * Get the amount of heap memory currently used by the field data cache on every data node in the cluster.
+ *
  * IMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console.
  * They are not intended for use by applications. For application consumption, use the nodes stats API.
  * @rest_spec_name cat.fielddata
diff --git a/specification/cat/fielddata/examples/200_response/CatFielddataResponseExample1.yaml b/specification/cat/fielddata/examples/200_response/CatFielddataResponseExample1.yaml
new file mode 100644
index 0000000000..56090cf442
--- /dev/null
+++ b/specification/cat/fielddata/examples/200_response/CatFielddataResponseExample1.yaml
@@ -0,0 +1,10 @@
+summary: Single field data
+description: >
+  A successful response from `GET /_cat/fielddata?v=true&fields=body`.
+  You can specify an individual field in the request body or URL path.
+  This example retrieves heap memory size information for the `body` field.
+# type: response
+# response_code:
+value: |-
+  id                     host      ip        node    field   size
+  Nqk-6inXQq-OxUfOUI8jNQ 127.0.0.1 127.0.0.1 Nqk-6in body    544b
diff --git a/specification/cat/fielddata/examples/200_response/CatFielddataResponseExample2.yaml b/specification/cat/fielddata/examples/200_response/CatFielddataResponseExample2.yaml
new file mode 100644
index 0000000000..dd4b44a770
--- /dev/null
+++ b/specification/cat/fielddata/examples/200_response/CatFielddataResponseExample2.yaml
@@ -0,0 +1,12 @@
+summary: Multiple fields data
+description: >
+  A successful response from `GET /_cat/fielddata/body,soul?v=true`.
+  You can specify a comma-separated list of fields in the request body or URL path.
+  This example retrieves heap memory size information for the `body` and `soul` fields.
+  To get information for all fields, run `GET /_cat/fielddata?v=true`.
+# type: response
+# response_code:
+value: |-
+  id                     host      ip        node    field   size
+  Nqk-6inXQq-OxUfOUI8jNQ 127.0.0.1 127.0.0.1 Nqk-6in body    544b
+  Nqk-6inXQq-OxUfOUI8jNQ 127.0.0.1 127.0.0.1 Nqk-6in soul    480b
diff --git a/specification/cat/health/CatHealthRequest.ts b/specification/cat/health/CatHealthRequest.ts
index 052e30534d..232d2a8a1a 100644
--- a/specification/cat/health/CatHealthRequest.ts
+++ b/specification/cat/health/CatHealthRequest.ts
@@ -22,7 +22,8 @@ import { TimeUnit } from '@_types/Time'
 
 /**
  * Get the cluster health status.
- * IMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console.
+ *
+ * IMPORTANT: CAT APIs are only intended for human consumption using the command line or Kibana console.
  * They are not intended for use by applications. For application consumption, use the cluster health API.
  * This API is often used to check malfunctioning clusters.
  * To help you track cluster health alongside log files and alerting systems, the API returns timestamps in two formats:
diff --git a/specification/cat/health/examples/200_response/CatHealthResponseExample1.yaml b/specification/cat/health/examples/200_response/CatHealthResponseExample1.yaml
new file mode 100644
index 0000000000..cbe596f9d9
--- /dev/null
+++ b/specification/cat/health/examples/200_response/CatHealthResponseExample1.yaml
@@ -0,0 +1,9 @@
+# summary:
+description: >
+  A successful response from `GET /_cat/health?v=true`.
+  By default, it returns `HH:MM:SS` and Unix epoch timestamps.
+# type: response
+# response_code: 200
+value: |-
+  epoch      timestamp cluster       status node.total node.data shards pri relo init unassign unassign.pri pending_tasks max_task_wait_time active_shards_percent
+  1475871424 16:17:04  elasticsearch green           1         1      1   1    0    0        0            0             0                  -                100.0%
diff --git a/specification/cat/help/CatHelpRequest.ts b/specification/cat/help/CatHelpRequest.ts
index 8ff7098919..877fd430f6 100644
--- a/specification/cat/help/CatHelpRequest.ts
+++ b/specification/cat/help/CatHelpRequest.ts
@@ -19,7 +19,8 @@
 
 /**
  * Get CAT help.
- * Returns help for the CAT APIs.
+ *
+ * Get help for the CAT APIs.
  * @rest_spec_name cat.help
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public
diff --git a/specification/cat/indices/CatIndicesRequest.ts b/specification/cat/indices/CatIndicesRequest.ts
index fecf5ae088..86b825c4c8 100644
--- a/specification/cat/indices/CatIndicesRequest.ts
+++ b/specification/cat/indices/CatIndicesRequest.ts
@@ -23,7 +23,8 @@ import { Duration, TimeUnit } from '@_types/Time'
 
 /**
  * Get index information.
- * Returns high-level information about indices in a cluster, including backing indices for data streams.
+ *
+ * Get high-level information about indices in a cluster, including backing indices for data streams.
  *
  * Use this request to get the following information for each index in a cluster:
  * - shard count
diff --git a/specification/cat/indices/examples/200_response/CatIndicesResponseExample1.yaml b/specification/cat/indices/examples/200_response/CatIndicesResponseExample1.yaml
new file mode 100644
index 0000000000..ceb5b24974
--- /dev/null
+++ b/specification/cat/indices/examples/200_response/CatIndicesResponseExample1.yaml
@@ -0,0 +1,9 @@
+# summary:
+description: >
+  A successful response from `GET /_cat/indices/my-index-*?v=true&s=index`.
+# type: response
+# response_code:
+value: |-
+  health status index            uuid                   pri rep docs.count docs.deleted store.size pri.store.size dataset.size
+  yellow open   my-index-000001  u8FNjxh8Rfy_awN11oDKYQ   1   1       1200            0     88.1kb         88.1kb       88.1kb
+  green  open   my-index-000002  nYFWZEO7TUiOjLQXBaYJpA   1   0          0            0       260b           260b         260b
diff --git a/specification/cat/master/CatMasterRequest.ts b/specification/cat/master/CatMasterRequest.ts
index 6558e11861..9fd21124d4 100644
--- a/specification/cat/master/CatMasterRequest.ts
+++ b/specification/cat/master/CatMasterRequest.ts
@@ -22,7 +22,9 @@ import { Duration } from '@_types/Time'
 
 /**
  * Get master node information.
+ *
  * Get information about the master node, including the ID, bound IP address, and name.
+ *
  * IMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.
  * @rest_spec_name cat.master
  * @availability stack stability=stable
diff --git a/specification/cat/master/examples/200_response/CatMasterResponseExample1.yaml b/specification/cat/master/examples/200_response/CatMasterResponseExample1.yaml
new file mode 100644
index 0000000000..4124b3a62e
--- /dev/null
+++ b/specification/cat/master/examples/200_response/CatMasterResponseExample1.yaml
@@ -0,0 +1,8 @@
+# summary:
+description: >
+  A successful response from `GET /_cat/master?v=true`.
+# type: response
+# response_code:
+value: |-
+  id                     host      ip        node
+  YzWoH_2BT-6UjVGDyPdqYg 127.0.0.1 127.0.0.1 YzWoH_2
diff --git a/specification/cat/ml_data_frame_analytics/CatDataFrameAnalyticsRequest.ts b/specification/cat/ml_data_frame_analytics/CatDataFrameAnalyticsRequest.ts
index 98a19772e5..b1ea803427 100644
--- a/specification/cat/ml_data_frame_analytics/CatDataFrameAnalyticsRequest.ts
+++ b/specification/cat/ml_data_frame_analytics/CatDataFrameAnalyticsRequest.ts
@@ -23,9 +23,10 @@ import { TimeUnit } from '@_types/Time'
 
 /**
  * Get data frame analytics jobs.
- * Returns configuration and usage information about data frame analytics jobs.
  *
- * CAT APIs are only intended for human consumption using the Kibana
+ * Get configuration and usage information about data frame analytics jobs.
+ *
+ * IMPORTANT: CAT APIs are only intended for human consumption using the Kibana
  * console or command line. They are not intended for use by applications. For
  * application consumption, use the get data frame analytics jobs statistics API.
  *
diff --git a/specification/cat/ml_data_frame_analytics/examples/200_response/CatDataframeanalyticsResponseExample1.yaml b/specification/cat/ml_data_frame_analytics/examples/200_response/CatDataframeanalyticsResponseExample1.yaml
new file mode 100644
index 0000000000..7c0ab4cca3
--- /dev/null
+++ b/specification/cat/ml_data_frame_analytics/examples/200_response/CatDataframeanalyticsResponseExample1.yaml
@@ -0,0 +1,11 @@
+# summary:
+description: A successful response from `GET _cat/ml/data_frame/analytics?v=true`.
+# type: response
+# response_code: 200
+value: |-
+  id               create_time              type             state
+  classifier_job_1 2020-02-12T11:49:09.594Z classification stopped
+  classifier_job_2 2020-02-12T11:49:14.479Z classification stopped
+  classifier_job_3 2020-02-12T11:49:16.928Z classification stopped
+  classifier_job_4 2020-02-12T11:49:19.127Z classification stopped
+  classifier_job_5 2020-02-12T11:49:21.349Z classification stopped
diff --git a/specification/cat/ml_datafeeds/CatDatafeedsRequest.ts b/specification/cat/ml_datafeeds/CatDatafeedsRequest.ts
index 292ec3499e..5fccffd231 100644
--- a/specification/cat/ml_datafeeds/CatDatafeedsRequest.ts
+++ b/specification/cat/ml_datafeeds/CatDatafeedsRequest.ts
@@ -23,12 +23,13 @@ import { TimeUnit } from '@_types/Time'
 
 /**
  * Get datafeeds.
- * Returns configuration and usage information about datafeeds.
+ *
+ * Get configuration and usage information about datafeeds.
  * This API returns a maximum of 10,000 datafeeds.
  * If the Elasticsearch security features are enabled, you must have `monitor_ml`, `monitor`, `manage_ml`, or `manage`
  * cluster privileges to use this API.
  *
- * CAT APIs are only intended for human consumption using the Kibana
+ * IMPORTANT: CAT APIs are only intended for human consumption using the Kibana
  * console or command line. They are not intended for use by applications. For
  * application consumption, use the get datafeed statistics API.
  *
diff --git a/specification/cat/ml_datafeeds/examples/200_response/CatDatafeedsResponseExample1.yaml b/specification/cat/ml_datafeeds/examples/200_response/CatDatafeedsResponseExample1.yaml
new file mode 100644
index 0000000000..e2e17713f1
--- /dev/null
+++ b/specification/cat/ml_datafeeds/examples/200_response/CatDatafeedsResponseExample1.yaml
@@ -0,0 +1,10 @@
+# summary:
+description: A successful response from `GET _cat/ml/datafeeds?v=true`.
+# type: response
+# response_code:
+value: |-
+  id                              state buckets.count search.count
+  datafeed-high_sum_total_sales stopped 743          7
+  datafeed-low_request_rate     stopped 1457         3
+  datafeed-response_code_rates  stopped 1460         18
+  datafeed-url_scanning         stopped 1460         18
diff --git a/specification/cat/ml_jobs/CatJobsRequest.ts b/specification/cat/ml_jobs/CatJobsRequest.ts
index 4d95f920fe..f5a4f5554b 100644
--- a/specification/cat/ml_jobs/CatJobsRequest.ts
+++ b/specification/cat/ml_jobs/CatJobsRequest.ts
@@ -23,12 +23,13 @@ import { TimeUnit } from '@_types/Time'
 
 /**
  * Get anomaly detection jobs.
- * Returns configuration and usage information for anomaly detection jobs.
+ *
+ * Get configuration and usage information for anomaly detection jobs.
  * This API returns a maximum of 10,000 jobs.
  * If the Elasticsearch security features are enabled, you must have `monitor_ml`,
  * `monitor`, `manage_ml`, or `manage` cluster privileges to use this API.
  *
- * CAT APIs are only intended for human consumption using the Kibana
+ * IMPORTANT: CAT APIs are only intended for human consumption using the Kibana
  * console or command line. They are not intended for use by applications. For
  * application consumption, use the get anomaly detection job statistics API.
  *
diff --git a/specification/cat/ml_jobs/examples/200_response/CatJobsResponseExample1.yaml b/specification/cat/ml_jobs/examples/200_response/CatJobsResponseExample1.yaml
new file mode 100644
index 0000000000..1b1d38f386
--- /dev/null
+++ b/specification/cat/ml_jobs/examples/200_response/CatJobsResponseExample1.yaml
@@ -0,0 +1,8 @@
+# summary:
+description: A succesful response from `GET _cat/component_templates/my-template-*?v=true&s=name`.
+# type: response
+# response_code: ''
+value: |-
+  name          version alias_count mapping_count settings_count metadata_count included_in
+  my-template-1         0           0             1              0              [my-index-template]
+  my-template-2         0           3             0              0              [my-index-template]
diff --git a/specification/cat/ml_trained_models/CatTrainedModelsRequest.ts b/specification/cat/ml_trained_models/CatTrainedModelsRequest.ts
index d28a26572c..f0c38d5699 100644
--- a/specification/cat/ml_trained_models/CatTrainedModelsRequest.ts
+++ b/specification/cat/ml_trained_models/CatTrainedModelsRequest.ts
@@ -24,9 +24,10 @@ import { TimeUnit } from '@_types/Time'
 
 /**
  * Get trained models.
- * Returns configuration and usage information about inference trained models.
  *
- * CAT APIs are only intended for human consumption using the Kibana
+ * Get configuration and usage information about inference trained models.
+ *
+ * IMPORTANT: CAT APIs are only intended for human consumption using the Kibana
  * console or command line. They are not intended for use by applications. For
  * application consumption, use the get trained models statistics API.
  *
diff --git a/specification/cat/ml_trained_models/examples/200_response/CatTrainedModelsResponseExample1.yaml b/specification/cat/ml_trained_models/examples/200_response/CatTrainedModelsResponseExample1.yaml
new file mode 100644
index 0000000000..a213f32400
--- /dev/null
+++ b/specification/cat/ml_trained_models/examples/200_response/CatTrainedModelsResponseExample1.yaml
@@ -0,0 +1,9 @@
+# summary:
+description: A successful response from `GET _cat/ml/trained_models?h=c,o,l,ct,v&v=true`.
+# type: response
+# response_code: ''
+value: |-
+  id                           created_by operations license  create_time              version
+  ddddd-1580216177138              _xpack 196        PLATINUM 2020-01-28T12:56:17.138Z 8.0.0
+  flight-regress-1580215685537     _xpack 102        PLATINUM 2020-01-28T12:48:05.537Z 8.0.0
+  lang_ident_model_1               _xpack 39629      BASIC    2019-12-05T12:28:34.594Z 7.6.0
diff --git a/specification/cat/nodeattrs/CatNodeAttributesRequest.ts b/specification/cat/nodeattrs/CatNodeAttributesRequest.ts
index a6836e8aa9..db54476226 100644
--- a/specification/cat/nodeattrs/CatNodeAttributesRequest.ts
+++ b/specification/cat/nodeattrs/CatNodeAttributesRequest.ts
@@ -22,6 +22,7 @@ import { Duration } from '@_types/Time'
 
 /**
  * Get node attribute information.
+ *
  * Get information about custom node attributes.
  * IMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.
  * @rest_spec_name cat.nodeattrs
diff --git a/specification/cat/nodeattrs/examples/200_response/CatNodeAttributesResponseExample1.yaml b/specification/cat/nodeattrs/examples/200_response/CatNodeAttributesResponseExample1.yaml
new file mode 100644
index 0000000000..6d7affe4cf
--- /dev/null
+++ b/specification/cat/nodeattrs/examples/200_response/CatNodeAttributesResponseExample1.yaml
@@ -0,0 +1,10 @@
+summary: Default columns
+description: >
+  A successful response from `GET /_cat/nodeattrs?v=true`.
+  The `node`, `host`, and `ip` columns provide basic information about each node.
+  The `attr` and `value` columns return custom node attributes, one per line.
+# type: response
+# response_code: 200
+value: |-
+  node    host      ip        attr     value
+  node-0 127.0.0.1 127.0.0.1 testattr test
diff --git a/specification/cat/nodeattrs/examples/200_response/CatNodeAttributesResponseExample2.yaml b/specification/cat/nodeattrs/examples/200_response/CatNodeAttributesResponseExample2.yaml
new file mode 100644
index 0000000000..4fae5ed416
--- /dev/null
+++ b/specification/cat/nodeattrs/examples/200_response/CatNodeAttributesResponseExample2.yaml
@@ -0,0 +1,9 @@
+summary: Explicit columns
+description: >
+  A successful response from `GET /_cat/nodeattrs?v=true&h=name,pid,attr,value`.
+  It returns the `name`, `pid`, `attr`, and `value` columns.
+# type: response
+# response_code: 200
+value: |-
+  name    pid   attr     value
+  node-0 19566 testattr test
diff --git a/specification/cat/nodes/CatNodesRequest.ts b/specification/cat/nodes/CatNodesRequest.ts
index 47edf80f7d..181ca3670b 100644
--- a/specification/cat/nodes/CatNodesRequest.ts
+++ b/specification/cat/nodes/CatNodesRequest.ts
@@ -23,6 +23,7 @@ import { Duration, TimeUnit } from '@_types/Time'
 
 /**
  * Get node information.
+ *
  * Get information about the nodes in a cluster.
  * IMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.
  * @rest_spec_name cat.nodes
diff --git a/specification/cat/nodes/examples/200_response/CatNodesResponseExample1.yaml b/specification/cat/nodes/examples/200_response/CatNodesResponseExample1.yaml
new file mode 100644
index 0000000000..01fdfc7718
--- /dev/null
+++ b/specification/cat/nodes/examples/200_response/CatNodesResponseExample1.yaml
@@ -0,0 +1,10 @@
+summary: Default columns
+description: >
+  A successful response from `GET /_cat/nodes?v=true`.
+  The `ip`, `heap.percent`, `ram.percent`, `cpu`, and `load_*` columns provide the IP addresses and performance information of each node.
+  The `node.role`, `master`, and `name` columns provide information useful for monitoring an entire cluster, particularly large ones.
+# type: response
+# response_code: 200
+value: |-
+  ip        heap.percent ram.percent cpu load_1m load_5m load_15m node.role master name
+  127.0.0.1           65          99  42    3.07                  dim       *      mJw06l1
diff --git a/specification/cat/nodes/examples/200_response/CatNodesResponseExample2.yaml b/specification/cat/nodes/examples/200_response/CatNodesResponseExample2.yaml
new file mode 100644
index 0000000000..e275a47985
--- /dev/null
+++ b/specification/cat/nodes/examples/200_response/CatNodesResponseExample2.yaml
@@ -0,0 +1,9 @@
+summary: Explicit columns
+description: >
+  A successful response from `GET /_cat/nodes?v=true&h=id,ip,port,v,m`.
+  It returns the `id`, `ip`, `port`, `v` (version), and `m` (master) columns.
+# type: response
+# response_code:
+value: |-
+  id   ip        port  v         m
+  veJR 127.0.0.1 59938 8.17.0 *
diff --git a/specification/cat/pending_tasks/CatPendingTasksRequest.ts b/specification/cat/pending_tasks/CatPendingTasksRequest.ts
index 4fbfc0c1e1..2519eca58d 100644
--- a/specification/cat/pending_tasks/CatPendingTasksRequest.ts
+++ b/specification/cat/pending_tasks/CatPendingTasksRequest.ts
@@ -22,6 +22,7 @@ import { Duration, TimeUnit } from '@_types/Time'
 
 /**
  * Get pending task information.
+ *
  * Get information about cluster-level changes that have not yet taken effect.
  * IMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the pending cluster tasks API.
  * @rest_spec_name cat.pending_tasks
diff --git a/specification/cat/pending_tasks/examples/200_response/CatPendingTasksResponseExample1.yaml b/specification/cat/pending_tasks/examples/200_response/CatPendingTasksResponseExample1.yaml
new file mode 100644
index 0000000000..9a021ada26
--- /dev/null
+++ b/specification/cat/pending_tasks/examples/200_response/CatPendingTasksResponseExample1.yaml
@@ -0,0 +1,14 @@
+# summary:
+description: >
+  A successful response from `GET /_cat/pending_tasks?v=true`.
+# type: response
+# response_code: 200
+value: |-
+  insertOrder timeInQueue priority source
+        1685       855ms HIGH     update-mapping [foo][t]
+        1686       843ms HIGH     update-mapping [foo][t]
+        1693       753ms HIGH     refresh-mapping [foo][[t]]
+        1688       816ms HIGH     update-mapping [foo][t]
+        1689       802ms HIGH     update-mapping [foo][t]
+        1690       787ms HIGH     update-mapping [foo][t]
+        1691       773ms HIGH     update-mapping [foo][t]
diff --git a/specification/cat/plugins/CatPluginsRequest.ts b/specification/cat/plugins/CatPluginsRequest.ts
index 46a7f4ff54..75ff70edbb 100644
--- a/specification/cat/plugins/CatPluginsRequest.ts
+++ b/specification/cat/plugins/CatPluginsRequest.ts
@@ -22,6 +22,7 @@ import { Duration } from '@_types/Time'
 
 /**
  * Get plugin information.
+ *
  * Get a list of plugins running on each node of a cluster.
  * IMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.
  * @rest_spec_name cat.plugins
diff --git a/specification/cat/plugins/examples/200_response/CatPluginsResponseExample1.yaml b/specification/cat/plugins/examples/200_response/CatPluginsResponseExample1.yaml
new file mode 100644
index 0000000000..1fba45a722
--- /dev/null
+++ b/specification/cat/plugins/examples/200_response/CatPluginsResponseExample1.yaml
@@ -0,0 +1,21 @@
+# summary:
+description: >
+  A successful response from `GET /_cat/plugins?v=true&s=component&h=name,component,version,description`.
+# type: response
+# response_code:
+value: |-
+  name    component               version   description
+  U7321H6 analysis-icu            8.17.0 The ICU Analysis plugin integrates the Lucene ICU module into Elasticsearch, adding ICU-related analysis components.
+  U7321H6 analysis-kuromoji       8.17.0 The Japanese (kuromoji) Analysis plugin integrates Lucene kuromoji analysis module into elasticsearch.
+  U7321H6 analysis-nori           8.17.0 The Korean (nori) Analysis plugin integrates Lucene nori analysis module into elasticsearch.
+  U7321H6 analysis-phonetic       8.17.0 The Phonetic Analysis plugin integrates phonetic token filter analysis with elasticsearch.
+  U7321H6 analysis-smartcn        8.17.0 Smart Chinese Analysis plugin integrates Lucene Smart Chinese analysis module into elasticsearch.
+  U7321H6 analysis-stempel        8.17.0 The Stempel (Polish) Analysis plugin integrates Lucene stempel (polish) analysis module into elasticsearch.
+  U7321H6 analysis-ukrainian      8.17.0 The Ukrainian Analysis plugin integrates the Lucene UkrainianMorfologikAnalyzer into elasticsearch.
+  U7321H6 discovery-azure-classic 8.17.0 The Azure Classic Discovery plugin allows to use Azure Classic API for the unicast discovery mechanism
+  U7321H6 discovery-ec2           8.17.0 The EC2 discovery plugin allows to use AWS API for the unicast discovery mechanism.
+  U7321H6 discovery-gce           8.17.0 The Google Compute Engine (GCE) Discovery plugin allows to use GCE API for the unicast discovery mechanism.
+  U7321H6 mapper-annotated-text   8.17.0 The Mapper Annotated_text plugin adds support for text fields with markup used to inject annotation tokens into the index.
+  U7321H6 mapper-murmur3          8.17.0 The Mapper Murmur3 plugin allows to compute hashes of a field's values at index-time and to store them in the index.
+  U7321H6 mapper-size             8.17.0 The Mapper Size plugin allows document to record their uncompressed size at index time.
+  U7321H6 store-smb               8.17.0 The Store SMB plugin adds support for SMB stores.
diff --git a/specification/cat/recovery/CatRecoveryRequest.ts b/specification/cat/recovery/CatRecoveryRequest.ts
index a511b55639..8edd033847 100644
--- a/specification/cat/recovery/CatRecoveryRequest.ts
+++ b/specification/cat/recovery/CatRecoveryRequest.ts
@@ -23,6 +23,7 @@ import { TimeUnit } from '@_types/Time'
 
 /**
  * Get shard recovery information.
+ *
  * Get information about ongoing and completed shard recoveries.
  * Shard recovery is the process of initializing a shard copy, such as restoring a primary shard from a snapshot or syncing a replica shard from a primary shard. When a shard recovery completes, the recovered shard is available for search and indexing.
  * For data streams, the API returns information about the stream’s backing indices.
diff --git a/specification/cat/recovery/examples/200_response/CatRecoveryResponseExample1.yaml b/specification/cat/recovery/examples/200_response/CatRecoveryResponseExample1.yaml
new file mode 100644
index 0000000000..34ed5bcd39
--- /dev/null
+++ b/specification/cat/recovery/examples/200_response/CatRecoveryResponseExample1.yaml
@@ -0,0 +1,9 @@
+summary: No ongoing recoveries
+description: >
+  A successful response from `GET _cat/recovery?v=true`.
+  In this example, the source and target nodes are the same because the recovery type is `store`, meaning they were read from local storage on node start.
+# type: response
+# response_code: 200
+value: |-
+  index             shard time type  stage source_host source_node target_host target_node repository snapshot files files_recovered files_percent files_total bytes bytes_recovered bytes_percent bytes_total translog_ops translog_ops_recovered translog_ops_percent
+  my-index-000001   0     13ms store done  n/a         n/a         127.0.0.1   node-0      n/a        n/a      0     0               100%          13          0b    0b              100%          9928b       0            0                      100.0%
diff --git a/specification/cat/recovery/examples/200_response/CatRecoveryResponseExample2.yaml b/specification/cat/recovery/examples/200_response/CatRecoveryResponseExample2.yaml
new file mode 100644
index 0000000000..df7f8f6c7b
--- /dev/null
+++ b/specification/cat/recovery/examples/200_response/CatRecoveryResponseExample2.yaml
@@ -0,0 +1,11 @@
+summary: A live shard recovery
+description: >
+  A successful response from `GET _cat/recovery?v=true&h=i,s,t,ty,st,shost,thost,f,fp,b,bp`.
+  You can retrieve information about an ongoing recovery for example when you increase the replica count of an index and bring another node online to host the replicas.
+  In this example, the recovery type is `peer`, meaning the shard recovered from another node.
+  The `files` and `bytes` are real-time measurements.
+# type: response
+# response_code: 200
+value: |-
+  i               s t      ty   st    shost       thost       f     fp      b  bp
+  my-index-000001 0 1252ms peer done  192.168.1.1 192.168.1.2 0     100.0%  0b 100.0%
diff --git a/specification/cat/recovery/examples/200_response/CatRecoveryResponseExample3.yaml b/specification/cat/recovery/examples/200_response/CatRecoveryResponseExample3.yaml
new file mode 100644
index 0000000000..2e4c852e75
--- /dev/null
+++ b/specification/cat/recovery/examples/200_response/CatRecoveryResponseExample3.yaml
@@ -0,0 +1,10 @@
+summary: A snapshot recovery
+description: >
+  A successful response from `GET _cat/recovery?v=true&h=i,s,t,ty,st,rep,snap,f,fp,b,bp`.
+  You can restore backups of an index using the snapshot and restore API.
+  You can use the cat recovery API to get information about a snapshot recovery.
+# type: response
+# response_code: 200
+value: |-
+  i               s t      ty       st    rep     snap   f  fp   b     bp
+  my-index-000001 0 1978ms snapshot done  my-repo snap-1 79 8.0% 12086 9.0%
diff --git a/specification/cat/repositories/CatRepositoriesRequest.ts b/specification/cat/repositories/CatRepositoriesRequest.ts
index effa8d814a..68f4e5b667 100644
--- a/specification/cat/repositories/CatRepositoriesRequest.ts
+++ b/specification/cat/repositories/CatRepositoriesRequest.ts
@@ -22,6 +22,7 @@ import { Duration } from '@_types/Time'
 
 /**
  * Get snapshot repository information.
+ *
  * Get a list of snapshot repositories for a cluster.
  * IMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the get snapshot repository API.
  * @rest_spec_name cat.repositories
diff --git a/specification/cat/repositories/examples/200_response/CatRepositoriesResponseExample1.yaml b/specification/cat/repositories/examples/200_response/CatRepositoriesResponseExample1.yaml
new file mode 100644
index 0000000000..3a857df658
--- /dev/null
+++ b/specification/cat/repositories/examples/200_response/CatRepositoriesResponseExample1.yaml
@@ -0,0 +1,9 @@
+# summary:
+description: >
+  A successful response from `GET /_cat/repositories?v=true`.
+# type: response
+# response_code: 200
+value: |-
+  id    type
+  repo1   fs
+  repo2   s3
diff --git a/specification/cat/segments/CatSegmentsRequest.ts b/specification/cat/segments/CatSegmentsRequest.ts
index 0e71df4ba1..9eed2599c9 100644
--- a/specification/cat/segments/CatSegmentsRequest.ts
+++ b/specification/cat/segments/CatSegmentsRequest.ts
@@ -23,6 +23,7 @@ import { Duration } from '@_types/Time'
 
 /**
  * Get segment information.
+ *
  * Get low-level information about the Lucene segments in index shards.
  * For data streams, the API returns information about the backing indices.
  * IMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the index segments API.
diff --git a/specification/cat/segments/examples/200_response/CatSegmentsResponseExample1.yaml b/specification/cat/segments/examples/200_response/CatSegmentsResponseExample1.yaml
new file mode 100644
index 0000000000..a93ad160fa
--- /dev/null
+++ b/specification/cat/segments/examples/200_response/CatSegmentsResponseExample1.yaml
@@ -0,0 +1,9 @@
+# summary:
+description: >
+  A successful response from `GET /_cat/segments?v=true`.
+# type: response
+# response_code: 200
+value: |-
+  index shard prirep ip        segment generation docs.count docs.deleted size size.memory committed searchable version compound
+  test  0     p      127.0.0.1 _0               0          1            0  3kb           0 false     true       9.12.0   true
+  test1 0     p      127.0.0.1 _0               0          1            0  3kb           0 false     true       9.12.0   true
diff --git a/specification/cat/shards/CatShardsRequest.ts b/specification/cat/shards/CatShardsRequest.ts
index 0e126ccf57..e83d8d6ff4 100644
--- a/specification/cat/shards/CatShardsRequest.ts
+++ b/specification/cat/shards/CatShardsRequest.ts
@@ -23,6 +23,7 @@ import { Duration, TimeUnit } from '@_types/Time'
 
 /**
  * Get shard information.
+ *
  * Get information about the shards in a cluster.
  * For data streams, the API returns information about the backing indices.
  * IMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications.
diff --git a/specification/cat/shards/examples/200_response/CatShardsResponseExample1.yaml b/specification/cat/shards/examples/200_response/CatShardsResponseExample1.yaml
new file mode 100644
index 0000000000..8f473d6578
--- /dev/null
+++ b/specification/cat/shards/examples/200_response/CatShardsResponseExample1.yaml
@@ -0,0 +1,7 @@
+summary: A single data stream or index
+description: >
+  A successful response from `GET _cat/shards`.
+# type: response
+# response_code: 200
+value: |-
+  my-index-000001 0 p STARTED 3014 31.1mb 192.168.56.10 H5dfFeA
diff --git a/specification/cat/shards/examples/200_response/CatShardsResponseExample2.yaml b/specification/cat/shards/examples/200_response/CatShardsResponseExample2.yaml
new file mode 100644
index 0000000000..d92faac6b2
--- /dev/null
+++ b/specification/cat/shards/examples/200_response/CatShardsResponseExample2.yaml
@@ -0,0 +1,8 @@
+summary: A wildcard pattern
+description: >
+  A successful response from `GET _cat/shards/my-index-*`.
+  It returns information for any data streams or indices beginning with `my-index-`.
+# type: response
+# response_code: 200
+value: |-
+  my-index-000001 0 p STARTED 3014 31.1mb 192.168.56.10 H5dfFeA
diff --git a/specification/cat/shards/examples/200_response/CatShardsResponseExample3.yaml b/specification/cat/shards/examples/200_response/CatShardsResponseExample3.yaml
new file mode 100644
index 0000000000..e4380dacc0
--- /dev/null
+++ b/specification/cat/shards/examples/200_response/CatShardsResponseExample3.yaml
@@ -0,0 +1,8 @@
+summary: A relocating shard
+description: >
+  A successful response from `GET _cat/shards`.
+  The `RELOCATING` value in the `state` column indicates the index shard is relocating.
+# type: response
+# response_code: 200
+value: |-
+  my-index-000001 0 p RELOCATING 3014 31.1mb 192.168.56.10 H5dfFeA -> -> 192.168.56.30 bGG90GE
diff --git a/specification/cat/shards/examples/200_response/CatShardsResponseExample4.yaml b/specification/cat/shards/examples/200_response/CatShardsResponseExample4.yaml
new file mode 100644
index 0000000000..01ad25c9be
--- /dev/null
+++ b/specification/cat/shards/examples/200_response/CatShardsResponseExample4.yaml
@@ -0,0 +1,10 @@
+summary: Shard states
+description: >
+  A successful response from `GET _cat/shards`.
+  Before a shard is available for use, it goes through an `INITIALIZING` state.
+  You can use the cat shards API to see which shards are initializing.
+# type: response
+# response_code: 200
+value: |-
+  my-index-000001 0 p STARTED      3014 31.1mb 192.168.56.10 H5dfFeA
+  my-index-000001 0 r INITIALIZING    0 14.3mb 192.168.56.30 bGG90GE
diff --git a/specification/cat/shards/examples/200_response/CatShardsResponseExample5.yaml b/specification/cat/shards/examples/200_response/CatShardsResponseExample5.yaml
new file mode 100644
index 0000000000..25313b1b70
--- /dev/null
+++ b/specification/cat/shards/examples/200_response/CatShardsResponseExample5.yaml
@@ -0,0 +1,11 @@
+summary: Reasons for unassigned shards
+description: >
+  A successful response from `GET _cat/shards?h=index,shard,prirep,state,unassigned.reason`.
+  It includes the `unassigned.reason` column, which indicates why a shard is unassigned.
+# type: response
+# response_code: 200
+value: |-
+  my-index-000001 0 p STARTED    3014 31.1mb 192.168.56.10 H5dfFeA
+  my-index-000001 0 r STARTED    3014 31.1mb 192.168.56.30 bGG90GE
+  my-index-000001 0 r STARTED    3014 31.1mb 192.168.56.20 I8hydUG
+  my-index-000001 0 r UNASSIGNED ALLOCATION_FAILED
diff --git a/specification/cat/snapshots/CatSnapshotsRequest.ts b/specification/cat/snapshots/CatSnapshotsRequest.ts
index a9923bcd08..01d6f7ed5e 100644
--- a/specification/cat/snapshots/CatSnapshotsRequest.ts
+++ b/specification/cat/snapshots/CatSnapshotsRequest.ts
@@ -22,7 +22,8 @@ import { Names } from '@_types/common'
 import { Duration, TimeUnit } from '@_types/Time'
 
 /**
- * Get snapshot information
+ * Get snapshot information.
+ *
  * Get information about the snapshots stored in one or more repositories.
  * A snapshot is a backup of an index or running Elasticsearch cluster.
  * IMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the get snapshot API.
diff --git a/specification/cat/snapshots/examples/200_response/CatSnapshotsResponseExample1.yaml b/specification/cat/snapshots/examples/200_response/CatSnapshotsResponseExample1.yaml
new file mode 100644
index 0000000000..c9f31cf7a8
--- /dev/null
+++ b/specification/cat/snapshots/examples/200_response/CatSnapshotsResponseExample1.yaml
@@ -0,0 +1,9 @@
+# summary:
+description: >
+  A successful response from `GET /_cat/snapshots/repo1?v=true&s=id`.
+# type: response
+# response_code: 200
+value: |-
+  id     repository status start_epoch start_time end_epoch  end_time duration indices successful_shards failed_shards total_shards
+  snap1  repo1      FAILED 1445616705  18:11:45   1445616978 18:16:18     4.6m       1                 4             1            5
+  snap2  repo1      SUCCESS 1445634298  23:04:58   1445634672 23:11:12     6.2m       2                10             0           10
diff --git a/specification/cat/tasks/CatTasksRequest.ts b/specification/cat/tasks/CatTasksRequest.ts
index 924744c591..8578379e41 100644
--- a/specification/cat/tasks/CatTasksRequest.ts
+++ b/specification/cat/tasks/CatTasksRequest.ts
@@ -22,6 +22,7 @@ import { Duration, TimeUnit } from '@_types/Time'
 
 /**
  * Get task information.
+ *
  * Get information about tasks currently running in the cluster.
  * IMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the task management API.
  * @rest_spec_name cat.tasks
diff --git a/specification/cat/tasks/examples/200_response/CatTasksResponseExample1.yaml b/specification/cat/tasks/examples/200_response/CatTasksResponseExample1.yaml
new file mode 100644
index 0000000000..8d05b0a9d2
--- /dev/null
+++ b/specification/cat/tasks/examples/200_response/CatTasksResponseExample1.yaml
@@ -0,0 +1,8 @@
+# summary:
+description: A successful response from `GET _cat/tasks?v=true`.
+# type: response
+# response_code: 200
+value: |-
+  action                         task_id                    parent_task_id             type      start_time    timestamp running_time ip             node
+  cluster:monitor/tasks/lists[n] oTUltX4IQMOUUVeiohTt8A:124 oTUltX4IQMOUUVeiohTt8A:123 direct    1458585884904 01:48:24  44.1micros   127.0.0.1:9300 oTUltX4IQMOUUVeiohTt8A
+  cluster:monitor/tasks/lists    oTUltX4IQMOUUVeiohTt8A:123 -                          transport 1458585884904 01:48:24  186.2micros  127.0.0.1:9300 oTUltX4IQMOUUVeiohTt8A
diff --git a/specification/cat/templates/CatTemplatesRequest.ts b/specification/cat/templates/CatTemplatesRequest.ts
index 2b6ee41203..9f14fb3e10 100644
--- a/specification/cat/templates/CatTemplatesRequest.ts
+++ b/specification/cat/templates/CatTemplatesRequest.ts
@@ -23,6 +23,7 @@ import { Duration } from '@_types/Time'
 
 /**
  * Get index template information.
+ *
  * Get information about the index templates in a cluster.
  * You can use index templates to apply index settings and field mappings to new indices at creation.
  * IMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the get index template API.
diff --git a/specification/cat/templates/examples/200_response/CatTemplatesResponseExample1.yaml b/specification/cat/templates/examples/200_response/CatTemplatesResponseExample1.yaml
new file mode 100644
index 0000000000..af3110b0f8
--- /dev/null
+++ b/specification/cat/templates/examples/200_response/CatTemplatesResponseExample1.yaml
@@ -0,0 +1,10 @@
+# summary:
+description: >
+  A successful response from `GET _cat/templates/my-template-*?v=true&s=name`.
+# type: response
+# response_code: 200
+value: |-
+  name          index_patterns order version composed_of
+  my-template-0 [te*]          500           []
+  my-template-1 [tea*]         501           []
+  my-template-2 [teak*]        502   7       []
diff --git a/specification/cat/thread_pool/CatThreadPoolRequest.ts b/specification/cat/thread_pool/CatThreadPoolRequest.ts
index 4c74cf18dd..d0ee06dfc6 100644
--- a/specification/cat/thread_pool/CatThreadPoolRequest.ts
+++ b/specification/cat/thread_pool/CatThreadPoolRequest.ts
@@ -23,6 +23,7 @@ import { Duration, TimeUnit } from '@_types/Time'
 
 /**
  * Get thread pool statistics.
+ *
  * Get thread pool statistics for each node in a cluster.
  * Returned information includes all built-in thread pools and custom thread pools.
  * IMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications. For application consumption, use the nodes info API.
diff --git a/specification/cat/thread_pool/examples/200_response/CatThreadPoolResponseExample1.yaml b/specification/cat/thread_pool/examples/200_response/CatThreadPoolResponseExample1.yaml
new file mode 100644
index 0000000000..e62c1780cc
--- /dev/null
+++ b/specification/cat/thread_pool/examples/200_response/CatThreadPoolResponseExample1.yaml
@@ -0,0 +1,11 @@
+summary: Default columns
+description: >
+  A successful response from `GET /_cat/thread_pool`.
+# type: response
+# response_code: 200
+value: |-
+  node-0 analyze             0 0 0
+  node-0 fetch_shard_started 0 0 0
+  node-0 fetch_shard_store   0 0 0
+  node-0 flush               0 0 0
+  node-0 write               0 0 0
diff --git a/specification/cat/thread_pool/examples/200_response/CatThreadPoolResponseExample2.yaml b/specification/cat/thread_pool/examples/200_response/CatThreadPoolResponseExample2.yaml
new file mode 100644
index 0000000000..861ae9dc46
--- /dev/null
+++ b/specification/cat/thread_pool/examples/200_response/CatThreadPoolResponseExample2.yaml
@@ -0,0 +1,10 @@
+summary: Explicit columns
+description: >
+  A successful response from `GET /_cat/thread_pool/generic?v=true&h=id,name,active,rejected,completed`.
+  It returns the `id`, `name`, `active`, `rejected`, and `completed` columns.
+  It also limits returned information to the generic thread pool.
+# type: response
+# response_code: 200
+value: |-
+  id                     name    active rejected completed
+  0EWUhXeBQtaVGlexUeVwMg generic      0        0        70
diff --git a/specification/cat/transforms/CatTransformsRequest.ts b/specification/cat/transforms/CatTransformsRequest.ts
index 4467d1184f..1cea29821b 100644
--- a/specification/cat/transforms/CatTransformsRequest.ts
+++ b/specification/cat/transforms/CatTransformsRequest.ts
@@ -24,6 +24,7 @@ import { TimeUnit } from '@_types/Time'
 
 /**
  * Get transform information.
+ *
  * Get configuration and usage information about transforms.
  *
  * CAT APIs are only intended for human consumption using the Kibana
diff --git a/specification/cat/transforms/examples/200_response/CatTransformsResponseExample1.yaml b/specification/cat/transforms/examples/200_response/CatTransformsResponseExample1.yaml
new file mode 100644
index 0000000000..d5ad7f2c82
--- /dev/null
+++ b/specification/cat/transforms/examples/200_response/CatTransformsResponseExample1.yaml
@@ -0,0 +1,15 @@
+# summary:
+description: A successful response from `GET /_cat/transforms?v=true&format=json`.
+# type: response
+# response_code: 200
+value: |-
+  [
+    {
+      "id" : "ecommerce_transform",
+      "state" : "started",
+      "checkpoint" : "1",
+      "documents_processed" : "705",
+      "checkpoint_progress" : "100.00",
+      "changes_last_detection_time" : null
+    }
+  ]