docs: Correct invalid/missing details in Swagger

server/api/controllers/access-tokens/delete.js

@@ -5,7 +5,7 @@
 
 /**
  * @swagger
- * /access-tokens:
+ * /access-tokens/me:
  *   delete:
  *     summary: User logout
  *     description: Logs out the current user by deleting the session and access token. Clears HTTP-only cookies if present.

server/api/controllers/board-memberships/create.js

@@ -5,7 +5,7 @@
 
 /**
  * @swagger
- * /boards/{boardId}/memberships:
+ * /boards/{boardId}/board-memberships:
  *   post:
  *     summary: Create board membership
  *     description: Creates a board membership within a board. Requires project manager permissions.

server/api/controllers/card-labels/create.js

@@ -5,7 +5,7 @@
 
 /**
  * @swagger
- * /cards/{cardId}/labels:
+ * /cards/{cardId}/card-labels:
  *   post:
  *     summary: Add label to card
  *     description: Adds a label to a card. Requires board editor permissions.

server/api/controllers/card-labels/delete.js

@@ -5,7 +5,7 @@
 
 /**
  * @swagger
- * /cards/{cardId}/labels/{labelId}:
+ * /cards/{cardId}/card-labels/labelId:{labelId}:
  *   delete:
  *     summary: Remove label from card
  *     description: Removes a label from a card. Requires board editor permissions.

server/api/controllers/card-memberships/create.js

@@ -5,7 +5,7 @@
 
 /**
  * @swagger
- * /cards/{cardId}/memberships:
+ * /cards/{cardId}/card-memberships:
  *   post:
  *     summary: Add user to card
  *     description: Adds a user to a card. Requires board editor permissions.

server/api/controllers/card-memberships/delete.js

@@ -5,7 +5,7 @@
 
 /**
  * @swagger
- * /cards/{cardId}/memberships/{userId}:
+ * /cards/{cardId}/card-memberships/userId:{userId}:
  *   delete:
  *     summary: Remove user from card
  *     description: Removes a user from a card. Requires board editor permissions.

server/api/controllers/custom-field-values/create-or-update.js

@@ -5,8 +5,8 @@
 
 /**
  * @swagger
- * /cards/{cardId}/custom-field-values:
+ * /cards/{cardId}/custom-field-values/customFieldGroupId:{customFieldGroupId}:customFieldId:${customFieldId}:
- *   post:
+ *   patch:
  *     summary: Create or update custom field value
  *     description: Creates or updates a custom field value for a card. Requires board editor permissions.
  *     tags:
@@ -20,6 +20,20 @@
  *         schema:
  *           type: string
  *           example: "1357158568008091264"
+ *       - name: customFieldGroupId
+ *         in: path
+ *         required: true
+ *         description: ID of the custom field group the value belongs to
+ *         schema:
+ *           type: string
+ *           example: "1357158568008091265"
+ *       - name: customFieldId
+ *         in: path
+ *         required: true
+ *         description: ID of the custom field the value belongs to
+ *         schema:
+ *           type: string
+ *           example: "1357158568008091266"
  *     requestBody:
  *       required: true
  *       content:
@@ -27,18 +41,8 @@
  *           schema:
  *             type: object
  *             required:
- *               - customFieldGroupId
- *               - customFieldId
  *               - content
  *             properties:
- *               customFieldGroupId:
- *                 type: string
- *                 description: ID of the custom field group the value belongs to
- *                 example: "1357158568008091265"
- *               customFieldId:
- *                 type: string
- *                 description: ID of the custom field the value belongs to
- *                 example: "1357158568008091266"
  *               content:
  *                 type: string
  *                 maxLength: 512

server/api/controllers/custom-field-values/delete.js

@@ -5,7 +5,7 @@
 
 /**
  * @swagger
- * /cards/{cardId}/custom-field-groups/{customFieldGroupId}/custom-fields/{customFieldId}/value:
+ * /cards/{cardId}/custom-field-value/customFieldGroupId:{customFieldGroupId}:customFieldId:${customFieldId}:
  *   delete:
  *     summary: Delete custom field value
  *     description: Deletes a custom field value for a specific card. Requires board editor permissions.

server/api/controllers/project-managers/create.js

@@ -5,7 +5,7 @@
 
 /**
  * @swagger
- * /projects/{projectId}/managers:
+ * /projects/{projectId}/project-managers:
  *   post:
  *     summary: Create project manager
  *     description: Creates a project manager within a project. Requires admin privileges for shared projects or existing project manager permissions. The user must be an admin or project owner.

server/api/controllers/terms/show.js

@@ -5,7 +5,7 @@
 
 /**
  * @swagger
- * /terms:
+ * /terms/{type}:
  *   get:
  *     summary: Get terms and conditions
  *     description: Retrieves terms and conditions in the specified language.
@@ -14,7 +14,7 @@
  *     operationId: getTerms
  *     parameters:
  *       - name: type
- *         in: query
+ *         in: path
  *         required: true
  *         description: Type of terms to retrieve
  *         schema:

server/api/controllers/users/update-avatar.js

@@ -6,7 +6,7 @@
 /**
  * @swagger
  * /users/{id}/avatar:
- *   patch:
+ *   post:
  *     summary: Update user avatar
  *     description: Updates a user's avatar image. Users can update their own avatar, admins can update any user's avatar.
  *     tags:

server/config/swagger.js

@@ -12,7 +12,7 @@ module.exports = {
       version,
       title: 'PLANKA API',
       description:
-        'API documentation for PLANKA - Real-time Collaborative Kanban Board Application',
+        'API documentation for PLANKA - Real-Time Collaborative Kanban Board Application',
       license: {
         name: 'Fair Use License',
         url: 'https://github.com/plankanban/planka/blob/master/LICENSE.md',