# Create or update a lifecycle policy

**PUT /_ilm/policy/{policy}**

If the specified policy exists, it is replaced and the policy version is incremented.

NOTE: Only the latest version of the policy is stored, you cannot revert to previous versions.

## Required authorization

* Index privileges: `manage`
* Cluster privileges: `manage_ilm`


[About index lifecycle management](https://www.elastic.co/docs/manage-data/lifecycle/index-lifecycle-management/index-lifecycle)

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


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


## Parameters

### Path parameters
- **policy** (string)
  Identifier for the policy.

### 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)

- **policy** (object)



## 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)