diff --git a/website/source/docs/agent/http/agent.html.markdown b/website/source/docs/agent/http/agent.html.markdown index 1f065cba72..166cc954b2 100644 --- a/website/source/docs/agent/http/agent.html.markdown +++ b/website/source/docs/agent/http/agent.html.markdown @@ -220,10 +220,11 @@ The return code is 200 on success. ### /v1/agent/maintenance -The node maintenance endpoint can place the agent into "maintenance mode". -During maintenance mode, the node will be marked as unavailable and will not be -present in DNS or API queries. This API call is idempotent. Maintenance mode is -persistent and will be automatically restored on agent restart. +The node maintenance endpoint is hit with a PUT and is used to place the agent +into "maintenance mode". During maintenance mode, the node will be marked as +unavailable and will not be present in DNS or API queries. This API call is +idempotent. Maintenance mode is persistent and will be automatically restored +on agent restart. The `?enable` flag is required. Acceptable values are either `true` (to enter maintenance mode) or `false` (to resume normal operation).