whitney-coder
diff --git a/‎Makefile
+8-2 b/‎Makefile
+8-2
diff --git a/‎cli/deployment/config.go
+8 b/‎cli/deployment/config.go
+8
diff --git a/‎cli/server.go
+4 b/‎cli/server.go
+4
diff --git a/‎cli/testdata/coder_server_--help.golden
+2 b/‎cli/testdata/coder_server_--help.golden
+2
@@ -410,13 +410,14 @@ gen: \
 	provisionersdk/proto/provisioner.pb.go \
 	provisionerd/proto/provisionerd.pb.go \
 	site/src/api/typesGenerated.ts \
-	docs/admin/prometheus.md
+	docs/admin/prometheus.md \
+	coderd/apidoc/swagger.json
 .PHONY: gen
 
 # Mark all generated files as fresh so make thinks they're up-to-date. This is
 # used during releases so we don't run generation scripts.
 gen/mark-fresh:
-	files="coderd/database/dump.sql coderd/database/querier.go provisionersdk/proto/provisioner.pb.go provisionerd/proto/provisionerd.pb.go site/src/api/typesGenerated.ts docs/admin/prometheus.md"
+	files="coderd/database/dump.sql coderd/database/querier.go provisionersdk/proto/provisioner.pb.go provisionerd/proto/provisionerd.pb.go site/src/api/typesGenerated.ts docs/admin/prometheus.md coderd/apidoc/swagger.json"
 	for file in $$files; do
 		echo "$$file"
 		if [ ! -f "$$file" ]; then
@@ -464,6 +465,11 @@ docs/admin/prometheus.md: scripts/metricsdocgen/main.go scripts/metricsdocgen/me
 	cd site
 	yarn run format:write ../docs/admin/prometheus.md
 
+coderd/apidoc/swagger.json: $(shell find ./scripts/apidocgen -not \( -path './scripts/apidocgen/node_modules' -prune \) -type f) $(wildcard coderd/*.go) $(wildcard codersdk/*.go)
+	./scripts/apidocgen/generate.sh
+	cd site
+	yarn run format:write ../docs/api ../docs/manifest.json ../coderd/apidoc/swagger.json
+
 update-golden-files: cli/testdata/.gen-golden
 .PHONY: update-golden-files
 
 
@@ -452,6 +452,14 @@ func newConfig() *codersdk.DeploymentConfig {
 			Flag:    "max-token-lifetime",
 			Default: 24 * 30 * time.Hour,
 		},
+		Swagger: &codersdk.SwaggerConfig{
+			Enable: &codersdk.DeploymentConfigField[bool]{
+				Name:    "Enable swagger endpoint",
+				Usage:   "Expose the swagger endpoint via /swagger.",
+				Flag:    "swagger-enable",
+				Default: false,
+			},
+		},
 	}
 }
 
 
@@ -678,6 +678,10 @@ func Server(vip *viper.Viper, newAPI func(context.Context, *coderd.Options) (*co
 				), cfg.Prometheus.Address.Value, "prometheus")()
 			}
 
+			if cfg.Swagger.Enable.Value {
+				options.SwaggerEndpoint = cfg.Swagger.Enable.Value
+			}
+
 			// We use a separate coderAPICloser so the Enterprise API
 			// can have it's own close functions. This is cleaner
 			// than abstracting the Coder API itself.
 
@@ -169,6 +169,8 @@ Flags:
                                                      "ecdsa", or "rsa4096".
                                                      Consumes $CODER_SSH_KEYGEN_ALGORITHM
                                                      (default "ed25519")
+      --swagger-enable                               Expose the swagger endpoint via /swagger.
+                                                     Consumes $CODER_SWAGGER_ENABLE
       --telemetry                                    Whether telemetry is enabled or not.
                                                      Coder collects anonymized usage data to
                                                      help improve our product.
Original file line number	Diff line number	Diff line change
`@@ -452,6 +452,14 @@ func newConfig() *codersdk.DeploymentConfig {`
`452`	`452`	`Flag: "max-token-lifetime",`
`453`	`453`	`Default: 24 * 30 * time.Hour,`
`454`	`454`	`},`
	`455`	`+ Swagger: &codersdk.SwaggerConfig{`
	`456`	`+ Enable: &codersdk.DeploymentConfigField[bool]{`
	`457`	`+ Name: "Enable swagger endpoint",`
	`458`	`+ Usage: "Expose the swagger endpoint via /swagger.",`
	`459`	`+ Flag: "swagger-enable",`
	`460`	`+ Default: false,`
	`461`	`+ },`
	`462`	`+ },`
`455`	`463`	`}`
`456`	`464`	`}`
`457`	`465`