[Backport 2.18] Add automation for first two CAT APIs

_api-reference/cat/cat-aliases.md

@@ -16,20 +16,37 @@ has_children: false
 The CAT aliases operation lists the mapping of aliases to indexes, plus routing and filtering information.
 
 
-## Endpoints
 
+<!-- spec_insert_start
+api: cat.aliases
+component: endpoints
+-->
+## Endpoints
 ```json
-GET _cat/aliases/<alias>
-GET _cat/aliases
+GET /_cat/aliases
+GET /_cat/aliases/{name}
 ```
-{% include copy-curl.html %}
+<!-- spec_insert_end -->
+
 
+<!-- spec_insert_start
+api: cat.aliases
+component: query_parameters
+columns: Parameter,Type,Description,Default
+include_deprecated: false
+-->
 ## Query parameters
+Parameter | Type | Description | Default
+:--- | :--- | :--- | :---
+`expand_wildcards` | List or String | Expands wildcard expressions to concrete indexes. Combine multiple values with commas. Supported values are `all`, `open`, `closed`, `hidden`, and `none`. | 
+`format` | String | A short version of the `Accept` header, such as `json` or `yaml`. | 
+`h` | List | A comma-separated list of column names to display. | 
+`help` | Boolean | Returns help information. | `false`
+`local` | Boolean | Whether to return information from the local node only instead of from the cluster manager node. | `false`
+`s` | List | A comma-separated list of column names or column aliases to sort by. | 
+`v` | Boolean | Enables verbose mode, which displays column headers. | `false`
+<!-- spec_insert_end -->
 
-Parameter | Type | Description
-:--- | :--- | :---
-local | Boolean | Whether to return information from the local node only instead of from the cluster manager node. Default is `false`.
-expand_wildcards | Enum | Expands wildcard expressions to concrete indexes. Combine multiple values with commas. Supported values are `all`, `open`, `closed`, `hidden`, and `none`. Default is `open`.
 
 ## Example requests
 

_api-reference/cat/cat-allocation.md

@@ -15,20 +15,37 @@ has_children: false
 The CAT allocation operation lists the allocation of disk space for indexes and the number of shards on each node.
 
 
-## Endpoints
 
+<!-- spec_insert_start
+api: cat.allocation
+component: endpoints
+-->
+## Endpoints
 ```json
-GET _cat/allocation?v
-GET _cat/allocation/<node_name>
+GET /_cat/allocation
+GET /_cat/allocation/{node_id}
 ```
+<!-- spec_insert_end -->
 
-## Query parameters
 
-Parameter | Type | Description
-:--- | :--- | :---
-bytes | Byte size | Specify the units for byte size. For example, `7kb` or `6gb`. For more information, see [Supported units]({{site.url}}{{site.baseurl}}/opensearch/units/).
-local | Boolean | Whether to return information from the local node only instead of from the cluster manager node. Default is `false`.
-cluster_manager_timeout | Time | The amount of time to wait for a connection to the cluster manager node. Default is 30 seconds.
+<!-- spec_insert_start
+api: cat.allocation
+component: query_parameters
+columns: Parameter,Type,Description,Default
+include_deprecated: false
+-->
+## Query parameters
+Parameter | Type | Description | Default
+:--- | :--- | :--- | :---
+`bytes` | String | The units used to display byte values. | 
+`cluster_manager_timeout` | String | A timeout for connection to the cluster manager node. | 
+`format` | String | A short version of the HTTP `Accept` header, such as `json` or `yaml`. | 
+`h` | List | A comma-separated list of column names to display. | 
+`help` | Boolean | Returns help information. | `false`
+`local` | Boolean | Returns local information but does not retrieve the state from cluster manager node. | `false`
+`s` | List | A comma-separated list of column names or column aliases to sort by. | 
+`v` | Boolean | Enables verbose mode, which displays column headers. | `false`
+<!-- spec_insert_end -->
 
 ## Example requests
 

_api-reference/cat/cat-cluster_manager.md

@@ -39,4 +39,4 @@ GET _cat/cluster_manager?v
 ```json
 id                     |   host     |     ip     |   node
 ZaIkkUd4TEiAihqJGkp5CA | 172.18.0.3 | 172.18.0.3 | opensearch-node2
-```
+```