Add documentation

x-pack/docs/en/rest-api/watcher/get-settings.asciidoc

@@ -0,0 +1,20 @@
+[role="xpack"]
+[[watcher-api-update-settings]]
+=== Get Watcher index settings
+++++
+<titleabbrev>Get Watcher settings</titleabbrev>
+++++
+
+This API allows a user to retrieve the user-configurable settings for the Watcher internal index (`.watches`). Only a subset of the index settings—those that are use-configurable—will be shown. This includes:
+
+- `index.auto_expand_replias`
+- `index.number_of_replicas`
+
+And example of retrieving the Watcher settings:
+
+[source,console]
+-----------------------------------------------------------
+GET /_watcher/settings
+-----------------------------------------------------------
+
+The configurable settings can be modified using the <<watcher-api-update-settings,Update Watcher index settings>> API.

x-pack/docs/en/rest-api/watcher/update-settings.asciidoc

@@ -0,0 +1,23 @@
+[role="xpack"]
+[[watcher-api-update-settings]]
+=== Update Watcher index settings
+++++
+<titleabbrev>Update Watcher settings</titleabbrev>
+++++
+
+This API allows a user to modify the settings for the Watcher internal index (`.watches`). Only a subset of settings are allowed to by modified. This includes:
+
+- `index.auto_expand_replias`
+- `index.number_of_replicas`
+
+And example of modifying the Watcher settings:
+
+[source,console]
+-----------------------------------------------------------
+PUT /_watcher/settings
+{
+  "index.auto_expand_replicas": "0-4"
+}
+-----------------------------------------------------------
+
+The configurable settings can be retrieved using the <<watcher-api-get-settings,Get Watcher index settings>> API.