# Create or update an alias


**POST /{index}/_aliases/{name}**

**All methods and paths for this operation:**

<div>
                      <span class="operation-verb put">PUT</span>
                      <span class="operation-path">/{index}/_alias/{name}</span>
                      </div>
                    <div>
                      <span class="operation-verb post">POST</span>
                      <span class="operation-path">/{index}/_alias/{name}</span>
                      </div>
                    <div>
                      <span class="operation-verb put">PUT</span>
                      <span class="operation-path">/{index}/_aliases/{name}</span>
                      </div>
                    <div>
                      <span class="operation-verb post">POST</span>
                      <span class="operation-path">/{index}/_aliases/{name}</span>
                      </div>
                    

Adds a data stream or index to an alias.

[Aliases](https://www.elastic.co/docs/manage-data/data-store/aliases)

## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Api key auth
- Basic auth
- Bearer auth


## Parameters

### Path parameters
- **index** (string | array[string])
  Comma-separated list of data streams or indices to add.
  Supports wildcards (`*`).
  Wildcard patterns that match both data streams and indices return an error.
- **name** (string)
  Alias to update.
  If the alias doesn’t exist, the request creates it.
  Index alias names support date math.

### Query parameters
- **master_timeout** (string)
  Period to wait for a connection to the master node.
  If no response is received before the timeout expires, the request fails and returns an error.
- **timeout** (string)
  Period to wait for a response.
  If no response is received before the timeout expires, the request fails and returns an error.

### Body: application/json (object)

- **filter** (object)
  Query used to limit documents the alias can access.
- **index_routing** (string)
  Value used to route indexing operations to a specific shard.
  If specified, this overwrites the `routing` value for indexing operations.
  Data stream aliases don’t support this parameter.
- **is_write_index** (boolean)
  If `true`, sets the write index or data stream for the alias.
  If an alias points to multiple indices or data streams and `is_write_index` isn’t set, the alias rejects write requests.
  If an index alias points to one index and `is_write_index` isn’t set, the index automatically acts as the write index.
  Data stream aliases don’t automatically set a write data stream, even if the alias points to one data stream.
- **routing** (string)
  Value used to route indexing and search operations to a specific shard.
  Data stream aliases don’t support this parameter.
- **search_routing** (string)
  Value used to route search operations to a specific shard.
  If specified, this overwrites the `routing` value for search operations.
  Data stream aliases don’t support this parameter.


## Responses
### 200


#### Body: application/json (object)
- **acknowledged** (boolean)
  For a successful response, this value is always true. On failure, an exception is returned instead.


[Powered by Bump.sh](https://bump.sh)