docs: Validate Swagger docs (#1486)

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

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:

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]

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

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

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

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

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: