diff --git a/src/metabase/api/dashboard.clj b/src/metabase/api/dashboard.clj
index defb929f79c93e111dd2a72484461f810a65fc1d..2be2c8c337da9900927bd99eeb0c73a4d9a3dffe 100644
--- a/src/metabase/api/dashboard.clj
+++ b/src/metabase/api/dashboard.clj
@@ -428,7 +428,9 @@
 ;; be setting `:archived` to `true` via the `PUT` endpoint instead
 #_{:clj-kondo/ignore [:deprecated-var]}
 (api/defendpoint-schema DELETE "/:id"
-  "Delete a Dashboard."
+  "Delete a Dashboard.
+
+  This will remove also any questions/models/segments/metrics that use this database."
   [id]
   (log/warn (str "DELETE /api/dashboard/:id is deprecated. Instead of deleting a Dashboard, you should change its "
                  "`archived` value via PUT /api/dashboard/:id."))