docs/v2/storefront/index.yaml in spree_api-4.2.1 vs docs/v2/storefront/index.yaml in spree_api-4.2.2

@@ -237,25 +237,34 @@
         '403':
           $ref: '#/components/responses/403Forbidden'
       security:
         - bearerAuth: []
   '/api/v2/storefront/account/addresses/{id}':
+    delete:
+      description: 'Removes selected Address for the signed in User. It uses soft-delete for addresses with shipments and orders.'
+      tags:
+        - Account
+      operationId: Remove Address
+      parameters:
+        - $ref: '#/components/parameters/AddressId'
+      responses:
+        '204':
+          description: Requested Address has been removed from the User Account
+        '404':
+          $ref: '#/components/responses/404NotFound'
+      security:
+        - bearerAuth: []
+      summary: Remove Address
     patch:
       description: >-
         Update selected Address for the signed in User
       summary: List of Addresses
       tags:
         - Account
       operationId: 'Update Address'
       parameters:
-        - name: id
-          in: path
-          required: true
-          description: Selected Address for update
-          schema:
-            type: string
-          example: '1'
+        - $ref: '#/components/parameters/AddressId'
       requestBody:
         required: true
         content:
           application/vnd.api+json:
             schema:
@@ -5244,9 +5253,17 @@
         - phone
         - zipcode
         - state_name
         - country_iso
   parameters:
+    AddressId:
+      name: address_id
+      in: path
+      required: true
+      description: Address ID
+      schema:
+        type: string
+      example: '1'
     CreditCardIncludeParam:
       name: include
       in: query
       required: false
       schema: