github.com/dkerwin/nomad@v0.3.3-0.20160525181927-74554135514b/website/source/docs/http/agent-force-leave.html.md (about) 1 --- 2 layout: "http" 3 page_title: "HTTP API: /v1/agent/force-leave" 4 sidebar_current: "docs-http-agent-force-leave" 5 description: |- 6 The '/1/agent/force-leave' endpoint is force a gossip member to leave. 7 --- 8 9 # /v1/agent/force-leave 10 11 The `force-leave` endpoint is used to force a member of the gossip pool from 12 the "failed" state into the "left" state. This allows the consensus protocol to 13 remove the peer and stop attempting replication. This is only applicable for 14 servers. 15 16 ## PUT / POST 17 18 <dl> 19 <dt>Description</dt> 20 <dd> 21 Force a failed gossip member into the left state. 22 </dd> 23 24 <dt>Method</dt> 25 <dd>PUT or POST</dd> 26 27 <dt>URL</dt> 28 <dd>`/v1/agent/force-leave`</dd> 29 30 <dt>Parameters</dt> 31 <dd> 32 <ul> 33 <li> 34 <span class="param">node</span> 35 <span class="param-flags">required</span> 36 The name of the node to force leave. 37 </li> 38 </ul> 39 </dd> 40 41 <dt>Returns</dt> 42 <dd> 43 44 A `200` status code on success. 45 </dd> 46 </dl> 47