From 1f1b85afbb2ccbc0bbce919fd02646ddbb7ccb12 Mon Sep 17 00:00:00 2001
From: Shahed Nasser <shahednasser@gmail.com>
Date: Mon, 26 Dec 2022 18:09:22 +0200
Subject: [PATCH] docs: shortened summaries in API reference (#2902)

---
 .../admin/discounts/add-resources-to-condition-batch.ts       | 2 +-
 .../admin/discounts/delete-resources-from-condition-batch.ts  | 2 +-
 .../medusa/src/api/routes/admin/order-edits/add-line-item.ts  | 2 +-
 .../src/api/routes/admin/order-edits/delete-line-item.ts      | 2 +-
 .../src/api/routes/admin/order-edits/delete-order-edit.ts     | 2 +-
 .../medusa/src/api/routes/admin/order-edits/get-order-edit.ts | 2 +-
 .../src/api/routes/admin/order-edits/request-confirmation.ts  | 2 +-
 .../routes/admin/order-edits/update-order-edit-line-item.ts   | 2 +-
 .../src/api/routes/admin/order-edits/update-order-edit.ts     | 2 +-
 .../admin/payment-collections/delete-payment-collection.ts    | 2 +-
 .../admin/payment-collections/get-payment-collection.ts       | 2 +-
 .../payment-collections/mark-authorized-payment-collection.ts | 2 +-
 .../admin/payment-collections/update-payment-collection.ts    | 2 +-
 .../routes/admin/publishable-api-keys/add-channels-batch.ts   | 2 +-
 .../admin/publishable-api-keys/create-publishable-api-key.ts  | 2 +-
 .../admin/publishable-api-keys/delete-channels-batch.ts       | 2 +-
 .../admin/publishable-api-keys/delete-publishable-api-key.ts  | 2 +-
 .../admin/publishable-api-keys/get-publishable-api-key.ts     | 2 +-
 .../list-publishable-api-key-sales-channels.ts                | 2 +-
 .../admin/publishable-api-keys/revoke-publishable-api-key.ts  | 2 +-
 .../admin/publishable-api-keys/update-publishable-api-key.ts  | 2 +-
 .../src/api/routes/admin/uploads/create-protected-upload.ts   | 4 ++--
 .../src/api/routes/store/orders/confirm-order-request.ts      | 4 ++--
 packages/medusa/src/api/routes/store/orders/request-order.ts  | 2 +-
 .../payment-collections/authorize-batch-payment-sessions.ts   | 4 ++--
 .../store/payment-collections/authorize-payment-session.ts    | 4 ++--
 .../store/payment-collections/get-payment-collection.ts       | 2 +-
 .../payment-collections/manage-batch-payment-sessions.ts      | 4 ++--
 .../store/payment-collections/manage-payment-session.ts       | 4 ++--
 .../store/payment-collections/refresh-payment-session.ts      | 2 +-
 30 files changed, 36 insertions(+), 36 deletions(-)

diff --git a/packages/medusa/src/api/routes/admin/discounts/add-resources-to-condition-batch.ts b/packages/medusa/src/api/routes/admin/discounts/add-resources-to-condition-batch.ts
index 6d17a87f5b..b500deadac 100644
--- a/packages/medusa/src/api/routes/admin/discounts/add-resources-to-condition-batch.ts
+++ b/packages/medusa/src/api/routes/admin/discounts/add-resources-to-condition-batch.ts
@@ -12,7 +12,7 @@ import { FindParams } from "../../../../types/common"
 /**
  * @oas [post] /discounts/{discount_id}/conditions/{condition_id}/batch
  * operationId: "PostDiscountsDiscountConditionsConditionBatch"
- * summary: "Add a batch of resources to a discount condition"
+ * summary: "Add Batch Resources"
  * description: "Add a batch of resources to a discount condition."
  * x-authenticated: true
  * parameters:
diff --git a/packages/medusa/src/api/routes/admin/discounts/delete-resources-from-condition-batch.ts b/packages/medusa/src/api/routes/admin/discounts/delete-resources-from-condition-batch.ts
index 9e3bf68d17..a2064606db 100644
--- a/packages/medusa/src/api/routes/admin/discounts/delete-resources-from-condition-batch.ts
+++ b/packages/medusa/src/api/routes/admin/discounts/delete-resources-from-condition-batch.ts
@@ -11,7 +11,7 @@ import { FindParams } from "../../../../types/common"
 /**
  * @oas [delete] /discounts/{discount_id}/conditions/{condition_id}/batch
  * operationId: "DeleteDiscountsDiscountConditionsConditionBatch"
- * summary: "Delete a batch of resources from a discount condition"
+ * summary: "Delete Batch Resources"
  * description: "Delete a batch of resources from a discount condition."
  * x-authenticated: true
  * parameters:
diff --git a/packages/medusa/src/api/routes/admin/order-edits/add-line-item.ts b/packages/medusa/src/api/routes/admin/order-edits/add-line-item.ts
index 1aff36ecb6..e079bc4642 100644
--- a/packages/medusa/src/api/routes/admin/order-edits/add-line-item.ts
+++ b/packages/medusa/src/api/routes/admin/order-edits/add-line-item.ts
@@ -11,7 +11,7 @@ import {
 /**
  * @oas [post] /order-edits/{id}/items
  * operationId: "PostOrderEditsEditLineItems"
- * summary: "Add an line item to an order (edit)"
+ * summary: "Add a Line Item"
  * description: "Create an OrderEdit LineItem."
  * parameters:
  *   - (path) id=* {string} The ID of the Order Edit.
diff --git a/packages/medusa/src/api/routes/admin/order-edits/delete-line-item.ts b/packages/medusa/src/api/routes/admin/order-edits/delete-line-item.ts
index faad5d8096..3747ba758e 100644
--- a/packages/medusa/src/api/routes/admin/order-edits/delete-line-item.ts
+++ b/packages/medusa/src/api/routes/admin/order-edits/delete-line-item.ts
@@ -9,7 +9,7 @@ import {
 /**
  * @oas [delete] /order-edits/{id}/items/{item_id}
  * operationId: "DeleteOrderEditsOrderEditLineItemsLineItem"
- * summary: "Delete line items from an order edit and create change item"
+ * summary: "Delete a Line Item"
  * description: "Delete line items from an order edit and create change item"
  * x-authenticated: true
  * parameters:
diff --git a/packages/medusa/src/api/routes/admin/order-edits/delete-order-edit.ts b/packages/medusa/src/api/routes/admin/order-edits/delete-order-edit.ts
index f65b60f98f..16f1653b71 100644
--- a/packages/medusa/src/api/routes/admin/order-edits/delete-order-edit.ts
+++ b/packages/medusa/src/api/routes/admin/order-edits/delete-order-edit.ts
@@ -5,7 +5,7 @@ import { OrderEditService } from "../../../../services"
  * @oas [delete] /order-edits/{id}
  * operationId: "DeleteOrderEditsOrderEdit"
  * summary: "Delete an Order Edit"
- * description: "Deletes an Order Edit"
+ * description: "Delete an Order Edit"
  * x-authenticated: true
  * parameters:
  *   - (path) id=* {string} The ID of the Order Edit to delete.
diff --git a/packages/medusa/src/api/routes/admin/order-edits/get-order-edit.ts b/packages/medusa/src/api/routes/admin/order-edits/get-order-edit.ts
index 458230490a..0ac1ec7451 100644
--- a/packages/medusa/src/api/routes/admin/order-edits/get-order-edit.ts
+++ b/packages/medusa/src/api/routes/admin/order-edits/get-order-edit.ts
@@ -5,7 +5,7 @@ import { FindParams } from "../../../../types/common"
 /**
  * @oas [get] /order-edits/{id}
  * operationId: "GetOrderEditsOrderEdit"
- * summary: "Retrieve an OrderEdit"
+ * summary: "Get an OrderEdit"
  * description: "Retrieves a OrderEdit."
  * x-authenticated: true
  * parameters:
diff --git a/packages/medusa/src/api/routes/admin/order-edits/request-confirmation.ts b/packages/medusa/src/api/routes/admin/order-edits/request-confirmation.ts
index 1715895a73..d6179150ee 100644
--- a/packages/medusa/src/api/routes/admin/order-edits/request-confirmation.ts
+++ b/packages/medusa/src/api/routes/admin/order-edits/request-confirmation.ts
@@ -14,7 +14,7 @@ import { PaymentCollectionType } from "../../../../models"
 /**
  * @oas [post] /order-edits/{id}/request
  * operationId: "PostOrderEditsOrderEditRequest"
- * summary: "Request order edit confirmation"
+ * summary: "Request Confirmation"
  * description: "Request customer confirmation of an Order Edit"
  * x-authenticated: true
  * parameters:
diff --git a/packages/medusa/src/api/routes/admin/order-edits/update-order-edit-line-item.ts b/packages/medusa/src/api/routes/admin/order-edits/update-order-edit-line-item.ts
index 92c7043ae4..bc9e4093d1 100644
--- a/packages/medusa/src/api/routes/admin/order-edits/update-order-edit-line-item.ts
+++ b/packages/medusa/src/api/routes/admin/order-edits/update-order-edit-line-item.ts
@@ -10,7 +10,7 @@ import {
 /**
  * @oas [post] /order-edits/{id}/items/{item_id}
  * operationId: "PostOrderEditsEditLineItemsLineItem"
- * summary: "Create or update the order edit change holding the line item changes"
+ * summary: "Upsert Line Item Change"
  * description: "Create or update the order edit change holding the line item changes"
  * x-authenticated: true
  * parameters:
diff --git a/packages/medusa/src/api/routes/admin/order-edits/update-order-edit.ts b/packages/medusa/src/api/routes/admin/order-edits/update-order-edit.ts
index 43f440be4b..4c39353ff0 100644
--- a/packages/medusa/src/api/routes/admin/order-edits/update-order-edit.ts
+++ b/packages/medusa/src/api/routes/admin/order-edits/update-order-edit.ts
@@ -11,7 +11,7 @@ import {
 /**
  * @oas [post] /order-edits/{id}
  * operationId: "PostOrderEditsOrderEdit"
- * summary: "Updates an OrderEdit"
+ * summary: "Update an OrderEdit"
  * description: "Updates a OrderEdit."
  * x-authenticated: true
  * parameters:
diff --git a/packages/medusa/src/api/routes/admin/payment-collections/delete-payment-collection.ts b/packages/medusa/src/api/routes/admin/payment-collections/delete-payment-collection.ts
index cc3b6c63b1..b87970532a 100644
--- a/packages/medusa/src/api/routes/admin/payment-collections/delete-payment-collection.ts
+++ b/packages/medusa/src/api/routes/admin/payment-collections/delete-payment-collection.ts
@@ -3,7 +3,7 @@ import { PaymentCollectionService } from "../../../../services"
 /**
  * @oas [delete] /payment-collections/{id}
  * operationId: "DeletePaymentCollectionsPaymentCollection"
- * summary: "Delete a Payment Collection"
+ * summary: "Del a PaymentCollection"
  * description: "Deletes a Payment Collection"
  * x-authenticated: true
  * parameters:
diff --git a/packages/medusa/src/api/routes/admin/payment-collections/get-payment-collection.ts b/packages/medusa/src/api/routes/admin/payment-collections/get-payment-collection.ts
index 6710b2c8f3..e76dc35793 100644
--- a/packages/medusa/src/api/routes/admin/payment-collections/get-payment-collection.ts
+++ b/packages/medusa/src/api/routes/admin/payment-collections/get-payment-collection.ts
@@ -4,7 +4,7 @@ import { FindParams } from "../../../../types/common"
 /**
  * @oas [get] /payment-collections/{id}
  * operationId: "GetPaymentCollectionsPaymentCollection"
- * summary: "Retrieve an PaymentCollection"
+ * summary: "Get a PaymentCollection"
  * description: "Retrieves a PaymentCollection."
  * x-authenticated: true
  * parameters:
diff --git a/packages/medusa/src/api/routes/admin/payment-collections/mark-authorized-payment-collection.ts b/packages/medusa/src/api/routes/admin/payment-collections/mark-authorized-payment-collection.ts
index 8e8a0fbfb3..42346356f6 100644
--- a/packages/medusa/src/api/routes/admin/payment-collections/mark-authorized-payment-collection.ts
+++ b/packages/medusa/src/api/routes/admin/payment-collections/mark-authorized-payment-collection.ts
@@ -4,7 +4,7 @@ import { PaymentCollectionService } from "../../../../services"
 /**
  * @oas [post] /payment-collections/{id}/authorize
  * operationId: "PostPaymentCollectionsPaymentCollectionAuthorize"
- * summary: "Set the status of PaymentCollection as Authorized"
+ * summary: "Mark Authorized"
  * description: "Sets the status of PaymentCollection as Authorized."
  * x-authenticated: true
  * parameters:
diff --git a/packages/medusa/src/api/routes/admin/payment-collections/update-payment-collection.ts b/packages/medusa/src/api/routes/admin/payment-collections/update-payment-collection.ts
index 40adb2aed9..83af43a19b 100644
--- a/packages/medusa/src/api/routes/admin/payment-collections/update-payment-collection.ts
+++ b/packages/medusa/src/api/routes/admin/payment-collections/update-payment-collection.ts
@@ -6,7 +6,7 @@ import { PaymentCollectionService } from "../../../../services"
 /**
  * @oas [post] /payment-collections/{id}
  * operationId: "PostPaymentCollectionsPaymentCollection"
- * summary: "Updates a PaymentCollection"
+ * summary: "Update PaymentCollection"
  * description: "Updates a PaymentCollection."
  * x-authenticated: true
  * parameters:
diff --git a/packages/medusa/src/api/routes/admin/publishable-api-keys/add-channels-batch.ts b/packages/medusa/src/api/routes/admin/publishable-api-keys/add-channels-batch.ts
index 0148df84ef..9de91351d9 100644
--- a/packages/medusa/src/api/routes/admin/publishable-api-keys/add-channels-batch.ts
+++ b/packages/medusa/src/api/routes/admin/publishable-api-keys/add-channels-batch.ts
@@ -9,7 +9,7 @@ import PublishableApiKeyService from "../../../../services/publishable-api-key"
 /**
  * @oas [post] /publishable-api-keys/{id}/sales-channels/batch
  * operationId: "PostPublishableApiKeySalesChannelsChannelsBatch"
- * summary: "Add sales channel to a publishable api key scope"
+ * summary: "Add SalesChannels"
  * description: "Assign a batch of sales channels to a publishable api key."
  * x-authenticated: true
  * parameters:
diff --git a/packages/medusa/src/api/routes/admin/publishable-api-keys/create-publishable-api-key.ts b/packages/medusa/src/api/routes/admin/publishable-api-keys/create-publishable-api-key.ts
index a0c08a2cda..a480f588b6 100644
--- a/packages/medusa/src/api/routes/admin/publishable-api-keys/create-publishable-api-key.ts
+++ b/packages/medusa/src/api/routes/admin/publishable-api-keys/create-publishable-api-key.ts
@@ -7,7 +7,7 @@ import PublishableApiKeyService from "../../../../services/publishable-api-key"
 /**
  * @oas [post] /publishable-api-keys
  * operationId: "PostPublishableApiKeys"
- * summary: "Create a PublishableApiKey"
+ * summary: "Create PublishableApiKey"
  * description: "Creates a PublishableApiKey."
  * requestBody:
  *   content:
diff --git a/packages/medusa/src/api/routes/admin/publishable-api-keys/delete-channels-batch.ts b/packages/medusa/src/api/routes/admin/publishable-api-keys/delete-channels-batch.ts
index b29b6de0fa..4c1d40206e 100644
--- a/packages/medusa/src/api/routes/admin/publishable-api-keys/delete-channels-batch.ts
+++ b/packages/medusa/src/api/routes/admin/publishable-api-keys/delete-channels-batch.ts
@@ -9,7 +9,7 @@ import PublishableApiKeyService from "../../../../services/publishable-api-key"
 /**
  * @oas [delete] /publishable-api-keys/{id}/sales-channels/batch
  * operationId: "DeletePublishableApiKeySalesChannelsChannelsBatch"
- * summary: "Remove sales channel from a publishable api key scope"
+ * summary: "Delete SalesChannels"
  * description: "Remove a batch of sales channels from a publishable api key."
  * x-authenticated: true
  * parameters:
diff --git a/packages/medusa/src/api/routes/admin/publishable-api-keys/delete-publishable-api-key.ts b/packages/medusa/src/api/routes/admin/publishable-api-keys/delete-publishable-api-key.ts
index c916929798..25d69f06a0 100644
--- a/packages/medusa/src/api/routes/admin/publishable-api-keys/delete-publishable-api-key.ts
+++ b/packages/medusa/src/api/routes/admin/publishable-api-keys/delete-publishable-api-key.ts
@@ -5,7 +5,7 @@ import PublishableApiKeyService from "../../../../services/publishable-api-key"
 /**
  * @oas [delete] /publishable-api-keys/{id}
  * operationId: "DeletePublishableApiKeysPublishableApiKey"
- * summary: "Delete a PublishableApiKey"
+ * summary: "Delete PublishableApiKey"
  * description: "Deletes a PublishableApiKeys"
  * x-authenticated: true
  * parameters:
diff --git a/packages/medusa/src/api/routes/admin/publishable-api-keys/get-publishable-api-key.ts b/packages/medusa/src/api/routes/admin/publishable-api-keys/get-publishable-api-key.ts
index eda1667d77..4223587400 100644
--- a/packages/medusa/src/api/routes/admin/publishable-api-keys/get-publishable-api-key.ts
+++ b/packages/medusa/src/api/routes/admin/publishable-api-keys/get-publishable-api-key.ts
@@ -5,7 +5,7 @@ import PublishableApiKeyService from "../../../../services/publishable-api-key"
 /**
  * @oas [get] /publishable-api-keys/{id}
  * operationId: "GetPublishableApiKeysPublishableApiKey"
- * summary: "Get a Publishable API Key"
+ * summary: "Get a PublishableApiKey"
  * description: "Retrieve the Publishable Api Key."
  * parameters:
  *   - (path) id=* {string} The ID of the PublishableApiKey.
diff --git a/packages/medusa/src/api/routes/admin/publishable-api-keys/list-publishable-api-key-sales-channels.ts b/packages/medusa/src/api/routes/admin/publishable-api-keys/list-publishable-api-key-sales-channels.ts
index b9ac340377..47d575c5d5 100644
--- a/packages/medusa/src/api/routes/admin/publishable-api-keys/list-publishable-api-key-sales-channels.ts
+++ b/packages/medusa/src/api/routes/admin/publishable-api-keys/list-publishable-api-key-sales-channels.ts
@@ -7,7 +7,7 @@ import { extendedFindParamsMixin } from "../../../../types/common"
 /**
  * @oas [get] /publishable-api-keys/{id}/sales-channels
  * operationId: "GetPublishableApiKeySalesChannels"
- * summary: "List PublishableApiKey's SalesChannels"
+ * summary: "List SalesChannels"
  * description: "List PublishableApiKey's SalesChannels"
  * x-authenticated: true
  * parameters:
diff --git a/packages/medusa/src/api/routes/admin/publishable-api-keys/revoke-publishable-api-key.ts b/packages/medusa/src/api/routes/admin/publishable-api-keys/revoke-publishable-api-key.ts
index 6afe33e0b7..863934838a 100644
--- a/packages/medusa/src/api/routes/admin/publishable-api-keys/revoke-publishable-api-key.ts
+++ b/packages/medusa/src/api/routes/admin/publishable-api-keys/revoke-publishable-api-key.ts
@@ -6,7 +6,7 @@ import PublishableApiKeyService from "../../../../services/publishable-api-key"
 /**
  * @oas [post] /publishable-api-keys/{id}/revoke
  * operationId: "PostPublishableApiKeysPublishableApiKeyRevoke"
- * summary: "Revoke a PublishableApiKey"
+ * summary: "Revoke PublishableApiKey"
  * description: "Revokes a PublishableApiKey."
  * parameters:
  *   - (path) id=* {string} The ID of the PublishableApiKey.
diff --git a/packages/medusa/src/api/routes/admin/publishable-api-keys/update-publishable-api-key.ts b/packages/medusa/src/api/routes/admin/publishable-api-keys/update-publishable-api-key.ts
index 1b271cfca7..6d5d33ee6b 100644
--- a/packages/medusa/src/api/routes/admin/publishable-api-keys/update-publishable-api-key.ts
+++ b/packages/medusa/src/api/routes/admin/publishable-api-keys/update-publishable-api-key.ts
@@ -7,7 +7,7 @@ import PublishableApiKeyService from "../../../../services/publishable-api-key"
 /**
  * @oas [post] /publishable-api-key/{id}
  * operationId: "PostPublishableApiKysPublishableApiKey"
- * summary: "Updates a PublishableApiKey"
+ * summary: "Update PublishableApiKey"
  * description: "Updates a PublishableApiKey."
  * x-authenticated: true
  * parameters:
diff --git a/packages/medusa/src/api/routes/admin/uploads/create-protected-upload.ts b/packages/medusa/src/api/routes/admin/uploads/create-protected-upload.ts
index fc523c3d10..b87cffd814 100644
--- a/packages/medusa/src/api/routes/admin/uploads/create-protected-upload.ts
+++ b/packages/medusa/src/api/routes/admin/uploads/create-protected-upload.ts
@@ -4,8 +4,8 @@ import { IFileService } from "../../../../interfaces"
 /**
  * @oas [post] /uploads/protected
  * operationId: "PostUploadsProtected"
- * summary: "Upload files with acl or in a non-public bucket"
- * description: "Uploads at least one file to the specific fileservice that is installed in Medusa."
+ * summary: "Protected File Upload"
+ * description: "Uploads at least one file with ACL or a non-public bucket to the specific fileservice that is installed in Medusa."
  * x-authenticated: true
  * requestBody:
  *   content:
diff --git a/packages/medusa/src/api/routes/store/orders/confirm-order-request.ts b/packages/medusa/src/api/routes/store/orders/confirm-order-request.ts
index d41dab78c5..c941c84585 100644
--- a/packages/medusa/src/api/routes/store/orders/confirm-order-request.ts
+++ b/packages/medusa/src/api/routes/store/orders/confirm-order-request.ts
@@ -9,7 +9,7 @@ import {
 /**
  * @oas [post] /orders/customer/confirm
  * operationId: "PostOrdersCustomerOrderClaimsCustomerOrderClaimAccept"
- * summary: "Verify a claim to orders"
+ * summary: "Verify an Order Claim"
  * description: "Verifies the claim order token provided to the customer upon request of order ownership"
  * requestBody:
  *   content:
@@ -44,7 +44,7 @@ import {
  *   - api_token: []
  *   - cookie_auth: []
  * tags:
- *   - Invite
+ *   - Order
  * responses:
  *   200:
  *     description: OK
diff --git a/packages/medusa/src/api/routes/store/orders/request-order.ts b/packages/medusa/src/api/routes/store/orders/request-order.ts
index 39439fa648..ab9f8f36da 100644
--- a/packages/medusa/src/api/routes/store/orders/request-order.ts
+++ b/packages/medusa/src/api/routes/store/orders/request-order.ts
@@ -11,7 +11,7 @@ import { TokenEvents } from "../../../../types/token"
 /**
  * @oas [post] /orders/batch/customer/token
  * operationId: "PostOrdersCustomerOrderClaim"
- * summary: "Claim orders for signed in account"
+ * summary: "Claim an Order"
  * description: "Sends an email to emails registered to orders provided with link to transfer order ownership"
  * requestBody:
  *   content:
diff --git a/packages/medusa/src/api/routes/store/payment-collections/authorize-batch-payment-sessions.ts b/packages/medusa/src/api/routes/store/payment-collections/authorize-batch-payment-sessions.ts
index b5a6ff4c98..3f6e5aa86f 100644
--- a/packages/medusa/src/api/routes/store/payment-collections/authorize-batch-payment-sessions.ts
+++ b/packages/medusa/src/api/routes/store/payment-collections/authorize-batch-payment-sessions.ts
@@ -4,7 +4,7 @@ import { PaymentCollectionService } from "../../../../services"
 /**
  * @oas [post] /payment-collections/{id}/sessions/batch/authorize
  * operationId: "PostPaymentCollectionsSessionsBatchAuthorize"
- * summary: "Authorize Payment Sessions of a Payment Collection"
+ * summary: "Authorize PaymentSessions"
  * description: "Authorizes Payment Sessions of a Payment Collection."
  * x-authenticated: false
  * parameters:
@@ -33,7 +33,7 @@ import { PaymentCollectionService } from "../../../../services"
  *   - api_token: []
  *   - cookie_auth: []
  * tags:
- *   - Payment
+ *   - PaymentCollection
  * responses:
  *   200:
  *     description: OK
diff --git a/packages/medusa/src/api/routes/store/payment-collections/authorize-payment-session.ts b/packages/medusa/src/api/routes/store/payment-collections/authorize-payment-session.ts
index b2d580b3c0..83b6ca2324 100644
--- a/packages/medusa/src/api/routes/store/payment-collections/authorize-payment-session.ts
+++ b/packages/medusa/src/api/routes/store/payment-collections/authorize-payment-session.ts
@@ -5,7 +5,7 @@ import { PaymentCollectionService } from "../../../../services"
 /**
  * @oas [post] /payment-collections/{id}/sessions/{session_id}/authorize
  * operationId: "PostPaymentCollectionsSessionsSessionAuthorize"
- * summary: "Authorize a Payment Session of a Payment Collection"
+ * summary: "Authorize Payment Session"
  * description: "Authorizes a Payment Session of a Payment Collection."
  * x-authenticated: false
  * parameters:
@@ -30,7 +30,7 @@ import { PaymentCollectionService } from "../../../../services"
  *   - api_token: []
  *   - cookie_auth: []
  * tags:
- *   - Payment
+ *   - PaymentCollection
  * responses:
  *   200:
  *     description: OK
diff --git a/packages/medusa/src/api/routes/store/payment-collections/get-payment-collection.ts b/packages/medusa/src/api/routes/store/payment-collections/get-payment-collection.ts
index b6402497b3..9226e5b544 100644
--- a/packages/medusa/src/api/routes/store/payment-collections/get-payment-collection.ts
+++ b/packages/medusa/src/api/routes/store/payment-collections/get-payment-collection.ts
@@ -5,7 +5,7 @@ import { FindParams } from "../../../../types/common"
  * @oas [get] /payment-collections/{id}
  * operationId: "GetPaymentCollectionsPaymentCollection"
  * summary: "Retrieve an PaymentCollection"
- * description: "Retrieves a PaymentCollection."
+ * description: "Get a Payment Collection"
  * x-authenticated: false
  * parameters:
  *   - (path) id=* {string} The ID of the PaymentCollection.
diff --git a/packages/medusa/src/api/routes/store/payment-collections/manage-batch-payment-sessions.ts b/packages/medusa/src/api/routes/store/payment-collections/manage-batch-payment-sessions.ts
index 549ddd4751..f3566df96b 100644
--- a/packages/medusa/src/api/routes/store/payment-collections/manage-batch-payment-sessions.ts
+++ b/packages/medusa/src/api/routes/store/payment-collections/manage-batch-payment-sessions.ts
@@ -7,7 +7,7 @@ import { PaymentCollectionService } from "../../../../services"
 /**
  * @oas [post] /payment-collections/{id}/sessions/batch
  * operationId: "PostPaymentCollectionsPaymentCollectionSessionsBatch"
- * summary: "Manage Multiple Payment Sessions from Payment Collections"
+ * summary: "Manage Payment Sessions"
  * description: "Manages Multiple Payment Sessions from Payment Collections."
  * x-authenticated: false
  * parameters:
@@ -61,7 +61,7 @@ import { PaymentCollectionService } from "../../../../services"
  *   - api_token: []
  *   - cookie_auth: []
  * tags:
- *   - Payment
+ *   - PaymentCollection
  * responses:
  *   200:
  *     description: OK
diff --git a/packages/medusa/src/api/routes/store/payment-collections/manage-payment-session.ts b/packages/medusa/src/api/routes/store/payment-collections/manage-payment-session.ts
index cc99e80093..861c9f19ee 100644
--- a/packages/medusa/src/api/routes/store/payment-collections/manage-payment-session.ts
+++ b/packages/medusa/src/api/routes/store/payment-collections/manage-payment-session.ts
@@ -6,7 +6,7 @@ import { PaymentCollectionService } from "../../../../services"
 /**
  * @oas [post] /payment-collections/{id}/sessions
  * operationId: "PostPaymentCollectionsSessions"
- * summary: "Manage Payment Sessions from Payment Collections"
+ * summary: "Manage a Payment Session"
  * description: "Manages Payment Sessions from Payment Collections."
  * x-authenticated: false
  * parameters:
@@ -40,7 +40,7 @@ import { PaymentCollectionService } from "../../../../services"
  *   - api_token: []
  *   - cookie_auth: []
  * tags:
- *   - Payment
+ *   - PaymentCollection
  * responses:
  *   200:
  *     description: OK
diff --git a/packages/medusa/src/api/routes/store/payment-collections/refresh-payment-session.ts b/packages/medusa/src/api/routes/store/payment-collections/refresh-payment-session.ts
index f7294588f7..ac91104d15 100644
--- a/packages/medusa/src/api/routes/store/payment-collections/refresh-payment-session.ts
+++ b/packages/medusa/src/api/routes/store/payment-collections/refresh-payment-session.ts
@@ -4,7 +4,7 @@ import { PaymentCollectionService } from "../../../../services"
 /**
  * @oas [post] /payment-collections/{id}/sessions/{session_id}
  * operationId: PostPaymentCollectionsPaymentCollectionPaymentSessionsSession
- * summary: Refresh a Payment Session
+ * summary: "Refresh a Payment Session"
  * description: "Refreshes a Payment Session to ensure that it is in sync with the Payment Collection."
  * x-authenticated: false
  * parameters: