From e7326303cd6030ae950791de0ebeb4cd74848243 Mon Sep 17 00:00:00 2001
From: Hayden Welch <91618355+hwelch-fle@users.noreply.github.com>
Date: Tue, 10 Feb 2026 13:35:39 -0500
Subject: [PATCH] docs: Validate Swagger docs (#1486)

---
 .../custom-fields/CustomField/CustomField.module.scss          | 1 +
 server/api/controllers/cards/update.js                         | 2 +-
 server/api/controllers/projects/create.js                      | 2 +-
 server/api/controllers/terms/show.js                           | 2 +-
 server/api/controllers/users/create.js                         | 2 +-
 server/api/controllers/users/update.js                         | 2 +-
 server/api/models/BackgroundImage.js                           | 2 +-
 server/api/models/Config.js                                    | 2 +-
 server/api/models/User.js                                      | 3 ++-
 9 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/client/src/components/custom-fields/CustomField/CustomField.module.scss b/client/src/components/custom-fields/CustomField/CustomField.module.scss
index 7d82682b..c42df81d 100644
--- a/client/src/components/custom-fields/CustomField/CustomField.module.scss
+++ b/client/src/components/custom-fields/CustomField/CustomField.module.scss
@@ -33,6 +33,7 @@
     font-size: 13px;
     line-height: 1;
     margin-bottom: 6px;
+    padding: 1px;
     overflow: hidden;
     text-overflow: ellipsis;
     white-space: nowrap;
diff --git a/server/api/controllers/cards/update.js b/server/api/controllers/cards/update.js
index 5235f1a7..6f8b5433 100755
--- a/server/api/controllers/cards/update.js
+++ b/server/api/controllers/cards/update.js
@@ -49,7 +49,7 @@
  *                 type: number
  *                 minimum: 0
  *                 nullable: true
- *                 description: Position of the card within the list
+ *                 description: Position of the card within the list (required when moving card to new list)
  *                 example: 65536
  *               name:
  *                 type: string
diff --git a/server/api/controllers/projects/create.js b/server/api/controllers/projects/create.js
index 9e7d59ca..9b819a16 100755
--- a/server/api/controllers/projects/create.js
+++ b/server/api/controllers/projects/create.js
@@ -24,7 +24,7 @@
  *             properties:
  *               type:
  *                 type: string
- *                 enum: [public, private]
+ *                 enum: [private, shared]
  *                 description: Type of the project
  *                 example: private
  *               name:
diff --git a/server/api/controllers/terms/show.js b/server/api/controllers/terms/show.js
index dad8fd52..2cc4d401 100644
--- a/server/api/controllers/terms/show.js
+++ b/server/api/controllers/terms/show.js
@@ -51,7 +51,7 @@
  *                       type: string
  *                       enum: [general, extended]
  *                       description: Type of terms
- *                       example: en-US
+ *                       example: general
  *                     language:
  *                       type: string
  *                       enum: [de-DE, en-US]
diff --git a/server/api/controllers/users/create.js b/server/api/controllers/users/create.js
index 747ae2c3..9523465c 100755
--- a/server/api/controllers/users/create.js
+++ b/server/api/controllers/users/create.js
@@ -58,7 +58,7 @@
  *                 maxLength: 128
  *                 nullable: true
  *                 description: Contact phone number
- *                 example: +1234567890
+ *                 example: "+1234567890"
  *               organization:
  *                 type: string
  *                 maxLength: 128
diff --git a/server/api/controllers/users/update.js b/server/api/controllers/users/update.js
index baf335e8..b387fcc2 100755
--- a/server/api/controllers/users/update.js
+++ b/server/api/controllers/users/update.js
@@ -47,7 +47,7 @@
  *                 maxLength: 128
  *                 nullable: true
  *                 description: Contact phone number
- *                 example: +1234567890
+ *                 example: "+1234567890"
  *               organization:
  *                 type: string
  *                 maxLength: 128
diff --git a/server/api/models/BackgroundImage.js b/server/api/models/BackgroundImage.js
index d44fd1bb..fa1b2200 100644
--- a/server/api/models/BackgroundImage.js
+++ b/server/api/models/BackgroundImage.js
@@ -36,7 +36,7 @@
  *         size:
  *           type: string
  *           description: File size of the background image in bytes
- *           example: 1024576
+ *           example: "1024576"
  *         url:
  *           type: string
  *           format: uri
diff --git a/server/api/models/Config.js b/server/api/models/Config.js
index 0a3e243d..fce6730d 100644
--- a/server/api/models/Config.js
+++ b/server/api/models/Config.js
@@ -22,7 +22,7 @@
  *         id:
  *           type: string
  *           description: Unique identifier for the config (always set to '1')
- *           example: 1
+ *           example: "1"
  *         smtpHost:
  *           type: string
  *           nullable: true
diff --git a/server/api/models/User.js b/server/api/models/User.js
index 3248d7de..7e169b36 100755
--- a/server/api/models/User.js
+++ b/server/api/models/User.js
@@ -88,7 +88,7 @@
  *           type: string
  *           nullable: true
  *           description: Contact phone number
- *           example: +1234567890
+ *           example: "+1234567890"
  *         organization:
  *           type: string
  *           nullable: true
@@ -145,6 +145,7 @@
  *           example: byDefault
  *         termsType:
  *           type: string
+ *           enum: [general, extended]
  *           description: Type of terms applicable to the user based on role
  *           example: general
  *         isSsoUser: