diff --git a/docs/sources/http_api/admin.md b/docs/sources/http_api/admin.md
index 950ea4c8202..9c2c6d14b31 100644
--- a/docs/sources/http_api/admin.md
+++ b/docs/sources/http_api/admin.md
@@ -280,14 +280,22 @@ Change password for specific user
 
 ## Pause all alerts
 
-`DELETE /api/admin/pause-all-alerts`
+`POST /api/admin/pause-all-alerts`
 
 **Example Request**:
 
-    DELETE /api/admin/pause-all-alerts HTTP/1.1
+    POST /api/admin/pause-all-alerts HTTP/1.1
     Accept: application/json
     Content-Type: application/json
 
+    {
+      "paused": true
+    }
+
+JSON Body schema:
+
+- **paused** – If true then all alerts are to be paused, false unpauses all alerts.
+
 **Example Response**:
 
     HTTP/1.1 200