DEVDOCS-5951: [update] add storefront graphql customer updates

docs/store-operations/customers/index.mdx

@@ -19,7 +19,7 @@ You can extend the data for customer records using [customer metafields](/docs/r
 
 You can use the following APIs to work with customer data and authentication:
 
-* [GraphQL Storefront API](/docs/storefront/graphql/customers)
+* [GraphQL storefront API](/docs/storefront/graphql/customers)
 * [REST storefront customers API](/docs/rest-storefront/customers)
 * [REST management API V3 customers](/docs/rest-management/customers/addresses)
 * [REST management API V2 customers](/docs/rest-management/customers-v2)
@@ -72,6 +72,77 @@ The following endpoints are available:
 **GraphQL API**
 - Customers GraphQL API
 
+### GraphQL API
+
+The [customers GraphQL storefront API](/docs/storefront/graphql/customers) offers an end-to-end shopper experience and customer account management. Developers can perform the following mutations and queries:
+
+* Register a customer
+* Update a customer
+* Add a customer address
+* Update a customer address
+* Delete a customer address
+* Change a customer password
+* Request a password reset
+* Reset a password
+* Get a customer address book
+
+#### Examples
+
+Register a customer using the form field configuration set up in the control panel for both the account signup and address fields.
+
+<Tabs items={[`Request`, `Response`]}>
+  <Tab>
+    ```json filename="Example mutation: Register a customer" showLineNumbers copy
+     mutation RegisterCustomer($input: RegisterCustomerInput!, $reCaptchaV2: ReCaptchaV2Input) {
+     customer {
+      registerCustomer(input: $input, reCaptchaV2: $reCaptchaV2) {
+        customer {
+          firstName
+          lastName
+        }
+        errors {
+          ... on EmailAlreadyInUseError {
+            message
+          }
+          ... on AccountCreationDisabledError {
+            message
+          }
+          ... on CustomerRegistrationError {
+            message
+          }
+          ... on ValidationError {
+            message
+          }
+        }
+      }
+    }
+  }
+`)
+```
+  </Tab>
+  <Tab>
+    ```json filename="Example mutation: Register a customer" showLineNumbers copy
+    # Success
+
+    {
+      "data": {
+        "customer": {
+          "registerCustomer": {
+            "customer": {
+              "firstName": "Jon",
+              "lastName": "Smith"
+            },
+            "errors": []
+          }
+        }
+      }
+    }
+```
+</Tab>
+</Tabs>
+
+For more information, see [GraphQL Storefront API: Customers](/docs/storefront/graphql/customers).
+
 **REST API**
 - V3 customers REST API
 - V2 customers REST API
@@ -195,6 +266,8 @@ The V3 customers API offers two ways to set a customer's password:
 
 [Password confirmation](/docs/rest-management/subscribers#create-a-subscriber) and [validation](/docs/rest-management/customers-v2/customer-passwords#validate-a-password) are still available under the V2 customers API.
 
+The storefront GraphQL API allows you to authenticate calls using the [Create a storefront token](/docs/rest-authentication/tokens#create-a-token) REST endpoint. For more information, see [Authenticating requests to the GraphQL Storefront API](/docs/start/authentication/graphql-storefront).
+
 ## Subscribers API
 
 The subscribers API allows you to manage subscribers who have signed up for the store’s newsletter or have signed up for abandoned cart emails.
@@ -245,6 +318,9 @@ Accept: application/json
 * [Customer Login API](/docs/start/authentication/customer-login)
 * [Current Customer API](/docs/start/authentication/current-customer)
 
+#### GraphQL storefront API
+* [Customers](/docs/storefront/graphql/customers)
+
 #### REST storefront API
 
 * [Customers](/docs/rest-storefront/customers)