coder
diff --git a/‎coderd/apidoc/docs.go
+8 b/‎coderd/apidoc/docs.go
+8
diff --git a/‎coderd/apidoc/swagger.json
+8 b/‎coderd/apidoc/swagger.json
+8
diff --git a/‎coderd/debug.go
+11-5 b/‎coderd/debug.go
+11-5
diff --git a/‎coderd/debug_test.go
+49-6 b/‎coderd/debug_test.go
+49-6
diff --git a/‎docs/api/debug.md
+6 b/‎docs/api/debug.md
+6
@@ -41,16 +41,22 @@ func (api *API) debugTailnet(rw http.ResponseWriter, r *http.Request) {
 // @Tags Debug
 // @Success 200 {object} healthcheck.Report
 // @Router /debug/health [get]
+// @Param force query boolean false "Force a healthcheck to run"
 func (api *API) debugDeploymentHealth(rw http.ResponseWriter, r *http.Request) {
 	apiKey := httpmw.APITokenFromRequest(r)
 	ctx, cancel := context.WithTimeout(r.Context(), api.Options.HealthcheckTimeout)
 	defer cancel()
 
-	// Get cached report if it exists.
-	if report := api.healthCheckCache.Load(); report != nil {
-		if time.Since(report.Time) < api.Options.HealthcheckRefresh {
-			formatHealthcheck(ctx, rw, r, report)
-			return
+	// Check if the forced query parameter is set.
+	forced := r.URL.Query().Get("force") == "true"
+
+	// Get cached report if it exists and the requester did not force a refresh.
+	if !forced {
+		if report := api.healthCheckCache.Load(); report != nil {
+			if time.Since(report.Time) < api.Options.HealthcheckRefresh {
+				formatHealthcheck(ctx, rw, r, report)
+				return
+			}
 		}
 	}
 
 
@@ -4,6 +4,7 @@ import (
 	"context"
 	"io"
 	"net/http"
+	"sync/atomic"
 	"testing"
 	"time"
 
@@ -22,24 +23,66 @@ func TestDebugHealth(t *testing.T) {
 		t.Parallel()
 
 		var (
+			calls        = atomic.Int64{}
 			ctx, cancel  = context.WithTimeout(context.Background(), testutil.WaitShort)
 			sessionToken string
 			client       = coderdtest.New(t, &coderdtest.Options{
 				HealthcheckFunc: func(_ context.Context, apiKey string) *healthcheck.Report {
+					calls.Add(1)
 					assert.Equal(t, sessionToken, apiKey)
-					return &healthcheck.Report{}
+					return &healthcheck.Report{
+						Time: time.Now(),
+					}
 				},
+				HealthcheckRefresh: time.Hour, // Avoid flakes.
 			})
 			_ = coderdtest.CreateFirstUser(t, client)
 		)
 		defer cancel()
 
 		sessionToken = client.SessionToken()
-		res, err := client.Request(ctx, "GET", "/api/v2/debug/health", nil)
-		require.NoError(t, err)
-		defer res.Body.Close()
-		_, _ = io.ReadAll(res.Body)
-		require.Equal(t, http.StatusOK, res.StatusCode)
+		for i := 0; i < 10; i++ {
+			res, err := client.Request(ctx, "GET", "/api/v2/debug/health", nil)
+			require.NoError(t, err)
+			_, _ = io.ReadAll(res.Body)
+			res.Body.Close()
+			require.Equal(t, http.StatusOK, res.StatusCode)
+		}
+		// The healthcheck should only have been called once.
+		require.EqualValues(t, 1, calls.Load())
+	})
+
+	t.Run("Forced", func(t *testing.T) {
+		t.Parallel()
+
+		var (
+			calls        = atomic.Int64{}
+			ctx, cancel  = context.WithTimeout(context.Background(), testutil.WaitShort)
+			sessionToken string
+			client       = coderdtest.New(t, &coderdtest.Options{
+				HealthcheckFunc: func(_ context.Context, apiKey string) *healthcheck.Report {
+					calls.Add(1)
+					assert.Equal(t, sessionToken, apiKey)
+					return &healthcheck.Report{
+						Time: time.Now(),
+					}
+				},
+				HealthcheckRefresh: time.Hour, // Avoid flakes.
+			})
+			_ = coderdtest.CreateFirstUser(t, client)
+		)
+		defer cancel()
+
+		sessionToken = client.SessionToken()
+		for i := 0; i < 10; i++ {
+			res, err := client.Request(ctx, "GET", "/api/v2/debug/health?force=true", nil)
+			require.NoError(t, err)
+			_, _ = io.ReadAll(res.Body)
+			res.Body.Close()
+			require.Equal(t, http.StatusOK, res.StatusCode)
+		}
+		// The healthcheck func should have been called each time.
+		require.EqualValues(t, 10, calls.Load())
 	})
 
 	t.Run("Timeout", func(t *testing.T) {