diff --git a/server/api/controllers/access-tokens/accept-terms.js b/server/api/controllers/access-tokens/accept-terms.js index 5e927468..dee5b976 100644 --- a/server/api/controllers/access-tokens/accept-terms.js +++ b/server/api/controllers/access-tokens/accept-terms.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/access-tokens/accept-terms: + * /access-tokens/accept-terms: * post: * summary: Accept terms and conditions * description: Accept terms during the authentication flow. Converts the pending token to an access token. diff --git a/server/api/controllers/access-tokens/create.js b/server/api/controllers/access-tokens/create.js index 8e98cce0..d1057ec5 100755 --- a/server/api/controllers/access-tokens/create.js +++ b/server/api/controllers/access-tokens/create.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/access-tokens: + * /access-tokens: * post: * summary: User login * description: Authenticates a user using email/username and password. Returns an access token for API authentication. diff --git a/server/api/controllers/access-tokens/delete.js b/server/api/controllers/access-tokens/delete.js index 1e7a36b5..6f294213 100644 --- a/server/api/controllers/access-tokens/delete.js +++ b/server/api/controllers/access-tokens/delete.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/access-tokens: + * /access-tokens: * delete: * summary: User logout * description: Logs out the current user by deleting the session and access token. Clears HTTP-only cookies if present. diff --git a/server/api/controllers/access-tokens/exchange-with-oidc.js b/server/api/controllers/access-tokens/exchange-with-oidc.js index 32f21921..47fe6698 100644 --- a/server/api/controllers/access-tokens/exchange-with-oidc.js +++ b/server/api/controllers/access-tokens/exchange-with-oidc.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/access-tokens/exchange-with-oidc: + * /access-tokens/exchange-with-oidc: * post: * summary: Exchange OIDC code for access token * description: Exchanges an OIDC authorization code for an access token. Creates a user if they do not exist. diff --git a/server/api/controllers/access-tokens/revoke-pending-token.js b/server/api/controllers/access-tokens/revoke-pending-token.js index 0348358f..c4a0cf26 100644 --- a/server/api/controllers/access-tokens/revoke-pending-token.js +++ b/server/api/controllers/access-tokens/revoke-pending-token.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/access-tokens/revoke-pending-token: + * /access-tokens/revoke-pending-token: * post: * summary: Revoke pending token * description: Revokes a pending authentication token and cancels the authentication flow. diff --git a/server/api/controllers/actions/index-in-board.js b/server/api/controllers/actions/index-in-board.js index e52e3358..8d719356 100755 --- a/server/api/controllers/actions/index-in-board.js +++ b/server/api/controllers/actions/index-in-board.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/boards/{boardId}/actions: + * /boards/{boardId}/actions: * get: * summary: Get board actions * description: Retrieves a list of actions (activity history) for a specific board, with pagination support. diff --git a/server/api/controllers/actions/index-in-card.js b/server/api/controllers/actions/index-in-card.js index 1b3d4555..80683f36 100755 --- a/server/api/controllers/actions/index-in-card.js +++ b/server/api/controllers/actions/index-in-card.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/cards/{cardId}/actions: + * /cards/{cardId}/actions: * get: * summary: Get card actions * description: Retrieves a list of actions (activity history) for a specific card, with pagination support. diff --git a/server/api/controllers/attachments/create.js b/server/api/controllers/attachments/create.js index 8589939e..b81ef249 100644 --- a/server/api/controllers/attachments/create.js +++ b/server/api/controllers/attachments/create.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/cards/{cardId}/attachments: + * /cards/{cardId}/attachments: * post: * summary: Create attachment * description: Creates an attachment on a card. Requires board editor permissions. diff --git a/server/api/controllers/attachments/delete.js b/server/api/controllers/attachments/delete.js index 6dac01fa..d2983812 100755 --- a/server/api/controllers/attachments/delete.js +++ b/server/api/controllers/attachments/delete.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/attachments/{id}: + * /attachments/{id}: * delete: * summary: Delete attachment * description: Deletes an attachment. Requires board editor permissions. diff --git a/server/api/controllers/attachments/update.js b/server/api/controllers/attachments/update.js index 7423e3b3..b85d2344 100755 --- a/server/api/controllers/attachments/update.js +++ b/server/api/controllers/attachments/update.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/attachments/{id}: + * /attachments/{id}: * patch: * summary: Update attachment * description: Updates an attachment. Requires board editor permissions. diff --git a/server/api/controllers/background-images/create.js b/server/api/controllers/background-images/create.js index 21ff056c..7cdec094 100644 --- a/server/api/controllers/background-images/create.js +++ b/server/api/controllers/background-images/create.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/projects/{projectId}/background-images: + * /projects/{projectId}/background-images: * post: * summary: Upload background image * description: Uploads a background image for a project. Requires project manager permissions. diff --git a/server/api/controllers/background-images/delete.js b/server/api/controllers/background-images/delete.js index e2cd5c3d..684d54e1 100755 --- a/server/api/controllers/background-images/delete.js +++ b/server/api/controllers/background-images/delete.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/background-images/{id}: + * /background-images/{id}: * delete: * summary: Delete background image * description: Deletes a background image. Requires project manager permissions. diff --git a/server/api/controllers/base-custom-field-groups/create.js b/server/api/controllers/base-custom-field-groups/create.js index 9771500f..8985bc6a 100644 --- a/server/api/controllers/base-custom-field-groups/create.js +++ b/server/api/controllers/base-custom-field-groups/create.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/projects/{projectId}/base-custom-field-groups: + * /projects/{projectId}/base-custom-field-groups: * post: * summary: Create base custom field group * description: Creates a base custom field group within a project. Requires project manager permissions. diff --git a/server/api/controllers/base-custom-field-groups/delete.js b/server/api/controllers/base-custom-field-groups/delete.js index 062e6dc5..8ee1ef7a 100644 --- a/server/api/controllers/base-custom-field-groups/delete.js +++ b/server/api/controllers/base-custom-field-groups/delete.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/base-custom-field-groups/{id}: + * /base-custom-field-groups/{id}: * delete: * summary: Delete base custom field group * description: Deletes a base custom field group. Requires project manager permissions. diff --git a/server/api/controllers/base-custom-field-groups/update.js b/server/api/controllers/base-custom-field-groups/update.js index 50f6f8da..5afa1887 100644 --- a/server/api/controllers/base-custom-field-groups/update.js +++ b/server/api/controllers/base-custom-field-groups/update.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/base-custom-field-groups/{id}: + * /base-custom-field-groups/{id}: * patch: * summary: Update base custom field group * description: Updates a base custom field group. Requires project manager permissions. diff --git a/server/api/controllers/board-memberships/create.js b/server/api/controllers/board-memberships/create.js index ab8fb366..694f47aa 100755 --- a/server/api/controllers/board-memberships/create.js +++ b/server/api/controllers/board-memberships/create.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/boards/{boardId}/memberships: + * /boards/{boardId}/memberships: * post: * summary: Add user to board * description: Adds a user to a board. Requires project manager permissions. diff --git a/server/api/controllers/board-memberships/delete.js b/server/api/controllers/board-memberships/delete.js index 0bdf7869..63637431 100755 --- a/server/api/controllers/board-memberships/delete.js +++ b/server/api/controllers/board-memberships/delete.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/board-memberships/{id}: + * /board-memberships/{id}: * delete: * summary: Remove user from board * description: Removes a user from a board. Users can remove themselves, or project managers can remove any user. diff --git a/server/api/controllers/board-memberships/update.js b/server/api/controllers/board-memberships/update.js index d7f85e76..aa4ede77 100644 --- a/server/api/controllers/board-memberships/update.js +++ b/server/api/controllers/board-memberships/update.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/board-memberships/{id}: + * /board-memberships/{id}: * patch: * summary: Update board membership * description: Updates a board membership. Requires project manager permissions. diff --git a/server/api/controllers/boards/create.js b/server/api/controllers/boards/create.js index 28fe7bb2..c58787d2 100755 --- a/server/api/controllers/boards/create.js +++ b/server/api/controllers/boards/create.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/projects/{projectId}/boards: + * /projects/{projectId}/boards: * post: * summary: Create board * description: Creates a board within a project. Supports importing from Trello. Requires project manager permissions. diff --git a/server/api/controllers/boards/delete.js b/server/api/controllers/boards/delete.js index 39e61586..04f12b6b 100755 --- a/server/api/controllers/boards/delete.js +++ b/server/api/controllers/boards/delete.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/boards/{id}: + * /boards/{id}: * delete: * summary: Delete board * description: Deletes a board and all its contents (lists, cards, etc.). Requires project manager permissions. diff --git a/server/api/controllers/boards/show.js b/server/api/controllers/boards/show.js index 1cbd3036..08b611f0 100755 --- a/server/api/controllers/boards/show.js +++ b/server/api/controllers/boards/show.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/boards/{id}: + * /boards/{id}: * get: * summary: Get board details * description: Retrieves comprehensive board information, including lists, cards, and other related data. diff --git a/server/api/controllers/boards/update.js b/server/api/controllers/boards/update.js index 9c75c620..c2eeaf7b 100755 --- a/server/api/controllers/boards/update.js +++ b/server/api/controllers/boards/update.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/boards/{id}: + * /boards/{id}: * patch: * summary: Update board * description: Updates a board. Project managers can update all fields, board members can only subscribe/unsubscribe. diff --git a/server/api/controllers/card-labels/create.js b/server/api/controllers/card-labels/create.js index 498e75c1..f6ed4a0e 100755 --- a/server/api/controllers/card-labels/create.js +++ b/server/api/controllers/card-labels/create.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/cards/{cardId}/labels: + * /cards/{cardId}/labels: * post: * summary: Add label to card * description: Adds a label to a card. Requires board editor permissions. diff --git a/server/api/controllers/card-labels/delete.js b/server/api/controllers/card-labels/delete.js index 5daabd7d..e27b215e 100755 --- a/server/api/controllers/card-labels/delete.js +++ b/server/api/controllers/card-labels/delete.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/cards/{cardId}/labels/{labelId}: + * /cards/{cardId}/labels/{labelId}: * delete: * summary: Remove label from card * description: Removes a label from a card. Requires board editor permissions. diff --git a/server/api/controllers/card-memberships/create.js b/server/api/controllers/card-memberships/create.js index f5ba01df..facd1fa3 100755 --- a/server/api/controllers/card-memberships/create.js +++ b/server/api/controllers/card-memberships/create.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/cards/{cardId}/memberships: + * /cards/{cardId}/memberships: * post: * summary: Add user to card * description: Adds a user to a card. Requires board editor permissions. diff --git a/server/api/controllers/card-memberships/delete.js b/server/api/controllers/card-memberships/delete.js index 5eef131d..733308ea 100755 --- a/server/api/controllers/card-memberships/delete.js +++ b/server/api/controllers/card-memberships/delete.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/cards/{cardId}/memberships/{userId}: + * /cards/{cardId}/memberships/{userId}: * delete: * summary: Remove user from card * description: Removes a user from a card. Requires board editor permissions. diff --git a/server/api/controllers/cards/create.js b/server/api/controllers/cards/create.js index 50f32180..70cea0cd 100755 --- a/server/api/controllers/cards/create.js +++ b/server/api/controllers/cards/create.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/lists/{listId}/cards: + * /lists/{listId}/cards: * post: * summary: Create card * description: Creates a card within a list. Requires board editor permissions. diff --git a/server/api/controllers/cards/delete.js b/server/api/controllers/cards/delete.js index 208159a5..b1611d43 100755 --- a/server/api/controllers/cards/delete.js +++ b/server/api/controllers/cards/delete.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/cards/{id}: + * /cards/{id}: * delete: * summary: Delete card * description: Deletes a card and all its contents (tasks, attachments, etc.). Requires board editor permissions. diff --git a/server/api/controllers/cards/duplicate.js b/server/api/controllers/cards/duplicate.js index 3e672d80..ad22ae2a 100644 --- a/server/api/controllers/cards/duplicate.js +++ b/server/api/controllers/cards/duplicate.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/cards/{id}/duplicate: + * /cards/{id}/duplicate: * post: * summary: Duplicate card * description: Creates a duplicate of a card with all its contents (tasks, attachments, etc.). Requires board editor permissions. diff --git a/server/api/controllers/cards/index.js b/server/api/controllers/cards/index.js index af6f5240..247f21d2 100644 --- a/server/api/controllers/cards/index.js +++ b/server/api/controllers/cards/index.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/lists/{listId}/cards: + * /lists/{listId}/cards: * get: * summary: Get cards in list * description: Retrieves cards from an endless list with filtering, search, and pagination support. diff --git a/server/api/controllers/cards/read-notifications.js b/server/api/controllers/cards/read-notifications.js index c28c21cb..e09e38ff 100644 --- a/server/api/controllers/cards/read-notifications.js +++ b/server/api/controllers/cards/read-notifications.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/cards/{id}/read-notifications: + * /cards/{id}/read-notifications: * post: * summary: Mark card notifications as read * description: Marks all notifications for a specific card as read for the current user. Requires access to the card. diff --git a/server/api/controllers/cards/show.js b/server/api/controllers/cards/show.js index fd801bd0..dac05c16 100755 --- a/server/api/controllers/cards/show.js +++ b/server/api/controllers/cards/show.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/cards/{id}: + * /cards/{id}: * get: * summary: Get card details * description: Retrieves comprehensive card information, including tasks, attachments, and other related data. diff --git a/server/api/controllers/cards/update.js b/server/api/controllers/cards/update.js index a0965dc6..05a7bec8 100755 --- a/server/api/controllers/cards/update.js +++ b/server/api/controllers/cards/update.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/cards/{id}: + * /cards/{id}: * patch: * summary: Update card * description: Updates a card. Board editors can update all fields, viewers can only subscribe/unsubscribe. diff --git a/server/api/controllers/comments/create.js b/server/api/controllers/comments/create.js index 0cbab4b6..85767711 100755 --- a/server/api/controllers/comments/create.js +++ b/server/api/controllers/comments/create.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/cards/{cardId}/comments: + * /cards/{cardId}/comments: * post: * summary: Create comment * description: Creates a new comment on a card. Requires board editor permissions or comment permissions. diff --git a/server/api/controllers/comments/delete.js b/server/api/controllers/comments/delete.js index ae8f6a37..7ade05bb 100755 --- a/server/api/controllers/comments/delete.js +++ b/server/api/controllers/comments/delete.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/comments/{id}: + * /comments/{id}: * delete: * summary: Delete comment * description: Deletes a comment. Can be deleted by the comment author (with comment permissions) or project manager. diff --git a/server/api/controllers/comments/index.js b/server/api/controllers/comments/index.js index 7801591d..8abea4ed 100644 --- a/server/api/controllers/comments/index.js +++ b/server/api/controllers/comments/index.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/cards/{cardId}/comments: + * /cards/{cardId}/comments: * get: * summary: Get card comments * description: Retrieves comments for a card with pagination support. Requires access to the card. diff --git a/server/api/controllers/comments/update.js b/server/api/controllers/comments/update.js index 8193c97e..f3d04aa2 100755 --- a/server/api/controllers/comments/update.js +++ b/server/api/controllers/comments/update.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/comments/{id}: + * /comments/{id}: * patch: * summary: Update comment * description: Updates a comment. Only the author of the comment can update it. diff --git a/server/api/controllers/config/show.js b/server/api/controllers/config/show.js index 79219b5e..dede7cc7 100644 --- a/server/api/controllers/config/show.js +++ b/server/api/controllers/config/show.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/config: + * /config: * get: * summary: Get application configuration * description: Retrieves the application configuration. diff --git a/server/api/controllers/custom-field-groups/create-in-board.js b/server/api/controllers/custom-field-groups/create-in-board.js index f500d9bf..3cb51aad 100644 --- a/server/api/controllers/custom-field-groups/create-in-board.js +++ b/server/api/controllers/custom-field-groups/create-in-board.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/boards/{boardId}/custom-field-groups: + * /boards/{boardId}/custom-field-groups: * post: * summary: Create custom field group in board * description: Creates a custom field group within a board. Either `baseCustomFieldGroupId` or `name` must be provided. Requires board editor permissions. diff --git a/server/api/controllers/custom-field-groups/create-in-card.js b/server/api/controllers/custom-field-groups/create-in-card.js index 25fb98c5..ad216311 100644 --- a/server/api/controllers/custom-field-groups/create-in-card.js +++ b/server/api/controllers/custom-field-groups/create-in-card.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/cards/{cardId}/custom-field-groups: + * /cards/{cardId}/custom-field-groups: * post: * summary: Create custom field group in card * description: Creates a custom field group within a card. Either `baseCustomFieldGroupId` or `name` must be provided. Requires board editor permissions. diff --git a/server/api/controllers/custom-field-groups/delete.js b/server/api/controllers/custom-field-groups/delete.js index 9bbef3f7..9d778001 100755 --- a/server/api/controllers/custom-field-groups/delete.js +++ b/server/api/controllers/custom-field-groups/delete.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/custom-field-groups/{id}: + * /custom-field-groups/{id}: * delete: * summary: Delete custom field group * description: Deletes a custom field group. Requires board editor permissions. diff --git a/server/api/controllers/custom-field-groups/show.js b/server/api/controllers/custom-field-groups/show.js index a4d6070b..df3fa9f5 100644 --- a/server/api/controllers/custom-field-groups/show.js +++ b/server/api/controllers/custom-field-groups/show.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/custom-field-groups/{id}: + * /custom-field-groups/{id}: * get: * summary: Get custom field group details * description: Retrieves comprehensive custom field group information, including fields and values. Requires access to the board/card. diff --git a/server/api/controllers/custom-field-groups/update.js b/server/api/controllers/custom-field-groups/update.js index 96382b35..d893188f 100755 --- a/server/api/controllers/custom-field-groups/update.js +++ b/server/api/controllers/custom-field-groups/update.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/custom-field-groups/{id}: + * /custom-field-groups/{id}: * patch: * summary: Update custom field group * description: Updates a custom field group. Supports both board-wide and card-specific groups. Requires board editor permissions. diff --git a/server/api/controllers/custom-field-values/create-or-update.js b/server/api/controllers/custom-field-values/create-or-update.js index 051c398d..f574e80a 100644 --- a/server/api/controllers/custom-field-values/create-or-update.js +++ b/server/api/controllers/custom-field-values/create-or-update.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/cards/{cardId}/custom-field-values: + * /cards/{cardId}/custom-field-values: * post: * summary: Create or update custom field value * description: Creates or updates a custom field value for a card. Requires board editor permissions. diff --git a/server/api/controllers/custom-field-values/delete.js b/server/api/controllers/custom-field-values/delete.js index 4f8ac186..51c37ade 100644 --- a/server/api/controllers/custom-field-values/delete.js +++ b/server/api/controllers/custom-field-values/delete.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/cards/{cardId}/custom-field-groups/{customFieldGroupId}/custom-fields/{customFieldId}/value: + * /cards/{cardId}/custom-field-groups/{customFieldGroupId}/custom-fields/{customFieldId}/value: * delete: * summary: Delete custom field value * description: Deletes a custom field value for a specific card. Requires board editor permissions. diff --git a/server/api/controllers/custom-fields/create-in-base-custom-field-group.js b/server/api/controllers/custom-fields/create-in-base-custom-field-group.js index 37dd4912..3d48ebf1 100644 --- a/server/api/controllers/custom-fields/create-in-base-custom-field-group.js +++ b/server/api/controllers/custom-fields/create-in-base-custom-field-group.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/base-custom-field-groups/{baseCustomFieldGroupId}/custom-fields: + * /base-custom-field-groups/{baseCustomFieldGroupId}/custom-fields: * post: * summary: Create custom field in base custom field group * description: Creates a custom field within a base custom field group. Requires project manager permissions. diff --git a/server/api/controllers/custom-fields/create-in-custom-field-group.js b/server/api/controllers/custom-fields/create-in-custom-field-group.js index 38553cad..02d30469 100644 --- a/server/api/controllers/custom-fields/create-in-custom-field-group.js +++ b/server/api/controllers/custom-fields/create-in-custom-field-group.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/custom-field-groups/{customFieldGroupId}/custom-fields: + * /custom-field-groups/{customFieldGroupId}/custom-fields: * post: * summary: Create custom field in custom field group * description: Creates a custom field within a custom field group. Requires board editor permissions. diff --git a/server/api/controllers/custom-fields/delete.js b/server/api/controllers/custom-fields/delete.js index c01fce2e..c49094d6 100755 --- a/server/api/controllers/custom-fields/delete.js +++ b/server/api/controllers/custom-fields/delete.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/custom-fields/{id}: + * /custom-fields/{id}: * delete: * summary: Delete custom field * description: Deletes a custom field. Can delete the in base custom field group (requires project manager permissions) or the custom field group (requires board editor permissions). diff --git a/server/api/controllers/custom-fields/update.js b/server/api/controllers/custom-fields/update.js index c3bad196..da1ce469 100755 --- a/server/api/controllers/custom-fields/update.js +++ b/server/api/controllers/custom-fields/update.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/custom-fields/{id}: + * /custom-fields/{id}: * patch: * summary: Update custom field * description: Updates a custom field. Can update in the base custom field group (requires project manager permissions) or the custom field group (requires board editor permissions). diff --git a/server/api/controllers/file-attachments/download-thumbnail.js b/server/api/controllers/file-attachments/download-thumbnail.js index 433aeac7..2d6259ab 100644 --- a/server/api/controllers/file-attachments/download-thumbnail.js +++ b/server/api/controllers/file-attachments/download-thumbnail.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/attachments/{id}/download/thumbnails/{fileName}.{fileExtension}: + * /attachments/{id}/download/thumbnails/{fileName}.{fileExtension}: * get: * summary: Download file attachment thumbnail * description: Downloads a thumbnail for a file attachment. Only available for image attachments that have thumbnails generated. Requires access to the card. diff --git a/server/api/controllers/file-attachments/download.js b/server/api/controllers/file-attachments/download.js index b94a4c42..ed8ad081 100644 --- a/server/api/controllers/file-attachments/download.js +++ b/server/api/controllers/file-attachments/download.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/attachments/{id}/download: + * /attachments/{id}/download: * get: * summary: Download file attachment * description: Downloads a file attachment. Requires access to the card. diff --git a/server/api/controllers/labels/create.js b/server/api/controllers/labels/create.js index 6a29cb04..5e71516e 100755 --- a/server/api/controllers/labels/create.js +++ b/server/api/controllers/labels/create.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/boards/{boardId}/labels: + * /boards/{boardId}/labels: * post: * summary: Create label * description: Creates a label within a board. Requires board editor permissions. diff --git a/server/api/controllers/labels/delete.js b/server/api/controllers/labels/delete.js index 75c976f7..eb0c1279 100755 --- a/server/api/controllers/labels/delete.js +++ b/server/api/controllers/labels/delete.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/labels/{id}: + * /labels/{id}: * delete: * summary: Delete label * description: Deletes a label. Requires board editor permissions. diff --git a/server/api/controllers/labels/update.js b/server/api/controllers/labels/update.js index df499526..efef85c4 100755 --- a/server/api/controllers/labels/update.js +++ b/server/api/controllers/labels/update.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/labels/{id}: + * /labels/{id}: * patch: * summary: Update label * description: Updates a label. Requires board editor permissions. diff --git a/server/api/controllers/lists/clear.js b/server/api/controllers/lists/clear.js index fdbd0a48..f2e8b59f 100644 --- a/server/api/controllers/lists/clear.js +++ b/server/api/controllers/lists/clear.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/lists/{id}/clear: + * /lists/{id}/clear: * post: * summary: Clear list * description: Deletes all cards from a list. Only works with trash-type lists. Requires project manager or board editor permissions. diff --git a/server/api/controllers/lists/create.js b/server/api/controllers/lists/create.js index 824680a1..72a7f416 100755 --- a/server/api/controllers/lists/create.js +++ b/server/api/controllers/lists/create.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/boards/{boardId}/lists: + * /boards/{boardId}/lists: * post: * summary: Create list * description: Creates a list within a board. Requires board editor permissions. diff --git a/server/api/controllers/lists/delete.js b/server/api/controllers/lists/delete.js index c63f0f1b..d9ab9dc4 100755 --- a/server/api/controllers/lists/delete.js +++ b/server/api/controllers/lists/delete.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/lists/{id}: + * /lists/{id}: * delete: * summary: Delete list * description: Deletes a list and moves its cards to a trash list. Can only delete finite lists. Requires board editor permissions. diff --git a/server/api/controllers/lists/move-cards.js b/server/api/controllers/lists/move-cards.js index c37a4de4..20e54745 100644 --- a/server/api/controllers/lists/move-cards.js +++ b/server/api/controllers/lists/move-cards.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/lists/{id}/move-cards: + * /lists/{id}/move-cards: * post: * summary: Move cards * description: Moves all cards from a closed list to an archive list. Requires board editor permissions. diff --git a/server/api/controllers/lists/show.js b/server/api/controllers/lists/show.js index a995dd10..581c3520 100644 --- a/server/api/controllers/lists/show.js +++ b/server/api/controllers/lists/show.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/lists/{id}: + * /lists/{id}: * get: * summary: Get list details * description: Retrieves comprehensive list information, including cards, attachments, and other related data. Requires access to the board. diff --git a/server/api/controllers/lists/sort.js b/server/api/controllers/lists/sort.js index f72aeddb..8fde4fda 100644 --- a/server/api/controllers/lists/sort.js +++ b/server/api/controllers/lists/sort.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/lists/{id}/sort: + * /lists/{id}/sort: * post: * summary: Sort cards in list * description: Sorts all cards within a list. Requires board editor permissions. diff --git a/server/api/controllers/lists/update.js b/server/api/controllers/lists/update.js index a93212ba..57c4bdc5 100755 --- a/server/api/controllers/lists/update.js +++ b/server/api/controllers/lists/update.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/lists/{id}: + * /lists/{id}: * patch: * summary: Update list * description: Updates a list. Can move lists between boards. Requires board editor permissions. diff --git a/server/api/controllers/notification-services/create-in-board.js b/server/api/controllers/notification-services/create-in-board.js index 55d862dc..cacda57e 100644 --- a/server/api/controllers/notification-services/create-in-board.js +++ b/server/api/controllers/notification-services/create-in-board.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/boards/{boardId}/notification-services: + * /boards/{boardId}/notification-services: * post: * summary: Create notification service for board * description: Creates a new notification service for a board. Requires project manager permissions. diff --git a/server/api/controllers/notification-services/create-in-user.js b/server/api/controllers/notification-services/create-in-user.js index 3e15ab73..224649fb 100644 --- a/server/api/controllers/notification-services/create-in-user.js +++ b/server/api/controllers/notification-services/create-in-user.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/users/{userId}/notification-services: + * /users/{userId}/notification-services: * post: * summary: Create notification service for user * description: Creates a new notification service for a user. Users can only create services for themselves. diff --git a/server/api/controllers/notification-services/delete.js b/server/api/controllers/notification-services/delete.js index ebccfbdc..3144fb27 100644 --- a/server/api/controllers/notification-services/delete.js +++ b/server/api/controllers/notification-services/delete.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/notification-services/{id}: + * /notification-services/{id}: * delete: * summary: Delete notification service * description: Deletes a notification service. Users can delete their own services, project managers can delete board services. diff --git a/server/api/controllers/notification-services/test.js b/server/api/controllers/notification-services/test.js index c5a7cec0..3c1d663e 100644 --- a/server/api/controllers/notification-services/test.js +++ b/server/api/controllers/notification-services/test.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/notification-services/{id}/test: + * /notification-services/{id}/test: * post: * summary: Test notification service * description: Sends a test notification to verify the notification service is working. Users can test their own services, project managers can test board services. diff --git a/server/api/controllers/notification-services/update.js b/server/api/controllers/notification-services/update.js index 455bee07..e9d89159 100644 --- a/server/api/controllers/notification-services/update.js +++ b/server/api/controllers/notification-services/update.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/notification-services/{id}: + * /notification-services/{id}: * patch: * summary: Update notification service * description: Updates a notification service. Users can update their own services, project managers can update board services. diff --git a/server/api/controllers/notifications/index.js b/server/api/controllers/notifications/index.js index 5fd75e1f..f71562fe 100755 --- a/server/api/controllers/notifications/index.js +++ b/server/api/controllers/notifications/index.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/notifications: + * /notifications: * get: * summary: Get user notifications * description: Retrieves all unread notifications for the current user, including creator users. diff --git a/server/api/controllers/notifications/read-all.js b/server/api/controllers/notifications/read-all.js index 5a04665b..5645476d 100755 --- a/server/api/controllers/notifications/read-all.js +++ b/server/api/controllers/notifications/read-all.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/notifications/read-all: + * /notifications/read-all: * post: * summary: Mark all notifications as read * description: Marks all notifications for the current user as read. diff --git a/server/api/controllers/notifications/show.js b/server/api/controllers/notifications/show.js index 727b4895..ff1a396e 100644 --- a/server/api/controllers/notifications/show.js +++ b/server/api/controllers/notifications/show.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/notifications/{id}: + * /notifications/{id}: * get: * summary: Get notification details * description: Retrieves notification, including creator users. Users can only access their own notifications. diff --git a/server/api/controllers/notifications/update.js b/server/api/controllers/notifications/update.js index 6ff7ddf9..03bab07a 100644 --- a/server/api/controllers/notifications/update.js +++ b/server/api/controllers/notifications/update.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/notifications/{id}: + * /notifications/{id}: * patch: * summary: Update notification * description: Updates a notification. Users can only update their own notifications. diff --git a/server/api/controllers/project-managers/create.js b/server/api/controllers/project-managers/create.js index 733ce356..1441dfc0 100755 --- a/server/api/controllers/project-managers/create.js +++ b/server/api/controllers/project-managers/create.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/projects/{projectId}/managers: + * /projects/{projectId}/managers: * post: * summary: Add project manager * description: Adds a user as a project manager. Requires admin privileges for shared projects or existing project manager permissions. The user must be an admin or project owner. diff --git a/server/api/controllers/project-managers/delete.js b/server/api/controllers/project-managers/delete.js index 3887cef5..163dfead 100755 --- a/server/api/controllers/project-managers/delete.js +++ b/server/api/controllers/project-managers/delete.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/project-managers/{id}: + * /project-managers/{id}: * delete: * summary: Remove project manager * description: Removes a user from project managers. Requires admin privileges for shared projects or existing project manager permissions. Cannot remove the last project manager. diff --git a/server/api/controllers/projects/create.js b/server/api/controllers/projects/create.js index dcea7264..3c0863a0 100755 --- a/server/api/controllers/projects/create.js +++ b/server/api/controllers/projects/create.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/projects: + * /projects: * post: * summary: Create project * description: Creates a project. The current user automatically becomes a project manager. diff --git a/server/api/controllers/projects/delete.js b/server/api/controllers/projects/delete.js index 116a2cef..b7f656a3 100755 --- a/server/api/controllers/projects/delete.js +++ b/server/api/controllers/projects/delete.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/projects/{id}: + * /projects/{id}: * delete: * summary: Delete project * description: Deletes a project. The project must not have any boards. Requires project manager permissions. diff --git a/server/api/controllers/projects/index.js b/server/api/controllers/projects/index.js index 52fa2176..2df366bc 100755 --- a/server/api/controllers/projects/index.js +++ b/server/api/controllers/projects/index.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/projects: + * /projects: * get: * summary: Get all accessible projects * description: Retrieves all projects the current user has access to, including managed projects, membership projects, and shared projects (for admins). diff --git a/server/api/controllers/projects/show.js b/server/api/controllers/projects/show.js index fb4524e4..530e5495 100644 --- a/server/api/controllers/projects/show.js +++ b/server/api/controllers/projects/show.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/projects/{id}: + * /projects/{id}: * get: * summary: Get project details * description: Retrieves comprehensive project information, including boards, board memberships, and other related data. diff --git a/server/api/controllers/projects/update.js b/server/api/controllers/projects/update.js index add24e4d..ccefb40e 100755 --- a/server/api/controllers/projects/update.js +++ b/server/api/controllers/projects/update.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/projects/{id}: + * /projects/{id}: * patch: * summary: Update project * description: Updates a project. Accessible fields depend on user permissions. diff --git a/server/api/controllers/task-lists/create.js b/server/api/controllers/task-lists/create.js index f875e0c9..e54c72a4 100755 --- a/server/api/controllers/task-lists/create.js +++ b/server/api/controllers/task-lists/create.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/cards/{cardId}/task-lists: + * /cards/{cardId}/task-lists: * post: * summary: Create task list * description: Creates a task list within a card. Requires board editor permissions. diff --git a/server/api/controllers/task-lists/delete.js b/server/api/controllers/task-lists/delete.js index 15c709b4..d014134d 100755 --- a/server/api/controllers/task-lists/delete.js +++ b/server/api/controllers/task-lists/delete.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/task-lists/{id}: + * /task-lists/{id}: * delete: * summary: Delete task list * description: Deletes a task list and all its tasks. Requires board editor permissions. diff --git a/server/api/controllers/task-lists/show.js b/server/api/controllers/task-lists/show.js index 7db47d1d..32089f8a 100644 --- a/server/api/controllers/task-lists/show.js +++ b/server/api/controllers/task-lists/show.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/task-lists/{id}: + * /task-lists/{id}: * get: * summary: Get task list details * description: Retrieves task list information, including tasks. Requires access to the card. diff --git a/server/api/controllers/task-lists/update.js b/server/api/controllers/task-lists/update.js index b92b2691..37c70707 100755 --- a/server/api/controllers/task-lists/update.js +++ b/server/api/controllers/task-lists/update.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/task-lists/{id}: + * /task-lists/{id}: * patch: * summary: Update task list * description: Updates a task list. Requires board editor permissions. diff --git a/server/api/controllers/tasks/create.js b/server/api/controllers/tasks/create.js index c73e6ccf..cd1b6997 100755 --- a/server/api/controllers/tasks/create.js +++ b/server/api/controllers/tasks/create.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/task-lists/{taskListId}/tasks: + * /task-lists/{taskListId}/tasks: * post: * summary: Create task * description: Creates a task within a task list. Either `linkedCardId` or `name` must be provided. Requires board editor permissions. diff --git a/server/api/controllers/tasks/delete.js b/server/api/controllers/tasks/delete.js index fbb23bb9..64d6afc3 100755 --- a/server/api/controllers/tasks/delete.js +++ b/server/api/controllers/tasks/delete.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/tasks/{id}: + * /tasks/{id}: * delete: * summary: Delete task * description: Deletes a task. Requires board editor permissions. diff --git a/server/api/controllers/tasks/update.js b/server/api/controllers/tasks/update.js index 10b128d5..6d855511 100755 --- a/server/api/controllers/tasks/update.js +++ b/server/api/controllers/tasks/update.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/tasks/{id}: + * /tasks/{id}: * patch: * summary: Update task * description: Updates a task. Linked card tasks have limited update options. Requires board editor permissions. diff --git a/server/api/controllers/terms/show.js b/server/api/controllers/terms/show.js index 680b95aa..2d896220 100644 --- a/server/api/controllers/terms/show.js +++ b/server/api/controllers/terms/show.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/terms: + * /terms: * get: * summary: Get terms and conditions * description: Retrieves terms and conditions in the specified language. diff --git a/server/api/controllers/users/create.js b/server/api/controllers/users/create.js index b76f7178..c3c6f415 100755 --- a/server/api/controllers/users/create.js +++ b/server/api/controllers/users/create.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/users: + * /users: * post: * summary: Create user * description: Creates a user account. Requires admin privileges. diff --git a/server/api/controllers/users/delete.js b/server/api/controllers/users/delete.js index e82a5fff..a03ab25a 100755 --- a/server/api/controllers/users/delete.js +++ b/server/api/controllers/users/delete.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/users/{id}: + * /users/{id}: * delete: * summary: Delete user * description: Deletes a user account. Cannot delete the default admin user. Requires admin privileges. diff --git a/server/api/controllers/users/index.js b/server/api/controllers/users/index.js index eca9ad9a..4a9489e1 100755 --- a/server/api/controllers/users/index.js +++ b/server/api/controllers/users/index.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/users: + * /users: * get: * summary: Get all users * description: Retrieves a list of all users. Requires admin or project owner privileges. diff --git a/server/api/controllers/users/show.js b/server/api/controllers/users/show.js index 8900519d..ec3b7b66 100755 --- a/server/api/controllers/users/show.js +++ b/server/api/controllers/users/show.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/users/{id}: + * /users/{id}: * get: * summary: Get user details * description: Retrieves a user. Use 'me' as ID to get the current user. diff --git a/server/api/controllers/users/update-avatar.js b/server/api/controllers/users/update-avatar.js index 80e835ff..ebb6a5e7 100755 --- a/server/api/controllers/users/update-avatar.js +++ b/server/api/controllers/users/update-avatar.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/users/{id}/avatar: + * /users/{id}/avatar: * patch: * summary: Update user avatar * description: Updates a user's avatar image. Users can update their own avatar, admins can update any user's avatar. diff --git a/server/api/controllers/users/update-email.js b/server/api/controllers/users/update-email.js index 8f601c79..a6d8f4e9 100644 --- a/server/api/controllers/users/update-email.js +++ b/server/api/controllers/users/update-email.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/users/{id}/email: + * /users/{id}/email: * patch: * summary: Update user email * description: Updates a user's email address. Users must provide current password when updating their own email. Admins can update any user's email without a password. diff --git a/server/api/controllers/users/update-password.js b/server/api/controllers/users/update-password.js index ec641c74..83495fb8 100644 --- a/server/api/controllers/users/update-password.js +++ b/server/api/controllers/users/update-password.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/users/{id}/password: + * /users/{id}/password: * patch: * summary: Update user password * description: Updates a user's password. Users must provide a current password when updating their own password. Admins can update any user's password without the current password. Returns a new access token when updating own password. diff --git a/server/api/controllers/users/update-username.js b/server/api/controllers/users/update-username.js index 63248002..aaed9a34 100644 --- a/server/api/controllers/users/update-username.js +++ b/server/api/controllers/users/update-username.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/users/{id}/username: + * /users/{id}/username: * patch: * summary: Update user username * description: Updates a user's username. Users must provide a current password when updating their own username (unless they are SSO users with `oidcIgnoreUsername` enabled). Admins can update any user's username without the current password. diff --git a/server/api/controllers/users/update.js b/server/api/controllers/users/update.js index 4232e8a2..a5677276 100755 --- a/server/api/controllers/users/update.js +++ b/server/api/controllers/users/update.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/users/{id}: + * /users/{id}: * patch: * summary: Update user * description: Updates a user. Users can update their own profile, admins can update any user. diff --git a/server/api/controllers/webhooks/create.js b/server/api/controllers/webhooks/create.js index 3e65bf0e..67eb5808 100644 --- a/server/api/controllers/webhooks/create.js +++ b/server/api/controllers/webhooks/create.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/webhooks: + * /webhooks: * post: * summary: Create webhook * description: Creates a webhook. Requires admin privileges. diff --git a/server/api/controllers/webhooks/delete.js b/server/api/controllers/webhooks/delete.js index 93d34f89..d6664fe7 100644 --- a/server/api/controllers/webhooks/delete.js +++ b/server/api/controllers/webhooks/delete.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/webhooks/{id}: + * /webhooks/{id}: * delete: * summary: Delete webhook * description: Deletes a webhook. Requires admin privileges. diff --git a/server/api/controllers/webhooks/index.js b/server/api/controllers/webhooks/index.js index f4445116..b6998f61 100644 --- a/server/api/controllers/webhooks/index.js +++ b/server/api/controllers/webhooks/index.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/webhooks: + * /webhooks: * get: * summary: Get all webhooks * description: Retrieves a list of all configured webhooks. Requires admin privileges. diff --git a/server/api/controllers/webhooks/update.js b/server/api/controllers/webhooks/update.js index 097244d0..b0c8ebdd 100644 --- a/server/api/controllers/webhooks/update.js +++ b/server/api/controllers/webhooks/update.js @@ -5,7 +5,7 @@ /** * @swagger - * /api/webhooks/{id}: + * /webhooks/{id}: * patch: * summary: Update webhook * description: Updates a webhook. Requires admin privileges. diff --git a/server/config/swagger.js b/server/config/swagger.js index d3ecce84..f50a42ad 100644 --- a/server/config/swagger.js +++ b/server/config/swagger.js @@ -18,6 +18,12 @@ module.exports = { url: 'https://github.com/plankanban/planka/blob/master/LICENSE.md', }, }, + servers: [ + { + url: '/api', + description: 'Base path for API endpoints', + }, + ], }, apis: ['./api/controllers/**/*.js', './api/models/*.js', './api/responses/*.js'], };