coder · spikecurtis · Dec 8, 2023 · Dec 6, 2023
diff --git a/coderd/apidoc/docs.go b/coderd/apidoc/docs.go
diff --git a/coderd/apidoc/swagger.json b/coderd/apidoc/swagger.json
diff --git a/coderd/deployment.go b/coderd/deployment.go
@@ -71,10 +71,11 @@ func (api *API) deploymentStats(rw http.ResponseWriter, r *http.Request) {
 func buildInfo(accessURL *url.URL) http.HandlerFunc {
 	return func(rw http.ResponseWriter, r *http.Request) {
 		httpapi.Write(r.Context(), rw, http.StatusOK, codersdk.BuildInfoResponse{
-			ExternalURL:    buildinfo.ExternalURL(),
-			Version:        buildinfo.Version(),
-			DashboardURL:   accessURL.String(),
-			WorkspaceProxy: false,
+			ExternalURL:     buildinfo.ExternalURL(),
+			Version:         buildinfo.Version(),
+			AgentAPIVersion: AgentAPIVersionREST,
+			DashboardURL:    accessURL.String(),
+			WorkspaceProxy:  false,
 		})
 	}
 }

diff --git a/codersdk/deployment.go b/codersdk/deployment.go
@@ -2003,6 +2003,10 @@ type BuildInfoResponse struct {
 	DashboardURL string `json:"dashboard_url"`
 
 	WorkspaceProxy bool `json:"workspace_proxy"`
+
+	// AgentAPIVersion is the current version of the Agent API (back versions
+	// MAY still be supported).
+	AgentAPIVersion string `json:"agent_api_version"`
 }
 
 type WorkspaceProxyBuildInfo struct {

diff --git a/docs/api/general.md b/docs/api/general.md
diff --git a/docs/api/schemas.md b/docs/api/schemas.md
diff --git a/enterprise/wsproxy/wsproxy.go b/enterprise/wsproxy/wsproxy.go
@@ -475,10 +475,11 @@ func (s *Server) DialCoordinator(ctx context.Context) (tailnet.MultiAgentConn, e
 
 func (s *Server) buildInfo(rw http.ResponseWriter, r *http.Request) {
 	httpapi.Write(r.Context(), rw, http.StatusOK, codersdk.BuildInfoResponse{
-		ExternalURL:    buildinfo.ExternalURL(),
-		Version:        buildinfo.Version(),
-		DashboardURL:   s.DashboardURL.String(),
-		WorkspaceProxy: true,
+		ExternalURL:     buildinfo.ExternalURL(),
+		Version:         buildinfo.Version(),
+		AgentAPIVersion: coderd.AgentAPIVersionREST,
+		DashboardURL:    s.DashboardURL.String(),
+		WorkspaceProxy:  true,
 	})
 }
 

diff --git a/site/src/api/typesGenerated.ts b/site/src/api/typesGenerated.ts
diff --git a/site/src/testHelpers/entities.ts b/site/src/testHelpers/entities.ts
@@ -194,6 +194,7 @@ export const MockProxyLatencies: Record<string, ProxyLatencyReport> = {
 };
 
 export const MockBuildInfo: TypesGen.BuildInfoResponse = {
+  agent_api_version: "2.1",
   external_url: "file:///mock-url",
   version: "v99.999.9999+c9cdf14",
   dashboard_url: "https:///mock-url",