# Elastic Stack (ELK Stack) Watcher API

**Canonical:** https://apis.io/apis/elk-stack/elk-stack-watcher-api/  
**Provider:** Elastic Stack (ELK Stack) — https://apis.io/providers/elk-stack/  
**Base URL:** https://{elasticsearch_endpoint}  
**Documentation:** https://www.elastic.co/docs/api/doc/elasticsearch/

Elastic Stack (ELK Stack) Watcher API is one of 132 APIs that [Elastic Stack (ELK Stack)](https://apis.io/providers/elk-stack/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Watcher. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

The watcher API from Elastic Stack (ELK Stack) — 13 operation(s) for watcher.

## Operations (24)

| Method | Path | Summary |
|---|---|---|
| PUT | `/_watcher/watch/{watch_id}/_ack` | Acknowledge a watch |
| POST | `/_watcher/watch/{watch_id}/_ack` | Acknowledge a watch |
| PUT | `/_watcher/watch/{watch_id}/_ack/{action_id}` | Acknowledge a watch |
| POST | `/_watcher/watch/{watch_id}/_ack/{action_id}` | Acknowledge a watch |
| PUT | `/_watcher/watch/{watch_id}/_activate` | Activate a watch |
| POST | `/_watcher/watch/{watch_id}/_activate` | Activate a watch |
| PUT | `/_watcher/watch/{watch_id}/_deactivate` | Deactivate a watch |
| POST | `/_watcher/watch/{watch_id}/_deactivate` | Deactivate a watch |
| GET | `/_watcher/watch/{id}` | Get a watch |
| PUT | `/_watcher/watch/{id}` | Create or update a watch |
| POST | `/_watcher/watch/{id}` | Create or update a watch |
| DELETE | `/_watcher/watch/{id}` | Delete a watch |
| PUT | `/_watcher/watch/{id}/_execute` | Run a watch |
| POST | `/_watcher/watch/{id}/_execute` | Run a watch |
| PUT | `/_watcher/watch/_execute` | Run a watch |
| POST | `/_watcher/watch/_execute` | Run a watch |
| GET | `/_watcher/settings` | Get Watcher index settings |
| PUT | `/_watcher/settings` | Update Watcher index settings |
| GET | `/_watcher/_query/watches` | Query watches |
| POST | `/_watcher/_query/watches` | Query watches |
| POST | `/_watcher/_start` | Start the watch service |
| GET | `/_watcher/stats` | Get Watcher statistics |
| GET | `/_watcher/stats/{metric}` | Get Watcher statistics |
| POST | `/_watcher/_stop` | Stop the watch service |

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/elk-stack/refs/heads/main/openapi/elk-stack-watcher-api-openapi.yml
- **Documentation** — https://www.elastic.co/docs/reference/elasticsearch
- **APIReference** — https://www.elastic.co/docs/api/doc/elasticsearch/
- **SourceCode** — https://github.com/elastic/elasticsearch-specification
- **Documentation** — https://www.elastic.co/docs/reference/kibana
- **APIReference** — https://www.elastic.co/docs/api/doc/kibana/
- **SourceCode** — https://github.com/elastic/kibana
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/elk-stack/refs/heads/main/mcp/elk-stack-tool-crosswalk.yml

## Other Elastic Stack (ELK Stack) APIs (12)

- [Elastic Cloud API](https://apis.io/apis/elk-stack/elastic-cloud-api/)
- [Elastic Stack (ELK Stack) Accounts API](https://apis.io/apis/elk-stack/elk-stack-accounts-api/)
- [Elastic Stack (ELK Stack) Actions API](https://apis.io/apis/elk-stack/elk-stack-actions-api/)
- [Elastic Stack (ELK Stack) agent builder API](https://apis.io/apis/elk-stack/elk-stack-agent-builder-api/)
- [Elastic Stack (ELK Stack) Alerting API](https://apis.io/apis/elk-stack/elk-stack-alerting-api/)
- [Elastic Stack (ELK Stack) Alerting V2 API](https://apis.io/apis/elk-stack/elk-stack-alerting-v2-api/)
- [Elastic Stack (ELK Stack) Analytics API](https://apis.io/apis/elk-stack/elk-stack-analytics-api/)
- [Elastic Stack (ELK Stack) APM agent configuration API](https://apis.io/apis/elk-stack/elk-stack-apm-agent-configuration-api/)
- [Elastic Stack (ELK Stack) APM agent keys API](https://apis.io/apis/elk-stack/elk-stack-apm-agent-keys-api/)
- [Elastic Stack (ELK Stack) APM annotations API](https://apis.io/apis/elk-stack/elk-stack-apm-annotations-api/)
- [Elastic Stack (ELK Stack) APM server schema API](https://apis.io/apis/elk-stack/elk-stack-apm-server-schema-api/)
- [Elastic Stack (ELK Stack) APM sourcemaps API](https://apis.io/apis/elk-stack/elk-stack-apm-sourcemaps-api/)

## Tags

Watcher

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/elk-stack/elk-stack-watcher-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/elk-stack/.