elasticsearch/docs/reference/rest-api/watcher/start.asciidoc
Lisa Cawley d9c6b679da
[8.17] [DOCS] More links to new API site (#119380) (#119419)
* [DOCS] More links to new API site (#119380)

* Fix example test failure
2025-01-01 10:06:07 +11:00

60 lines
1.4 KiB
Text

[role="xpack"]
[[watcher-api-start]]
=== Start watch service API
++++
<titleabbrev>Start watch service</titleabbrev>
++++
.New API reference
[sidebar]
--
For the most up-to-date API details, refer to {api-es}/group/endpoint-watcher[{watcher} APIs].
--
Starts the {watcher} service if it is not already running.
[[watcher-api-start-request]]
==== {api-request-title}
`POST _watcher/_start`
[[watcher-api-start-prereqs]]
==== {api-prereq-title}
* You must have `manage_watcher` cluster privileges to use this API. For more
information, see <<security-privileges>>.
//[[watcher-api-start-desc]]
//==== {api-description-title}
//[[watcher-api-start-path-params]]
//==== {api-path-parms-title}
//[[watcher-api-start-query-params]]
//==== {api-query-parms-title}
//[[watcher-api-start-request-body]]
//==== {api-request-body-title}
//[[watcher-api-start-response-body]]
//==== {api-response-body-title}
//[[watcher-api-start-response-codes]]
//==== {api-response-codes-title}
[[watcher-api-start-example]]
==== {api-examples-title}
[source,console]
--------------------------------------------------
POST _watcher/_start
--------------------------------------------------
{watcher} returns the following response if the request is successful:
[source,console-result]
--------------------------------------------------
{
"acknowledged": true
}
--------------------------------------------------