OpenSearch/x-pack/docs/en/rest-api/watcher/stop.asciidoc

39 lines
792 B
Plaintext

[role="xpack"]
[[watcher-api-stop]]
=== Stop watch service API
++++
<titleabbrev>Stop watch service</titleabbrev>
++++
Stops the {watcher} service if it is running.
[float]
==== Request
`POST _watcher/_stop`
[float]
==== Authorization
You must have `manage_watcher` cluster privileges to use this API. For more
information, see {xpack-ref}/security-privileges.html[Security Privileges].
[float]
==== Examples
[source,js]
--------------------------------------------------
POST _watcher/_stop
--------------------------------------------------
// CONSOLE
{watcher} returns the following response if the request is successful:
[source,js]
--------------------------------------------------
{
"acknowledged": true
}
--------------------------------------------------
// TESTRESPONSE