The Vault website is being redesigned to help you find what you are looking for more effectively.

Type '/' to Search

»/sys/step-down

The /sys/step-down endpoint causes the node to give up active status.

»Step Down Leader

This endpoint forces the node to give up active status. If the node does not have active status, this endpoint does nothing. Note that the node will sleep for ten seconds before attempting to grab the active lock again, but if no standby nodes grab the active lock in the interim, the same node may become the active node again. Requires a token with root policy or sudo capability on the path.

MethodPath
POST/sys/step-down

»Sample Request

$ curl \
    --header "X-Vault-Token: ..." \
    --request POST \
    http://127.0.0.1:8200/v1/sys/step-down

$ curl \
    --header "X-Vault-Token: ..." \
    --request POST \
    http://127.0.0.1:8200/v1/sys/step-down