docs: Improve Swagger JSDoc

2025-09-12 12:17:01 +02:00
parent 494800d131
commit b4979d214f
129 changed files with 294 additions and 248 deletions
@@ -11,6 +11,7 @@
 *     description: Creates a card within a list. Requires board editor permissions.
 *     tags:
 *       - Cards
+ *     operationId: createCard
 *     parameters:
 *       - name: listId
 *         in: path
@@ -11,6 +11,7 @@
 *     description: Deletes a card and all its contents (tasks, attachments, etc.). Requires board editor permissions.
 *     tags:
 *       - Cards
+ *     operationId: deleteCard
 *     parameters:
 *       - name: id
 *         in: path
@@ -11,6 +11,7 @@
 *     description: Creates a duplicate of a card with all its contents (tasks, attachments, etc.). Requires board editor permissions.
 *     tags:
 *       - Cards
+ *     operationId: duplicateCard
 *     parameters:
 *       - name: id
 *         in: path
@@ -11,6 +11,7 @@
 *     description: Retrieves cards from an endless list with filtering, search, and pagination support.
 *     tags:
 *       - Cards
+ *     operationId: getCards
 *     parameters:
 *       - name: listId
 *         in: path
@@ -11,6 +11,7 @@
 *     description: Marks all notifications for a specific card as read for the current user. Requires access to the card.
 *     tags:
 *       - Cards
+ *     operationId: readCardNotifications
 *     parameters:
 *       - name: id
 *         in: path
@@ -11,6 +11,7 @@
 *     description: Retrieves comprehensive card information, including tasks, attachments, and other related data.
 *     tags:
 *       - Cards
+ *     operationId: getCard
 *     parameters:
 *       - name: id
 *         in: path
@@ -11,6 +11,7 @@
 *     description: Updates a card. Board editors can update all fields, viewers can only subscribe/unsubscribe.
 *     tags:
 *       - Cards
+ *     operationId: updateCard
 *     parameters:
 *       - name: id
 *         in: path