diff --git a/coderd/apidoc/docs.go b/coderd/apidoc/docs.go
index 7bfd521b093ce..750cc20998b16 100644
--- a/coderd/apidoc/docs.go
+++ b/coderd/apidoc/docs.go
@@ -5904,6 +5904,7 @@ const docTemplate = `{
                 ],
                 "summary": "Submit workspace agent stats",
                 "operationId": "submit-workspace-agent-stats",
+                "deprecated": true,
                 "parameters": [
                     {
                         "description": "Stats request",
diff --git a/coderd/apidoc/swagger.json b/coderd/apidoc/swagger.json
index c4dabcacaf6ba..4643dc6fcae67 100644
--- a/coderd/apidoc/swagger.json
+++ b/coderd/apidoc/swagger.json
@@ -5201,6 +5201,7 @@
         "tags": ["Agents"],
         "summary": "Submit workspace agent stats",
         "operationId": "submit-workspace-agent-stats",
+        "deprecated": true,
         "parameters": [
           {
             "description": "Stats request",
diff --git a/coderd/workspaceagents.go b/coderd/workspaceagents.go
index 34170b3bf7097..4848fef38c138 100644
--- a/coderd/workspaceagents.go
+++ b/coderd/workspaceagents.go
@@ -1132,6 +1132,7 @@ func convertScripts(dbScripts []database.WorkspaceAgentScript) []codersdk.Worksp
 // @Param request body agentsdk.Stats true "Stats request"
 // @Success 200 {object} agentsdk.StatsResponse
 // @Router /workspaceagents/me/report-stats [post]
+// @Deprecated Uses agent API v2 endpoint instead.
 func (api *API) workspaceAgentReportStats(rw http.ResponseWriter, r *http.Request) {
 	ctx := r.Context()