TASK: Updating RAML types, Postman and OAS definition

Author: ct-sdks[bot]

oas/api/openapi.yaml

@@ -8577,7 +8577,9 @@ paths:
             - "manage_customers:{projectKey}"
       operationId: ByProjectKeyCustomersEmailTokenPost
       description: |-
-        Produces the [CustomerEmailTokenCreated](ctp:api:type:CustomerEmailTokenCreatedMessage) Message.
+        Use this method to create an email token for a global Customer during their [email verification process](/../api/customers-overview#customer-email-verification).
+
+        Creating an email token for the Customer produces the [CustomerEmailTokenCreated](ctp:api:type:CustomerEmailTokenCreatedMessage) Message.
       requestBody:
         content:
           application/json:
@@ -8624,6 +8626,8 @@ paths:
         - oauth_2_0:
             - "view_customers:{projectKey}"
       operationId: ByProjectKeyCustomersEmailTokenByEmailTokenGet
+      description: |-
+        Use this method to retrieve a global Customer's details by using the email token during their [email verification process](/../api/customers-overview#customer-email-verification).
       parameters:
         - name: expand
           in: query
@@ -8670,6 +8674,8 @@ paths:
             - "manage_customers:{projectKey}"
       operationId: ByProjectKeyCustomersEmailConfirmPost
       description: |-
+        Use this method to verify a global Customer's email during their [email verification process](/../api/customers-overview#customer-email-verification).
+
         Verifying the email of the Customer produces the [CustomerEmailVerified](ctp:api:type:CustomerEmailVerifiedMessage) Message.
       requestBody:
         content:
@@ -8939,6 +8945,10 @@ paths:
         - oauth_2_0:
             - "manage_customers:{projectKey}"
       operationId: ByProjectKeyCustomersPasswordTokenPost
+      description: |-
+        Use this method to create a password reset token for a global Customer during their [password reset process](/../api/customers-overview#customer-password-reset).
+
+        Creating a password reset token does not invalidate existing tokens.
       requestBody:
         content:
           application/json:
@@ -8985,6 +8995,8 @@ paths:
         - oauth_2_0:
             - "view_customers:{projectKey}"
       operationId: ByProjectKeyCustomersPasswordTokenByPasswordTokenGet
+      description: |-
+        Use this method to retrieve the details of a global Customer by using the password token during their [password reset process](/../api/customers-overview#customer-password-reset).
       parameters:
         - name: expand
           in: query
@@ -9031,6 +9043,10 @@ paths:
             - "manage_customers:{projectKey}"
       operationId: ByProjectKeyCustomersPasswordResetPost
       description: |-
+        Use this method to reset a global Customer's password during their [password reset process](/../api/customers-overview#customer-password-reset).
+
+        After the password is reset, any previously issued access and/or refresh tokens created through the [password flow](/authorization#password-flow) or [refresh token flow](/authorization#refresh-token-flow) are invalidated.
+
         Resetting the password of the Customer produces the [CustomerPasswordUpdated](ctp:api:type:CustomerPasswordUpdatedMessage) Message with `reset=true`.
       requestBody:
         content:
@@ -12524,6 +12540,8 @@ paths:
             - "manage_customers:{projectKey}:{storeKey}"
       operationId: ByProjectKeyInStoreKeyByStoreKeyCustomersEmailTokenPost
       description: |-
+        Use this method to create an email token for a Store-specific Customer during their [email verification process](/../api/customers-overview#customer-email-verification).
+
         If the Customer exists in the Project but the `stores` field references a different Store, this method returns a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error.
       requestBody:
         content:
@@ -12578,6 +12596,8 @@ paths:
             - "view_customers:{projectKey}:{storeKey}"
       operationId: ByProjectKeyInStoreKeyByStoreKeyCustomersEmailTokenByEmailTokenGet
       description: |-
+        Use this method to retrieve a Store-specific Customer's details by using the email token during their [email verification process](/../api/customers-overview#customer-email-verification).
+
         If the Customer exists in the Project but the `stores` field references a different [Store](ctp:api:type:Store), this method returns a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error.
       parameters:
         - name: expand
@@ -12631,7 +12651,8 @@ paths:
             - "manage_customers:{projectKey}:{storeKey}"
       operationId: ByProjectKeyInStoreKeyByStoreKeyCustomersEmailConfirmPost
       description: |-
-        The customer verifies the email using the token value.
+        Use this method to verify a Store-specific Customer's email during their [email verification process](/../api/customers-overview#customer-email-verification).
+
         Verifying the email of the Customer produces the [CustomerEmailVerified](ctp:api:type:CustomerEmailVerifiedMessage) Message.
 
         If the Customer exists in the Project but the `stores` field references a different [Store](ctp:api:type:Store), this method returns a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error.
@@ -12929,6 +12950,10 @@ paths:
             - "manage_customers:{projectKey}:{storeKey}"
       operationId: ByProjectKeyInStoreKeyByStoreKeyCustomersPasswordTokenPost
       description: |-
+        Use this method to create a password reset token for a Store-specific Customer during their [password reset process](/../api/customers-overview#customer-password-reset).
+
+        Creating a password reset token does not invalidate existing tokens.
+
         If the Customer exists in the Project but the `stores` field references a different Store, this method returns a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error.
       requestBody:
         content:
@@ -12983,6 +13008,8 @@ paths:
             - "view_customers:{projectKey}:{storeKey}"
       operationId: ByProjectKeyInStoreKeyByStoreKeyCustomersPasswordTokenByPasswordTokenGet
       description: |-
+        Use this method to retrieve a Store-specific Customer's details by using the password reset token during their [password reset process](/../api/customers-overview#customer-password-reset).
+
         If the Customer exists in the Project but the `stores` field references a different Store, this method returns a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error.
       parameters:
         - name: expand
@@ -13036,9 +13063,13 @@ paths:
             - "manage_customers:{projectKey}:{storeKey}"
       operationId: ByProjectKeyInStoreKeyByStoreKeyCustomersPasswordResetPost
       description: |-
+        Use this method to reset a Store-specific Customer's password during their [password reset process](/../api/customers-overview#customer-password-reset).
+
+        After the password is reset, any previously issued access and/or refresh tokens created through the [password flow](/authorization#password-flow) or [refresh token flow](/authorization#refresh-token-flow) are invalidated.
+
         Resetting the password of the Customer produces the [CustomerPasswordUpdated](ctp:api:type:CustomerPasswordUpdatedMessage) Message with `reset=true`.
 
-        If the Customer exists in the Project but the `stores` field references a different [Store](ctp:api:type:Store), this method returns a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error.
+        If the Customer exists in the Project but the `stores` field references a different [Store](ctp:api:type:Store), then this method returns a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error.
       requestBody:
         content:
           application/json: