open-vault/website/source/docs/http/sys-step-down.html.md

layout	page_title	sidebar_current	description
http	HTTP API: /sys/step-down	docs-http-ha-step-down	The '/sys/step-down' endpoint causes the node to give up active status.

/sys/step-down

Description

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.

Method

PUT

Parameters

None

Returns

A `204` response code.