diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json
index 48e949ba6e..c375e2ae30 100644
--- a/output/openapi/elasticsearch-openapi.json
+++ b/output/openapi/elasticsearch-openapi.json
@@ -16792,7 +16792,7 @@
           {
             "in": "path",
             "name": "index",
-            "description": "The name of the index to explain",
+            "description": "Comma-separated list of index names to explain",
             "required": true,
             "deprecated": false,
             "schema": {
@@ -138867,7 +138867,7 @@
       "eql.search-index": {
         "in": "path",
         "name": "index",
-        "description": "The name of the index to scope the operation",
+        "description": "Comma-separated list of index names to scope the operation",
         "required": true,
         "deprecated": false,
         "schema": {
diff --git a/output/openapi/elasticsearch-serverless-openapi.json b/output/openapi/elasticsearch-serverless-openapi.json
index e50763b37d..c4f7d1a2c8 100644
--- a/output/openapi/elasticsearch-serverless-openapi.json
+++ b/output/openapi/elasticsearch-serverless-openapi.json
@@ -9015,7 +9015,7 @@
           {
             "in": "path",
             "name": "index",
-            "description": "The name of the index to explain",
+            "description": "Comma-separated list of index names to explain",
             "required": true,
             "deprecated": false,
             "schema": {
@@ -85205,7 +85205,7 @@
       "eql.search-index": {
         "in": "path",
         "name": "index",
-        "description": "The name of the index to scope the operation",
+        "description": "Comma-separated list of index names to scope the operation",
         "required": true,
         "deprecated": false,
         "schema": {
diff --git a/output/schema/schema.json b/output/schema/schema.json
index f070877591..17fe3832ca 100644
--- a/output/schema/schema.json
+++ b/output/schema/schema.json
@@ -141727,7 +141727,7 @@
       },
       "path": [
         {
-          "description": "The name of the index to scope the operation",
+          "description": "Comma-separated list of index names to scope the operation",
           "name": "index",
           "required": true,
           "type": {
@@ -158801,7 +158801,7 @@
       },
       "path": [
         {
-          "description": "The name of the index to explain",
+          "description": "Comma-separated list of index names to explain",
           "name": "index",
           "required": true,
           "type": {
@@ -255228,7 +255228,7 @@
       },
       "path": [
         {
-          "description": "Which node for which to retrieve the shutdown status",
+          "description": "Comma-separated list of nodes for which to retrieve the shutdown status",
           "name": "node_id",
           "required": false,
           "type": {
diff --git a/specification/_json_spec/bulk.json b/specification/_json_spec/bulk.json
index 95dd4f0720..95b44d6367 100644
--- a/specification/_json_spec/bulk.json
+++ b/specification/_json_spec/bulk.json
@@ -41,7 +41,7 @@
         "description": "If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` (the default) then do nothing with refreshes."
       },
       "routing": {
-        "type": "string",
+        "type": "list",
         "description": "Specific routing value"
       },
       "timeout": {
diff --git a/specification/_json_spec/cluster.delete_component_template.json b/specification/_json_spec/cluster.delete_component_template.json
index 19c84afb0c..3c6b52cca5 100644
--- a/specification/_json_spec/cluster.delete_component_template.json
+++ b/specification/_json_spec/cluster.delete_component_template.json
@@ -16,8 +16,8 @@
           "methods": ["DELETE"],
           "parts": {
             "name": {
-              "type": "string",
-              "description": "The name of the template"
+              "type": "list",
+              "description": "Comma-separated list or wildcard expression of component template names used to limit the request."
             }
           }
         }
diff --git a/specification/_json_spec/cluster.exists_component_template.json b/specification/_json_spec/cluster.exists_component_template.json
index cbd6e21f7f..3663a27aee 100644
--- a/specification/_json_spec/cluster.exists_component_template.json
+++ b/specification/_json_spec/cluster.exists_component_template.json
@@ -16,8 +16,8 @@
           "methods": ["HEAD"],
           "parts": {
             "name": {
-              "type": "string",
-              "description": "The name of the template"
+              "type": "list",
+              "description": "Comma-separated list of component template names used to limit the request. Wildcard (*) expressions are supported."
             }
           }
         }
diff --git a/specification/_json_spec/create.json b/specification/_json_spec/create.json
index e472328289..34f5a070c5 100644
--- a/specification/_json_spec/create.json
+++ b/specification/_json_spec/create.json
@@ -41,7 +41,7 @@
         "description": "If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` (the default) then do nothing with refreshes."
       },
       "routing": {
-        "type": "string",
+        "type": "list",
         "description": "Specific routing value"
       },
       "timeout": {
diff --git a/specification/_json_spec/delete.json b/specification/_json_spec/delete.json
index d59aad041b..44027fb5be 100644
--- a/specification/_json_spec/delete.json
+++ b/specification/_json_spec/delete.json
@@ -40,7 +40,7 @@
         "description": "If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` (the default) then do nothing with refreshes."
       },
       "routing": {
-        "type": "string",
+        "type": "list",
         "description": "Specific routing value"
       },
       "timeout": {
diff --git a/specification/_json_spec/eql.search.json b/specification/_json_spec/eql.search.json
index 92dc2d6501..c6951861cb 100644
--- a/specification/_json_spec/eql.search.json
+++ b/specification/_json_spec/eql.search.json
@@ -17,8 +17,8 @@
           "methods": ["GET", "POST"],
           "parts": {
             "index": {
-              "type": "string",
-              "description": "The name of the index to scope the operation"
+              "type": "list",
+              "description": "Comma-separated list of index names to scope the operation"
             }
           }
         }
diff --git a/specification/_json_spec/exists.json b/specification/_json_spec/exists.json
index 93b53476fd..613e113b13 100644
--- a/specification/_json_spec/exists.json
+++ b/specification/_json_spec/exists.json
@@ -47,7 +47,7 @@
         "description": "Refresh the shard containing the document before performing the operation"
       },
       "routing": {
-        "type": "string",
+        "type": "list",
         "description": "Specific routing value"
       },
       "_source": {
diff --git a/specification/_json_spec/exists_source.json b/specification/_json_spec/exists_source.json
index 574a433543..7acfe50999 100644
--- a/specification/_json_spec/exists_source.json
+++ b/specification/_json_spec/exists_source.json
@@ -43,7 +43,7 @@
         "description": "Refresh the shard containing the document before performing the operation"
       },
       "routing": {
-        "type": "string",
+        "type": "list",
         "description": "Specific routing value"
       },
       "_source": {
diff --git a/specification/_json_spec/explain.json b/specification/_json_spec/explain.json
index 53630185d1..ed6fee27e7 100644
--- a/specification/_json_spec/explain.json
+++ b/specification/_json_spec/explain.json
@@ -66,7 +66,7 @@
         "description": "Query in the Lucene query string syntax"
       },
       "routing": {
-        "type": "string",
+        "type": "list",
         "description": "Specific routing value"
       },
       "_source": {
diff --git a/specification/_json_spec/get.json b/specification/_json_spec/get.json
index 776455f993..6eed947cd0 100644
--- a/specification/_json_spec/get.json
+++ b/specification/_json_spec/get.json
@@ -53,7 +53,7 @@
         "description": "Refresh the shard containing the document before performing the operation"
       },
       "routing": {
-        "type": "string",
+        "type": "list",
         "description": "Specific routing value"
       },
       "_source": {
diff --git a/specification/_json_spec/get_source.json b/specification/_json_spec/get_source.json
index 6f784c0f55..04979c3aa6 100644
--- a/specification/_json_spec/get_source.json
+++ b/specification/_json_spec/get_source.json
@@ -43,7 +43,7 @@
         "description": "Refresh the shard containing the document before performing the operation"
       },
       "routing": {
-        "type": "string",
+        "type": "list",
         "description": "Specific routing value"
       },
       "_source": {
diff --git a/specification/_json_spec/graph.explore.json b/specification/_json_spec/graph.explore.json
index f68a153c7e..99772b8363 100644
--- a/specification/_json_spec/graph.explore.json
+++ b/specification/_json_spec/graph.explore.json
@@ -26,7 +26,7 @@
     },
     "params": {
       "routing": {
-        "type": "string",
+        "type": "list",
         "description": "Specific routing value"
       },
       "timeout": {
diff --git a/specification/_json_spec/health_report.json b/specification/_json_spec/health_report.json
index c7011d6b8e..04db608bf8 100644
--- a/specification/_json_spec/health_report.json
+++ b/specification/_json_spec/health_report.json
@@ -20,8 +20,8 @@
           "methods": ["GET"],
           "parts": {
             "feature": {
-              "type": "string",
-              "description": "A feature of the cluster, as returned by the top-level health API"
+              "type": "list",
+              "description": "Comma-separated list of cluster features, as returned by the top-level health report API."
             }
           }
         }
diff --git a/specification/_json_spec/index.json b/specification/_json_spec/index.json
index f8fd38cd40..47a961cb0b 100644
--- a/specification/_json_spec/index.json
+++ b/specification/_json_spec/index.json
@@ -56,7 +56,7 @@
         "description": "If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` (the default) then do nothing with refreshes."
       },
       "routing": {
-        "type": "string",
+        "type": "list",
         "description": "Specific routing value"
       },
       "timeout": {
diff --git a/specification/_json_spec/indices.cancel_migrate_reindex.json b/specification/_json_spec/indices.cancel_migrate_reindex.json
index 1def4916f5..10f86081ab 100644
--- a/specification/_json_spec/indices.cancel_migrate_reindex.json
+++ b/specification/_json_spec/indices.cancel_migrate_reindex.json
@@ -17,8 +17,8 @@
           "methods": ["POST"],
           "parts": {
             "index": {
-              "type": "string",
-              "description": "The index or data stream name"
+              "type": "list",
+              "description": "Comma-separated list of index or data stream names"
             }
           }
         }
diff --git a/specification/_json_spec/indices.delete_index_template.json b/specification/_json_spec/indices.delete_index_template.json
index c8d8ced179..3c0076f6cd 100644
--- a/specification/_json_spec/indices.delete_index_template.json
+++ b/specification/_json_spec/indices.delete_index_template.json
@@ -16,8 +16,8 @@
           "methods": ["DELETE"],
           "parts": {
             "name": {
-              "type": "string",
-              "description": "The name of the template"
+              "type": "list",
+              "description": "Comma-separated list of index template names used to limit the request. Wildcard (*) expressions are supported."
             }
           }
         }
diff --git a/specification/_json_spec/indices.disk_usage.json b/specification/_json_spec/indices.disk_usage.json
index b4a7cf3767..8235ad3869 100644
--- a/specification/_json_spec/indices.disk_usage.json
+++ b/specification/_json_spec/indices.disk_usage.json
@@ -16,8 +16,8 @@
           "methods": ["POST"],
           "parts": {
             "index": {
-              "type": "string",
-              "description": "Comma-separated list of indices or data streams to analyze the disk usage"
+              "type": "list",
+              "description": "Comma-separated list of data streams, indices, and aliases used to limit the request. It\u2019s recommended to execute this API with a single index (or the latest backing index of a data stream) as the API consumes resources significantly."
             }
           }
         }
diff --git a/specification/_json_spec/indices.explain_data_lifecycle.json b/specification/_json_spec/indices.explain_data_lifecycle.json
index cf0aa2a2a5..3f84a3335d 100644
--- a/specification/_json_spec/indices.explain_data_lifecycle.json
+++ b/specification/_json_spec/indices.explain_data_lifecycle.json
@@ -16,8 +16,8 @@
           "methods": ["GET"],
           "parts": {
             "index": {
-              "type": "string",
-              "description": "The name of the index to explain"
+              "type": "list",
+              "description": "Comma-separated list of index names to explain"
             }
           }
         }
diff --git a/specification/_json_spec/indices.field_usage_stats.json b/specification/_json_spec/indices.field_usage_stats.json
index 3ab455d00b..9f66aed2fe 100644
--- a/specification/_json_spec/indices.field_usage_stats.json
+++ b/specification/_json_spec/indices.field_usage_stats.json
@@ -16,8 +16,8 @@
           "methods": ["GET"],
           "parts": {
             "index": {
-              "type": "string",
-              "description": "A comma-separated list of index names; use `_all` or empty string to perform the operation on all indices"
+              "type": "list",
+              "description": "Comma-separated list or wildcard expression of index names used to limit the request."
             }
           }
         }
diff --git a/specification/_json_spec/indices.get_data_stream_mappings.json b/specification/_json_spec/indices.get_data_stream_mappings.json
index a2ab036013..6a999272d5 100644
--- a/specification/_json_spec/indices.get_data_stream_mappings.json
+++ b/specification/_json_spec/indices.get_data_stream_mappings.json
@@ -16,8 +16,8 @@
           "methods": ["GET"],
           "parts": {
             "name": {
-              "type": "string",
-              "description": "Comma-separated list of data streams or data stream patterns"
+              "type": "list",
+              "description": "A comma-separated list of data streams or data stream patterns. Supports wildcards (`*`)."
             }
           }
         }
diff --git a/specification/_json_spec/indices.get_data_stream_settings.json b/specification/_json_spec/indices.get_data_stream_settings.json
index 7a1c25fe7e..0b14e9013b 100644
--- a/specification/_json_spec/indices.get_data_stream_settings.json
+++ b/specification/_json_spec/indices.get_data_stream_settings.json
@@ -16,8 +16,8 @@
           "methods": ["GET"],
           "parts": {
             "name": {
-              "type": "string",
-              "description": "Comma-separated list of data streams or data stream patterns"
+              "type": "list",
+              "description": "A comma-separated list of data streams or data stream patterns. Supports wildcards (`*`)."
             }
           }
         }
diff --git a/specification/_json_spec/indices.get_migrate_reindex_status.json b/specification/_json_spec/indices.get_migrate_reindex_status.json
index 0df7b14fb9..bca72f41d3 100644
--- a/specification/_json_spec/indices.get_migrate_reindex_status.json
+++ b/specification/_json_spec/indices.get_migrate_reindex_status.json
@@ -17,8 +17,8 @@
           "methods": ["GET"],
           "parts": {
             "index": {
-              "type": "string",
-              "description": "The index or data stream name"
+              "type": "list",
+              "description": "Comma-separated list of index or data stream names."
             }
           }
         }
diff --git a/specification/_json_spec/indices.put_data_stream_mappings.json b/specification/_json_spec/indices.put_data_stream_mappings.json
index a5c33f3aac..defbbb6fc1 100644
--- a/specification/_json_spec/indices.put_data_stream_mappings.json
+++ b/specification/_json_spec/indices.put_data_stream_mappings.json
@@ -16,8 +16,8 @@
           "methods": ["PUT"],
           "parts": {
             "name": {
-              "type": "string",
-              "description": "Comma-separated list of data streams or data stream patterns"
+              "type": "list",
+              "description": "A comma-separated list of data streams or data stream patterns."
             }
           }
         }
diff --git a/specification/_json_spec/indices.put_data_stream_settings.json b/specification/_json_spec/indices.put_data_stream_settings.json
index 5ef9932506..1d195977e1 100644
--- a/specification/_json_spec/indices.put_data_stream_settings.json
+++ b/specification/_json_spec/indices.put_data_stream_settings.json
@@ -16,8 +16,8 @@
           "methods": ["PUT"],
           "parts": {
             "name": {
-              "type": "string",
-              "description": "Comma-separated list of data streams or data stream patterns"
+              "type": "list",
+              "description": "A comma-separated list of data streams or data stream patterns."
             }
           }
         }
diff --git a/specification/_json_spec/logstash.get_pipeline.json b/specification/_json_spec/logstash.get_pipeline.json
index b109c37ecd..8425d4e631 100644
--- a/specification/_json_spec/logstash.get_pipeline.json
+++ b/specification/_json_spec/logstash.get_pipeline.json
@@ -20,8 +20,8 @@
           "methods": ["GET"],
           "parts": {
             "id": {
-              "type": "string",
-              "description": "A comma-separated list of Pipeline IDs"
+              "type": "list",
+              "description": "A comma-separated list of pipeline identifiers."
             }
           }
         }
diff --git a/specification/_json_spec/mget.json b/specification/_json_spec/mget.json
index d7dd2b0e9a..f77ffe9c50 100644
--- a/specification/_json_spec/mget.json
+++ b/specification/_json_spec/mget.json
@@ -55,7 +55,7 @@
         "description": "Refresh the shard containing the document before performing the operation"
       },
       "routing": {
-        "type": "string",
+        "type": "list",
         "description": "Specific routing value"
       },
       "_source": {
diff --git a/specification/_json_spec/ml.delete_calendar_job.json b/specification/_json_spec/ml.delete_calendar_job.json
index ec00031677..fa5dcf3c24 100644
--- a/specification/_json_spec/ml.delete_calendar_job.json
+++ b/specification/_json_spec/ml.delete_calendar_job.json
@@ -20,8 +20,8 @@
               "description": "The ID of the calendar to modify"
             },
             "job_id": {
-              "type": "string",
-              "description": "The ID of the job to remove from the calendar"
+              "type": "list",
+              "description": "An identifier for the anomaly detection jobs. It can be a job identifier, a group name, or a comma-separated list of jobs or groups."
             }
           }
         }
diff --git a/specification/_json_spec/ml.get_datafeed_stats.json b/specification/_json_spec/ml.get_datafeed_stats.json
index f89efe2200..8c993d4775 100644
--- a/specification/_json_spec/ml.get_datafeed_stats.json
+++ b/specification/_json_spec/ml.get_datafeed_stats.json
@@ -16,8 +16,8 @@
           "methods": ["GET"],
           "parts": {
             "datafeed_id": {
-              "type": "string",
-              "description": "The ID of the datafeeds stats to fetch"
+              "type": "list",
+              "description": "Comma-separated list of datafeed identifiers or wildcard expressions. If you do not specify one of these options, the API returns information about all datafeeds."
             }
           }
         },
diff --git a/specification/_json_spec/ml.get_datafeeds.json b/specification/_json_spec/ml.get_datafeeds.json
index dc33d432ff..375ff1945d 100644
--- a/specification/_json_spec/ml.get_datafeeds.json
+++ b/specification/_json_spec/ml.get_datafeeds.json
@@ -16,8 +16,8 @@
           "methods": ["GET"],
           "parts": {
             "datafeed_id": {
-              "type": "string",
-              "description": "The ID of the datafeeds to fetch"
+              "type": "list",
+              "description": "Identifier for the datafeed. It can be a datafeed identifier or a wildcard expression. If you do not specify one of these options, the API returns information about all datafeeds."
             }
           }
         },
diff --git a/specification/_json_spec/ml.get_filters.json b/specification/_json_spec/ml.get_filters.json
index 089026f476..4400ccad7b 100644
--- a/specification/_json_spec/ml.get_filters.json
+++ b/specification/_json_spec/ml.get_filters.json
@@ -20,8 +20,8 @@
           "methods": ["GET"],
           "parts": {
             "filter_id": {
-              "type": "string",
-              "description": "The ID of the filter to fetch"
+              "type": "list",
+              "description": "Comma-separated list of strings that uniquely identify a filter."
             }
           }
         }
diff --git a/specification/_json_spec/ml.get_jobs.json b/specification/_json_spec/ml.get_jobs.json
index 0b2528684a..c7eddba14c 100644
--- a/specification/_json_spec/ml.get_jobs.json
+++ b/specification/_json_spec/ml.get_jobs.json
@@ -16,8 +16,8 @@
           "methods": ["GET"],
           "parts": {
             "job_id": {
-              "type": "string",
-              "description": "The ID of the jobs to fetch"
+              "type": "list",
+              "description": "Comma-separated list of identifiers for the anomaly detection job. It can be a job identifier, a group name, or a wildcard expression. If you do not specify one of these options, the API returns information for all anomaly detection jobs."
             }
           }
         },
diff --git a/specification/_json_spec/ml.get_trained_models.json b/specification/_json_spec/ml.get_trained_models.json
index 4663e5047c..92d7fce263 100644
--- a/specification/_json_spec/ml.get_trained_models.json
+++ b/specification/_json_spec/ml.get_trained_models.json
@@ -16,8 +16,8 @@
           "methods": ["GET"],
           "parts": {
             "model_id": {
-              "type": "string",
-              "description": "The ID of the trained models to fetch"
+              "type": "list",
+              "description": "The unique identifier of the trained model or a model alias.  You can get information for multiple trained models in a single API request by using a comma-separated list of model IDs or a wildcard expression."
             }
           }
         },
diff --git a/specification/_json_spec/ml.get_trained_models_stats.json b/specification/_json_spec/ml.get_trained_models_stats.json
index 41f5f40180..a7cf944c6e 100644
--- a/specification/_json_spec/ml.get_trained_models_stats.json
+++ b/specification/_json_spec/ml.get_trained_models_stats.json
@@ -16,8 +16,8 @@
           "methods": ["GET"],
           "parts": {
             "model_id": {
-              "type": "string",
-              "description": "The ID of the trained models stats to fetch"
+              "type": "list",
+              "description": "The unique identifier of the trained model or a model alias. It can be a comma-separated list or a wildcard expression."
             }
           }
         },
diff --git a/specification/_json_spec/ml.put_calendar_job.json b/specification/_json_spec/ml.put_calendar_job.json
index 6854146dcf..abd94ae67a 100644
--- a/specification/_json_spec/ml.put_calendar_job.json
+++ b/specification/_json_spec/ml.put_calendar_job.json
@@ -20,8 +20,8 @@
               "description": "The ID of the calendar to modify"
             },
             "job_id": {
-              "type": "string",
-              "description": "The ID of the job to add to the calendar"
+              "type": "list",
+              "description": "An identifier for the anomaly detection jobs. It can be a job identifier, a group name, or a comma-separated list of jobs or groups."
             }
           }
         }
diff --git a/specification/_json_spec/mtermvectors.json b/specification/_json_spec/mtermvectors.json
index cd0654c3b4..a0285d44db 100644
--- a/specification/_json_spec/mtermvectors.json
+++ b/specification/_json_spec/mtermvectors.json
@@ -67,7 +67,7 @@
         "description": "Specify the node or shard the operation should be performed on (default: random) .Applies to all returned documents unless otherwise specified in body \"params\" or \"docs\"."
       },
       "routing": {
-        "type": "string",
+        "type": "list",
         "description": "Specific routing value. Applies to all returned documents unless otherwise specified in body \"params\" or \"docs\"."
       },
       "realtime": {
diff --git a/specification/_json_spec/open_point_in_time.json b/specification/_json_spec/open_point_in_time.json
index 87061ffb38..a8e098098b 100644
--- a/specification/_json_spec/open_point_in_time.json
+++ b/specification/_json_spec/open_point_in_time.json
@@ -30,7 +30,7 @@
         "description": "Specify the node or shard the operation should be performed on (default: random)"
       },
       "routing": {
-        "type": "string",
+        "type": "list",
         "description": "Specific routing value"
       },
       "ignore_unavailable": {
diff --git a/specification/_json_spec/rollup.get_rollup_index_caps.json b/specification/_json_spec/rollup.get_rollup_index_caps.json
index b6abb6cd9b..77fdf4df8f 100644
--- a/specification/_json_spec/rollup.get_rollup_index_caps.json
+++ b/specification/_json_spec/rollup.get_rollup_index_caps.json
@@ -20,8 +20,8 @@
           "methods": ["GET"],
           "parts": {
             "index": {
-              "type": "string",
-              "description": "The rollup index or index pattern to obtain rollup capabilities from."
+              "type": "list",
+              "description": "Comma-separated list of data streams or indices to check for rollup capabilities. Wildcard (`*`) expressions are supported."
             }
           }
         }
diff --git a/specification/_json_spec/search_shards.json b/specification/_json_spec/search_shards.json
index f37b96535c..d00b5411c9 100644
--- a/specification/_json_spec/search_shards.json
+++ b/specification/_json_spec/search_shards.json
@@ -33,7 +33,7 @@
         "description": "Specify the node or shard the operation should be performed on (default: random)"
       },
       "routing": {
-        "type": "string",
+        "type": "list",
         "description": "Specific routing value"
       },
       "local": {
diff --git a/specification/_json_spec/security.delete_privileges.json b/specification/_json_spec/security.delete_privileges.json
index 4c6e3d5da6..856b2d9b9c 100644
--- a/specification/_json_spec/security.delete_privileges.json
+++ b/specification/_json_spec/security.delete_privileges.json
@@ -20,8 +20,8 @@
               "description": "Application name"
             },
             "name": {
-              "type": "string",
-              "description": "Privilege name"
+              "type": "list",
+              "description": "Comma-separated list of privilege names."
             }
           }
         }
diff --git a/specification/_json_spec/security.get_privileges.json b/specification/_json_spec/security.get_privileges.json
index 97d5715616..72f74b32a3 100644
--- a/specification/_json_spec/security.get_privileges.json
+++ b/specification/_json_spec/security.get_privileges.json
@@ -34,8 +34,8 @@
               "description": "Application name"
             },
             "name": {
-              "type": "string",
-              "description": "Privilege name"
+              "type": "list",
+              "description": "Comma-separated list of privilege names. If you do not specify this parameter, the API returns information about all privileges for the requested application."
             }
           }
         }
diff --git a/specification/_json_spec/shutdown.get_node.json b/specification/_json_spec/shutdown.get_node.json
index 110b8d6c50..b9b83cb6c1 100644
--- a/specification/_json_spec/shutdown.get_node.json
+++ b/specification/_json_spec/shutdown.get_node.json
@@ -21,8 +21,8 @@
           "methods": ["GET"],
           "parts": {
             "node_id": {
-              "type": "string",
-              "description": "Which node for which to retrieve the shutdown status"
+              "type": "list",
+              "description": "Comma-separated list of nodes for which to retrieve the shutdown status"
             }
           }
         }
diff --git a/specification/_json_spec/snapshot.repository_verify_integrity.json b/specification/_json_spec/snapshot.repository_verify_integrity.json
index b3eae64af0..428e61fe92 100644
--- a/specification/_json_spec/snapshot.repository_verify_integrity.json
+++ b/specification/_json_spec/snapshot.repository_verify_integrity.json
@@ -16,8 +16,8 @@
           "methods": ["POST"],
           "parts": {
             "repository": {
-              "type": "string",
-              "description": "A repository name"
+              "type": "list",
+              "description": "Comma-separated list of snapshot repository names."
             }
           }
         }
diff --git a/specification/_json_spec/termvectors.json b/specification/_json_spec/termvectors.json
index 8037e04099..3d0009610c 100644
--- a/specification/_json_spec/termvectors.json
+++ b/specification/_json_spec/termvectors.json
@@ -73,7 +73,7 @@
         "description": "Specify the node or shard the operation should be performed on (default: random)."
       },
       "routing": {
-        "type": "string",
+        "type": "list",
         "description": "Specific routing value."
       },
       "realtime": {
diff --git a/specification/_json_spec/transform.get_transform.json b/specification/_json_spec/transform.get_transform.json
index b9791d415b..52022db3f9 100644
--- a/specification/_json_spec/transform.get_transform.json
+++ b/specification/_json_spec/transform.get_transform.json
@@ -16,8 +16,8 @@
           "methods": ["GET"],
           "parts": {
             "transform_id": {
-              "type": "string",
-              "description": "The id or comma delimited list of id expressions of the transforms to get, '_all' or '*' implies get all transforms"
+              "type": "list",
+              "description": "Comma-separated list of transform identifiers or wildcard expressions. You can get information for all transforms by using `_all`, by specifying `*` as the `<transform_id>`, or by omitting the `<transform_id>`."
             }
           }
         },
diff --git a/specification/_json_spec/transform.get_transform_stats.json b/specification/_json_spec/transform.get_transform_stats.json
index 8985eecfef..15b08cb4d9 100644
--- a/specification/_json_spec/transform.get_transform_stats.json
+++ b/specification/_json_spec/transform.get_transform_stats.json
@@ -16,8 +16,8 @@
           "methods": ["GET"],
           "parts": {
             "transform_id": {
-              "type": "string",
-              "description": "The id of the transform for which to get stats. '_all' or '*' implies all transforms"
+              "type": "list",
+              "description": "Comma-separated list of transform identifiers or wildcard expressions. You can get information for all transforms by using `_all`, by specifying `*` as the `<transform_id>`, or by omitting the `<transform_id>`."
             }
           }
         }
diff --git a/specification/_json_spec/update.json b/specification/_json_spec/update.json
index 7fd6785106..8956187a2b 100644
--- a/specification/_json_spec/update.json
+++ b/specification/_json_spec/update.json
@@ -64,7 +64,7 @@
         "description": "Specify how many times should the operation be retried when a conflict occurs (default: 0)"
       },
       "routing": {
-        "type": "string",
+        "type": "list",
         "description": "Specific routing value"
       },
       "timeout": {
diff --git a/specification/package-lock.json b/specification/package-lock.json
index dd53efddba..edb05d78ec 100644
--- a/specification/package-lock.json
+++ b/specification/package-lock.json
@@ -19,6 +19,7 @@
       "license": "Apache-2.0",
       "dependencies": {
         "@typescript-eslint/utils": "^8.32.1",
+        "markdownlint": "^0.39.0",
         "typescript": "^5.8.3"
       },
       "devDependencies": {