chore(docs): Generated API Reference (#4706)

Co-authored-by: olivermrbl <olivermrbl@users.noreply.github.com>
Co-authored-by: Shahed Nasser <shahednasser@gmail.com>

docs/api/admin/components/schemas/CustomShippingOption.yaml

@@ -1,8 +1,8 @@
 title: Custom Shipping Option
 description: >-
-  Custom Shipping Options are 'overriden' Shipping Options. Store managers can
-  attach a Custom Shipping Option to a cart in order to set a custom price for a
-  particular Shipping Option
+  Custom Shipping Options are overriden Shipping Options. Admins can attach a
+  Custom Shipping Option to a cart in order to set a custom price for a
+  particular Shipping Option.
 type: object
 required:
   - cart_id
@@ -29,9 +29,8 @@ properties:
     type: string
     example: so_01G1G5V27GYX4QXNARRQCW1N8T
   shipping_option:
-    description: >-
-      A shipping option object. Available if the relation `shipping_option` is
-      expanded.
+    description: The details of the overriden shipping options.
+    x-expandable: shipping_option
     nullable: true
     $ref: ./ShippingOption.yaml
   cart_id:
@@ -40,7 +39,8 @@ properties:
     type: string
     example: cart_01G8ZH853Y6TFXWPG5EYE81X63
   cart:
-    description: A cart object. Available if the relation `cart` is expanded.
+    description: The details of the cart this shipping option belongs to.
+    x-expandable: cart
     nullable: true
     $ref: ./Cart.yaml
   created_at:
@@ -62,3 +62,7 @@ properties:
     type: object
     example:
       car: white
+    externalDocs:
+      description: Learn about the metadata attribute, and how to delete and update it.
+      url: >-
+        https://docs.medusajs.com/development/entities/overview#metadata-attribute