> For the complete documentation index, see [llms.txt](https://docs.dispach.moeenmahmud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispach.moeenmahmud.com/reference/http/dispach-agent-server/switch-an-agent-off-durably-and-drop-it-from-this-host-now.md).

# Switch an agent off durably and drop it from this host now.

```json
{"openapi":"3.1.0","info":{"title":"Dispach agent server","version":"0.1.3"},"servers":[{"url":"http://localhost:7420","description":"Local server. Replace this with the URL of your deployment."}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"An operator key or the configured token."}}},"paths":{"/v1/agents/{id}/stop":{"post":{"summary":"Switch an agent off durably and drop it from this host now.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"401":{"description":"No credential, or one this server does not accept."},"404":{"description":"No such agent, or it is switched off."},"409":{"description":"a turn is running"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"reason":{"code":"agent_stop_invalid","hint":"A short note, recorded on the row and shown wherever the agent is reported as off.","description":"Why, for whoever reads the listing later.","type":"string"}}}}}}}}}}
```