Add is_hidden parameter for create or update alias API

CHANGELOG.md

@@ -46,6 +46,7 @@ Inspired from [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 - Added missing fields to `/_nodes/stats` ([#415](https://github.com/opensearch-project/opensearch-api-specification/pull/415))
 - Added missing metrics options to `/_nodes/stats` ([#422](https://github.com/opensearch-project/opensearch-api-specification/pull/422))
 - Added tests against OpenSearch 1.3 ([#424](https://github.com/opensearch-project/opensearch-api-specification/pull/424))
+- Add `is_hidden` parameter for create or update alias API
 
 ### Changed
 

spec/namespaces/indices.yaml

@@ -1860,6 +1860,11 @@ components:
                 $ref: '../schemas/_common.yaml#/components/schemas/Routing'
               search_routing:
                 $ref: '../schemas/_common.yaml#/components/schemas/Routing'
+              is_hidden:
+                x-version-added: '2.16'
+                description: |-
+                  If `true`, the alias will be hidden, defaults to `false`.
+                type: boolean
             description: The settings for the alias, such as `routing` or `filter`
     indices.put_index_template:
       content:

tests/indices/create_or_update_alias.yaml

@@ -0,0 +1,42 @@
+$schema: ../../json_schemas/test_story.schema.yaml
+
+description: Test create or update alias endpoints.
+epilogues:
+  - path: /games
+    method: DELETE
+    status: [200, 404]
+prologues:
+  - path: /{index}
+    method: PUT
+    parameters:
+      index: games
+chapters:
+  - synopsis: Create an alias.
+    path: /{index}/_alias/{name}
+    method: PUT
+    parameters:
+      index: games
+      name: jeux
+  - synopsis: Create an alias with custom routing.
+    path: /{index}/_alias/{name}
+    method: PUT
+    parameters:
+      index: games
+      name: jeux
+    request_body:
+      payload:
+        index_routing: test1
+        search_routing: test2
+  - synopsis: Create an alias with custom settings.
+    path: /{index}/_alias/{name}
+    method: PUT
+    parameters:
+      index: games
+      name: jeux
+    request_body:
+      payload:
+        routing: test
+        is_write_index: true
+        is_hidden: true
+        filter:
+          match_all: {}