From e1325fbacdec5aa7d4ecb7617f81ab598697faa7 Mon Sep 17 00:00:00 2001
From: Kristoffer Dalby <kristoffer@dalby.cc>
Date: Wed, 17 Jun 2026 16:00:26 +0000
Subject: [PATCH] serve the OpenAPI 3.0 spec at /swagger

Embed openapi/v1/headscale.yaml and point the Swagger UI at it, replacing the
generated Swagger 2.0 document.
---
 hscontrol/app.go |  2 +-
 swagger.go       | 10 +++++-----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/hscontrol/app.go b/hscontrol/app.go
index ae831a20..d9fe5357 100644
--- a/hscontrol/app.go
+++ b/hscontrol/app.go
@@ -588,7 +588,7 @@ func (h *Headscale) createRouter(apiV1 http.Handler) *chi.Mux {
 
 	// TODO(kristoffer): move swagger into a package
 	r.Get("/swagger", headscale.SwaggerUI)
-	r.Get("/swagger/v1/openapiv2.json", headscale.SwaggerAPIv1)
+	r.Get("/swagger/v1/openapi.yaml", headscale.SwaggerAPIv1)
 
 	r.Post("/verify", h.VerifyHandler)
 
diff --git a/swagger.go b/swagger.go
index 514bbdf7..e3775b17 100644
--- a/swagger.go
+++ b/swagger.go
@@ -9,8 +9,8 @@ import (
 	"github.com/rs/zerolog/log"
 )
 
-//go:embed gen/openapiv2/headscale/v1/headscale.swagger.json
-var apiV1JSON []byte
+//go:embed openapi/v1/headscale.yaml
+var apiV1Spec []byte
 
 func SwaggerUI(
 	writer http.ResponseWriter,
@@ -29,7 +29,7 @@ func SwaggerUI(
 	<script>
 		window.addEventListener('load', (event) => {
 			const ui = SwaggerUIBundle({
-			    url: "/swagger/v1/openapiv2.json",
+			    url: "/swagger/v1/openapi.yaml",
 			    dom_id: '#swagger-ui',
 			    presets: [
 			      SwaggerUIBundle.presets.apis,
@@ -85,10 +85,10 @@ func SwaggerAPIv1(
 	writer http.ResponseWriter,
 	req *http.Request,
 ) {
-	writer.Header().Set("Content-Type", "application/json; charset=utf-8")
+	writer.Header().Set("Content-Type", "application/yaml; charset=utf-8")
 	writer.WriteHeader(http.StatusOK)
 
-	if _, err := writer.Write(apiV1JSON); err != nil { //nolint:noinlineerr
+	if _, err := writer.Write(apiV1Spec); err != nil { //nolint:noinlineerr
 		log.Error().
 			Caller().
 			Err(err).