From 41b8d4e40f005a357f76cf6145222913365df47f Mon Sep 17 00:00:00 2001
From: Alexei Znamensky <103110+russoz@users.noreply.github.com>
Date: Wed, 6 May 2026 17:50:49 +1200
Subject: [PATCH] datadog_monitor: deprecate `mute` and `unmute` states
 (#11988)

* feat(datadog_monitor): deprecate mute and unmute states

The Datadog mute/unmute monitor API is deprecated upstream, and the
module's silenced parameter was never correctly wired to the mute
endpoint. Direct users to community.general.datadog_downtime instead.
Planned removal in 15.0.0.

Fixes #1535

* feat(datadog_monitor): add changelog fragment for #11988
---
 ...8-datadog-monitor-deprecate-mute-unmute.yml |  5 +++++
 plugins/modules/datadog_monitor.py             | 18 ++++++++++++++++--
 2 files changed, 21 insertions(+), 2 deletions(-)
 create mode 100644 changelogs/fragments/11988-datadog-monitor-deprecate-mute-unmute.yml

diff --git a/changelogs/fragments/11988-datadog-monitor-deprecate-mute-unmute.yml b/changelogs/fragments/11988-datadog-monitor-deprecate-mute-unmute.yml
new file mode 100644
index 0000000000..74c7ef54ee
--- /dev/null
+++ b/changelogs/fragments/11988-datadog-monitor-deprecate-mute-unmute.yml
@@ -0,0 +1,5 @@
+deprecated_features:
+  - datadog_monitor - the ``mute`` and ``unmute`` states are deprecated and will be removed in
+    community.general 15.0.0; use the ``community.general.datadog_downtime`` module to manage
+    monitor downtimes instead (https://github.com/ansible-collections/community.general/issues/1535,
+    https://github.com/ansible-collections/community.general/pull/11988).
diff --git a/plugins/modules/datadog_monitor.py b/plugins/modules/datadog_monitor.py
index 2ef1bca465..2285a41ba9 100644
--- a/plugins/modules/datadog_monitor.py
+++ b/plugins/modules/datadog_monitor.py
@@ -41,6 +41,8 @@ options:
   state:
     description:
       - The designated state of the monitor.
+      - The values V(mute) and V(unmute) are deprecated since community.general 13.0.0 and will be removed in 15.0.0.
+        Use the M(community.general.datadog_downtime) module to manage monitor downtimes instead.
     required: true
     choices: ['present', 'absent', 'mute', 'unmute']
     type: str
@@ -212,7 +214,7 @@ EXAMPLES = r"""
     api_key: "9775a026f1ca7d1c6c5af9d94d9595a4"
     app_key: "87ce4a24b5553d2e482ea8a8500e71b8ad4554ff"
 
-- name: Mutes a monitor
+- name: Mutes a monitor (deprecated, use community.general.datadog_downtime instead)
   community.general.datadog_monitor:
     name: "Test monitor"
     state: "mute"
@@ -220,7 +222,7 @@ EXAMPLES = r"""
     api_key: "9775a026f1ca7d1c6c5af9d94d9595a4"
     app_key: "87ce4a24b5553d2e482ea8a8500e71b8ad4554ff"
 
-- name: Unmutes a monitor
+- name: Unmutes a monitor (deprecated, use community.general.datadog_downtime instead)
   community.general.datadog_monitor:
     name: "Test monitor"
     state: "unmute"
@@ -322,8 +324,20 @@ def main():
     elif module.params["state"] == "absent":
         delete_monitor(module)
     elif module.params["state"] == "mute":
+        module.deprecate(
+            "The 'mute' state is deprecated and will be removed in community.general 15.0.0. "
+            "Use the community.general.datadog_downtime module to manage monitor downtimes instead.",
+            version="15.0.0",
+            collection_name="community.general",
+        )
         mute_monitor(module)
     elif module.params["state"] == "unmute":
+        module.deprecate(
+            "The 'unmute' state is deprecated and will be removed in community.general 15.0.0. "
+            "Use the community.general.datadog_downtime module to manage monitor downtimes instead.",
+            version="15.0.0",
+            collection_name="community.general",
+        )
         unmute_monitor(module)