Updated API from documentation release

Author: ct-sdks[bot]

api-specs/api/resources/customers.raml

@@ -48,6 +48,8 @@ post:
   get:
     displayName: Get customer by password verification token
     securedBy: [oauth_2_0: { scopes: ['view_customers:{projectKey}'] }]
+    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).
     responses:
       200:
         body:
@@ -62,6 +64,8 @@ post:
   get:
     displayName: Get customer by email verification token
     securedBy: [oauth_2_0: { scopes: ['view_customers:{projectKey}'] }]
+    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).
     responses:
       200:
         body:
@@ -71,8 +75,11 @@ post:
   type: base
   post:
     displayName: Create a Token for verifying the Customer's Email
-    description: Produces the [CustomerEmailTokenCreated](ctp:api:type:CustomerEmailTokenCreatedMessage) Message.
     securedBy: [oauth_2_0: { scopes: ['manage_customers:{projectKey}'] }]
+    description: |
+      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.
     body:
       application/json:
         example: !include ../examples/Customer/CustomerCreateEmailToken.json
@@ -88,6 +95,8 @@ post:
   post:
     displayName: Verifies customer's email.
     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.
     securedBy: [oauth_2_0: { scopes: ['manage_customers:{projectKey}'] }]
     body:
@@ -124,6 +133,10 @@ post:
   post:
     displayName: Reset Customer's Password
     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`.
     securedBy: [oauth_2_0: { scopes: ['manage_customers:{projectKey}'] }]
     body:
@@ -143,6 +156,10 @@ post:
   post:
     displayName: Create a Token for Resetting the Customer's Password
     securedBy: [oauth_2_0: { scopes: ['manage_customers:{projectKey}'] }]
+    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.
     body:
       application/json:
         example: !include ../examples/Customer/CustomerCreatePasswordResetToken.json

api-specs/api/resources/in-store.raml

@@ -1817,6 +1817,8 @@ uriParameters:
     get:
       displayName: Get customer by password verification token in store
       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.
       securedBy:
         - oauth_2_0:
@@ -1837,6 +1839,8 @@ uriParameters:
     get:
       displayName: Get customer by email verification token in store
       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.
       securedBy:
         - oauth_2_0:
@@ -1854,6 +1858,8 @@ uriParameters:
     post:
       displayName: Create a Token for verifying the Customer's Email in store
       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.
       securedBy:
         - oauth_2_0:
@@ -1874,7 +1880,8 @@ uriParameters:
     post:
       displayName: Verify Customer's Email in store
       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.
@@ -1920,9 +1927,14 @@ uriParameters:
     post:
       displayName: Reset Customer's Password in store
       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.
+
       securedBy:
         - oauth_2_0:
             scopes:
@@ -1944,6 +1956,10 @@ uriParameters:
     post:
       displayName: Create a Token for Resetting the Customer's Password in store
       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.
       securedBy:
         - oauth_2_0: