coder
diff --git a/‎coderd/apidoc/docs.go
+628-270 b/‎coderd/apidoc/docs.go
+628-270
diff --git a/‎coderd/apidoc/swagger.json
+567-247 b/‎coderd/apidoc/swagger.json
+567-247
diff --git a/‎coderd/apikey.go
+2-2 b/‎coderd/apikey.go
+2-2
diff --git a/‎coderd/audit.go
+1-1 b/‎coderd/audit.go
+1-1
diff --git a/‎coderd/coderdtest/swagger_test.go
+66 b/‎coderd/coderdtest/swagger_test.go
+66
@@ -29,6 +29,7 @@ import (
 // @Summary Create token API key
 // @ID create-token-api-key
 // @Security CoderSessionToken
+// @Accept json
 // @Produce json
 // @Tags Users
 // @Param user path string true "User ID, name, or me"
@@ -209,9 +210,8 @@ func (api *API) tokens(rw http.ResponseWriter, r *http.Request) {
 }
 
 // @Summary Delete API key
-// @ID delete-user-tokens
+// @ID delete-api-key
 // @Security CoderSessionToken
-// @Produce json
 // @Tags Users
 // @Param user path string true "User ID, name, or me"
 // @Param keyid path string true "Key ID" format(uuid)
 
@@ -89,7 +89,7 @@ func (api *API) auditLogs(rw http.ResponseWriter, r *http.Request) {
 }
 
 // @Summary Generate fake audit log
-// @ID generate-fake-audit-logs
+// @ID generate-fake-audit-log
 // @Security CoderSessionToken
 // @Accept json
 // @Tags Audit
 
@@ -0,0 +1,66 @@
+package coderdtest_test
+
+import (
+	"go/ast"
+	"go/parser"
+	"go/token"
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	"github.com/coder/coder/coderd/coderdtest"
+)
+
+func TestEndpointsDocumented(t *testing.T) {
+	t.Parallel()
+
+	swaggerComments, err := coderdtest.ParseSwaggerComments("..")
+	require.NoError(t, err, "can't parse swagger comments")
+
+	_, _, api := coderdtest.NewWithAPI(t, nil)
+	coderdtest.VerifySwaggerDefinitions(t, api.APIHandler, swaggerComments)
+}
+
+func TestSDKFieldsFormatted(t *testing.T) {
+	t.Parallel()
+
+	fileSet := token.NewFileSet()
+	nodes, err := parser.ParseDir(fileSet, "../../codersdk", nil, parser.ParseComments)
+	require.NoError(t, err, "parser.ParseDir failed")
+
+	for _, node := range nodes {
+		ast.Inspect(node, func(n ast.Node) bool {
+			typeSpec, ok := n.(*ast.TypeSpec)
+			if !ok {
+				return true
+			}
+			structureName := typeSpec.Name
+
+			structType, ok := typeSpec.Type.(*ast.StructType)
+			if !ok {
+				return true // not a structure
+			}
+
+			for _, field := range structType.Fields.List {
+				selectorExpr, ok := field.Type.(*ast.SelectorExpr)
+				if !ok {
+					continue // rather a basic, or primitive
+				}
+
+				if field.Tag == nil || !strings.Contains(field.Tag.Value, `json:"`) {
+					continue // not a JSON property
+				}
+
+				switch selectorExpr.Sel.Name {
+				case "UUID":
+					assert.Contains(t, field.Tag.Value, `format:"uuid"`, `Swagger formatting requires to annotate the field with - format:"uuid". Location: %s/%s`, structureName, field.Names)
+				case "Time":
+					assert.Contains(t, field.Tag.Value, `format:"date-time"`, `Swagger formatting requires to annotate the field with - format:"date-time". Location: %s/%s`, structureName, field.Names)
+				}
+			}
+			return true
+		})
+	}
+}
Original file line number	Diff line number	Diff line change
`@@ -89,7 +89,7 @@ func (api API) auditLogs(rw http.ResponseWriter, r http.Request) {`
`89`	`89`	`}`
`90`	`90`
`91`	`91`	`// @Summary Generate fake audit log`
`92`		`-// @ID generate-fake-audit-logs`
	`92`	`+// @ID generate-fake-audit-log`
`93`	`93`	`// @Security CoderSessionToken`
`94`	`94`	`// @Accept json`
`95`	`95`	`// @Tags Audit`