Merge pull request #6595 from DataDog/pb/mon-del-force

[api] [monitors] Add option for force delete.
DataDog · Feb 7, 2020 · 9f9c4c2 · 9f9c4c2
2 parents 3328b64 + ad2b6bd
commit 9f9c4c2
Show file tree

Hide file tree

Showing 3 changed files with 11 additions and 1 deletion.
diff --git a/content/en/api/monitors/code_snippets/api-monitor-delete.py b/content/en/api/monitors/code_snippets/api-monitor-delete.py
@@ -9,3 +9,6 @@
 
 # Delete a monitor
 api.Monitor.delete(2081)
+
+# Force delete a monitor to override warnings
+api.Monitor.delete(2081, force=True)
diff --git a/content/en/api/monitors/code_snippets/api-monitor-delete.sh b/content/en/api/monitors/code_snippets/api-monitor-delete.sh
@@ -8,3 +8,6 @@ monitor_id=<YOUR_MONITOR_ID>
 
 # Delete a monitor
 curl -X DELETE "https://api.datadoghq.com/api/v1/monitor/${monitor_id}?api_key=${api_key}&application_key=${app_key}"
+
+# Force delete a monitor
+curl -X DELETE "https://api.datadoghq.com/api/v1/monitor/${monitor_id}?force=true&api_key=${api_key}&application_key=${app_key}"
diff --git a/content/en/api/monitors/monitors_delete.md b/content/en/api/monitors/monitors_delete.md
@@ -9,4 +9,8 @@ external_redirect: /api/#delete-a-monitor
 
 **ARGUMENTS**:
 
-This endpoint takes no JSON arguments.
+If a monitor is used elsewhere, this endpoint returns an error because the monitor is referenced.
+
+* **`force`** [*optional*, *default*=**False**]:
+
+    Boolean: Force delete the monitor. The monitor is deleted even if it's referenced by other resources (e.g. SLO, composite monitor).