OpenSearch/x-pack/docs/en/watcher/java/delete-watch.asciidoc

[float]
[[api-java-delete-watch]]
=== Delete watch API

The delete watch API removes a watch (identified by its `id`) from {watcher}.
Once removed, the document representing the watch in the `.watches` index is
gone and it will never be executed again.

Please note that deleting a watch **does not** delete any watch execution records
related to this watch from the watch history.

IMPORTANT:  Deleting a watch must be done via this API only. Do not delete the
            watch directly from the `.watches` index using Elasticsearch's DELETE
            Document API. If the {es} {security-features} are enabled, make sure
            no `write` privileges are granted to anyone over the `.watches` index.

The following example deletes a watch with the `my-watch` id:

[source,java]
--------------------------------------------------
DeleteWatchResponse deleteWatchResponse = watcherClient.prepareDeleteWatch("my-watch").get();
--------------------------------------------------