# Set upgrade_mode for transform indices

**POST /_transform/set_upgrade_mode**

Sets a cluster wide upgrade_mode setting that prepares transform
indices for an upgrade.
When upgrading your cluster, in some circumstances you must restart your
nodes and reindex your transform indices. In those circumstances,
there must be no transforms running. You can close the transforms,
do the upgrade, then open all the transforms again. Alternatively,
you can use this API to temporarily halt tasks associated with the transforms
and prevent new transforms from opening. You can also use this API
during upgrades that do not require you to reindex your transform
indices, though stopping transforms is not a requirement in that case.
You can see the current value for the upgrade_mode setting by using the get
transform info API.

## Required authorization

* Cluster privileges: `manage_transform`



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


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


## Parameters


### Query parameters
- **enabled** (boolean)
  When `true`, it enables `upgrade_mode` which temporarily halts all
  transform tasks and prohibits new transform tasks from
  starting.
- **timeout** (string)
  The time to wait for the request to be completed.


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