docs: add link to manage metadata section in OAS and API reference (#13102)

2025-07-31 14:42:14 +03:00
parent 1bdf602f1c
commit a48063ec26
550 changed files with 3359 additions and 4 deletions
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminAddDraftOrderItems.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminAddDraftOrderItems.yaml
@@ -42,3 +42,6 @@ properties:
        metadata:
          type: object
          description: The item's metadata, can hold custom key-value pairs.
+          externalDocs:
+            url: https://docs.medusajs.com/api/admin#manage-metadata
+            description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminAddDraftOrderShippingMethod.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminAddDraftOrderShippingMethod.yaml
@@ -25,3 +25,6 @@ properties:
  metadata:
    type: object
    description: The shipping method's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminBatchUpdateProduct.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminBatchUpdateProduct.yaml
@@ -147,6 +147,9 @@ properties:
  metadata:
    type: object
    description: The product's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  external_id:
    type: string
    title: external_id
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminBatchUpdateProductVariant.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminBatchUpdateProductVariant.yaml
@@ -71,6 +71,9 @@ properties:
  metadata:
    type: object
    description: The product variant's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  prices:
    type: array
    description: The product variant's prices.
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminClaim.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminClaim.yaml
@@ -68,6 +68,9 @@ properties:
  metadata:
    type: object
    description: The claim's metadata, used to store custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCollection.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCollection.yaml
@@ -45,3 +45,6 @@ properties:
  metadata:
    type: object
    description: The collection's metadata, used to store custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCreateCustomerGroup.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCreateCustomerGroup.yaml
@@ -11,3 +11,6 @@ properties:
  metadata:
    type: object
    description: The customer group's metadata, used to store custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCreateFulfillment.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCreateFulfillment.yaml
@@ -70,6 +70,9 @@ properties:
      metadata:
        type: object
        description: The delivery address's metadata, used to store custom key-value pairs.
+        externalDocs:
+          url: https://docs.medusajs.com/api/admin#manage-metadata
+          description: Learn how to manage metadata
  items:
    type: array
    description: The items to fulfill.
@@ -167,3 +170,6 @@ properties:
  metadata:
    type: object
    description: The fulfillment's metadata, used to store custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCreateFulfillmentSetServiceZones.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCreateFulfillmentSetServiceZones.yaml
@@ -22,6 +22,9 @@ properties:
            metadata:
              type: object
              description: The geo zone's metadata.
+              externalDocs:
+                url: https://docs.medusajs.com/api/admin#manage-metadata
+                description: Learn how to manage metadata
            country_code:
              type: string
              title: country_code
@@ -42,6 +45,9 @@ properties:
            metadata:
              type: object
              description: The geo zone's metadata.
+              externalDocs:
+                url: https://docs.medusajs.com/api/admin#manage-metadata
+                description: Learn how to manage metadata
            country_code:
              type: string
              title: country_code
@@ -71,6 +77,9 @@ properties:
            metadata:
              type: object
              description: The geo zone's metadata.
+              externalDocs:
+                url: https://docs.medusajs.com/api/admin#manage-metadata
+                description: Learn how to manage metadata
            country_code:
              type: string
              title: country_code
@@ -105,6 +114,9 @@ properties:
            metadata:
              type: object
              description: The geo zone's metadata.
+              externalDocs:
+                url: https://docs.medusajs.com/api/admin#manage-metadata
+                description: Learn how to manage metadata
            country_code:
              type: string
              title: country_code
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCreateGiftCardParams.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCreateGiftCardParams.yaml
@@ -49,3 +49,6 @@ properties:
  metadata:
    type: object
    description: The gift card's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCreateInventoryItem.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCreateInventoryItem.yaml
@@ -57,3 +57,6 @@ properties:
  metadata:
    type: object
    description: The inventory item's metadata, used to store custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCreateOrderCreditLines.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCreateOrderCreditLines.yaml
@@ -24,3 +24,6 @@ properties:
  metadata:
    type: object
    description: The credit line's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCreateProduct.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCreateProduct.yaml
@@ -146,6 +146,9 @@ properties:
  metadata:
    type: object
    description: The product's metadata, used to store custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  external_id:
    type: string
    title: external_id
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCreateProductCategory.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCreateProductCategory.yaml
@@ -35,3 +35,6 @@ properties:
  metadata:
    type: object
    description: The product category's metadata, used to store custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCreateProductTag.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCreateProductTag.yaml
@@ -11,3 +11,6 @@ properties:
  metadata:
    type: object
    description: The product tag's metadata, used to store custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCreateProductType.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCreateProductType.yaml
@@ -7,6 +7,9 @@ properties:
  metadata:
    type: object
    description: The product's metadata, used to store custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  value:
    type: string
    title: value
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCreateProductVariant.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCreateProductVariant.yaml
@@ -74,6 +74,9 @@ properties:
  metadata:
    type: object
    description: The variant's metadata, used to store custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  prices:
    type: array
    description: The variant's prices.
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCreateRegion.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCreateRegion.yaml
@@ -41,3 +41,6 @@ properties:
  metadata:
    type: object
    description: The region's metadata, used to store custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCreateReservation.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCreateReservation.yaml
@@ -29,3 +29,6 @@ properties:
  metadata:
    type: object
    description: The reservation's metadata, used to store custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCreateReturnReason.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCreateReturnReason.yaml
@@ -24,3 +24,6 @@ properties:
  metadata:
    type: object
    description: The return reason's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCreateSalesChannel.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCreateSalesChannel.yaml
@@ -19,3 +19,6 @@ properties:
  metadata:
    type: object
    description: The sales channel's metadata, used to store custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCreateShippingProfile.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCreateShippingProfile.yaml
@@ -16,3 +16,6 @@ properties:
  metadata:
    type: object
    description: The shipping profile's metadata, used to store custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCreateStockLocation.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCreateStockLocation.yaml
@@ -17,3 +17,6 @@ properties:
  metadata:
    type: object
    description: The stock location's metadata, used to store custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCreateStoreCreditAccount.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCreateStoreCreditAccount.yaml
@@ -17,3 +17,6 @@ properties:
  metadata:
    type: object
    description: The store credit account's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCreateTaxRate.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCreateTaxRate.yaml
@@ -43,3 +43,6 @@ properties:
  metadata:
    type: object
    description: The tax rate's metadata, used to store custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCreateTaxRegion.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCreateTaxRegion.yaml
@@ -51,9 +51,15 @@ properties:
      metadata:
        type: object
        description: The default tax rate's metadata, used to store custom key-value pairs.
+        externalDocs:
+          url: https://docs.medusajs.com/api/admin#manage-metadata
+          description: Learn how to manage metadata
  metadata:
    type: object
    description: The tax region's metadata, used to store custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  provider_id:
    type: string
    title: provider_id
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCustomer.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCustomer.yaml
@@ -62,6 +62,9 @@ properties:
  metadata:
    type: object
    description: The customer's metadata, used to store custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_by:
    type: string
    title: created_by
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCustomerAddress.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCustomerAddress.yaml
@@ -89,6 +89,9 @@ properties:
  metadata:
    type: object
    description: The address's metadata, used to store custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminCustomerGroup.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCustomerGroup.yaml
@@ -25,6 +25,9 @@ properties:
  metadata:
    type: object
    description: The customer group's metadata, used to store custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminDraftOrder.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminDraftOrder.yaml
@@ -144,6 +144,9 @@ properties:
  metadata:
    type: object
    description: The draft order's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminDraftOrderPreview.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminDraftOrderPreview.yaml
@@ -215,6 +215,9 @@ properties:
            metadata:
              type: object
              description: The item's metadata, can hold custom key-value pairs.
+              externalDocs:
+                url: https://docs.medusajs.com/api/admin#manage-metadata
+                description: Learn how to manage metadata
            original_total:
              type: number
              title: original_total
@@ -352,6 +355,9 @@ properties:
            metadata:
              type: object
              description: The shipping method's metadata, can hold custom key-value pairs.
+              externalDocs:
+                url: https://docs.medusajs.com/api/admin#manage-metadata
+                description: Learn how to manage metadata
            tax_lines:
              type: array
              description: The shipping method's tax lines.
@@ -541,6 +547,9 @@ properties:
  metadata:
    type: object
    description: The order's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminExchange.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminExchange.yaml
@@ -66,6 +66,9 @@ properties:
  metadata:
    type: object
    description: The exchange's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminFulfillment.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminFulfillment.yaml
@@ -77,6 +77,9 @@ properties:
  metadata:
    type: object
    description: The fulfillment's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminFulfillmentAddress.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminFulfillmentAddress.yaml
@@ -74,6 +74,9 @@ properties:
  metadata:
    type: object
    description: The address's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminInventoryLevel.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminInventoryLevel.yaml
@@ -56,6 +56,9 @@ properties:
  metadata:
    type: object
    description: The location level's metadata.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  inventory_item:
    type: object
  available_quantity:
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminInvite.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminInvite.yaml
@@ -35,6 +35,9 @@ properties:
  metadata:
    type: object
    description: The invite's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminOrder.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminOrder.yaml
@@ -139,6 +139,9 @@ properties:
  metadata:
    type: object
    description: The order's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminOrderAddress.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminOrderAddress.yaml
@@ -65,6 +65,9 @@ properties:
  metadata:
    type: object
    description: The address's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminOrderChange.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminOrderChange.yaml
@@ -112,6 +112,9 @@ properties:
  metadata:
    type: object
    description: The order change's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  declined_at:
    type: string
    title: declined_at
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminOrderFulfillment.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminOrderFulfillment.yaml
@@ -63,6 +63,9 @@ properties:
  metadata:
    type: object
    description: The fulfillment's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminOrderLineItem.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminOrderLineItem.yaml
@@ -160,6 +160,9 @@ properties:
  metadata:
    type: object
    description: The item's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  original_total:
    type: number
    title: original_total
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminOrderPreview.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminOrderPreview.yaml
@@ -217,6 +217,9 @@ properties:
            metadata:
              type: object
              description: The item's metadata, can hold custom key-value pairs.
+              externalDocs:
+                url: https://docs.medusajs.com/api/admin#manage-metadata
+                description: Learn how to manage metadata
            original_total:
              type: number
              title: original_total
@@ -354,6 +357,9 @@ properties:
            metadata:
              type: object
              description: The shipping method's metadata, can hold custom key-value pairs.
+              externalDocs:
+                url: https://docs.medusajs.com/api/admin#manage-metadata
+                description: Learn how to manage metadata
            tax_lines:
              type: array
              description: The shipping method's tax lines.
@@ -543,6 +549,9 @@ properties:
  metadata:
    type: object
    description: The order's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminOrderShippingMethod.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminOrderShippingMethod.yaml
@@ -60,6 +60,9 @@ properties:
  metadata:
    type: object
    description: The shipping method's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  tax_lines:
    type: array
    description: The shipping method's tax lines.
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminPaymentCollection.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPaymentCollection.yaml
@@ -50,6 +50,9 @@ properties:
  metadata:
    type: object
    description: The payment collection's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  status:
    type: string
    description: The payment collection's status.
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminPostClaimsAddItemsReqSchema.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPostClaimsAddItemsReqSchema.yaml
@@ -31,3 +31,6 @@ properties:
        metadata:
          type: object
          description: The item's metadata, can hold custom key-value pairs.
+          externalDocs:
+            url: https://docs.medusajs.com/api/admin#manage-metadata
+            description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminPostClaimsShippingActionReqSchema.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPostClaimsShippingActionReqSchema.yaml
@@ -13,3 +13,6 @@ properties:
  metadata:
    type: object
    description: The claim's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminPostClaimsShippingReqSchema.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPostClaimsShippingReqSchema.yaml
@@ -23,3 +23,6 @@ properties:
  metadata:
    type: object
    description: The claim's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminPostExchangesAddItemsReqSchema.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPostExchangesAddItemsReqSchema.yaml
@@ -35,3 +35,6 @@ properties:
        metadata:
          type: object
          description: The item's metadata, can hold custom key-value pairs.
+          externalDocs:
+            url: https://docs.medusajs.com/api/admin#manage-metadata
+            description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminPostExchangesRequestItemsReturnActionReqSchema.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPostExchangesRequestItemsReturnActionReqSchema.yaml
@@ -17,3 +17,6 @@ properties:
  metadata:
    type: object
    description: The exchange's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminPostExchangesReturnRequestItemsReqSchema.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPostExchangesReturnRequestItemsReqSchema.yaml
@@ -35,3 +35,6 @@ properties:
        metadata:
          type: object
          description: The item's metadata, can hold custom key-value pairs.
+          externalDocs:
+            url: https://docs.medusajs.com/api/admin#manage-metadata
+            description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminPostExchangesShippingActionReqSchema.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPostExchangesShippingActionReqSchema.yaml
@@ -13,3 +13,6 @@ properties:
  metadata:
    type: object
    description: The exchange's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminPostExchangesShippingReqSchema.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPostExchangesShippingReqSchema.yaml
@@ -23,3 +23,6 @@ properties:
  metadata:
    type: object
    description: The exchange's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminPostOrderClaimsReqSchema.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPostOrderClaimsReqSchema.yaml
@@ -30,3 +30,6 @@ properties:
  metadata:
    type: object
    description: The claim's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminPostOrderEditsAddItemsReqSchema.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPostOrderEditsAddItemsReqSchema.yaml
@@ -37,6 +37,9 @@ properties:
        metadata:
          type: object
          description: The item's metadata, can hold custom key-value pairs.
+          externalDocs:
+            url: https://docs.medusajs.com/api/admin#manage-metadata
+            description: Learn how to manage metadata
        compare_at_unit_price:
          type: number
          title: compare_at_unit_price
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminPostOrderEditsReqSchema.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPostOrderEditsReqSchema.yaml
@@ -19,3 +19,6 @@ properties:
  metadata:
    type: object
    description: The order edit's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminPostOrderEditsShippingActionReqSchema.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPostOrderEditsShippingActionReqSchema.yaml
@@ -13,3 +13,6 @@ properties:
  metadata:
    type: object
    description: The order edit's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminPostOrderEditsShippingReqSchema.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPostOrderEditsShippingReqSchema.yaml
@@ -23,3 +23,6 @@ properties:
  metadata:
    type: object
    description: The shipping method's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminPostOrderExchangesReqSchema.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPostOrderExchangesReqSchema.yaml
@@ -19,3 +19,6 @@ properties:
  metadata:
    type: object
    description: The exchange's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminPostReceiveReturnsReqSchema.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPostReceiveReturnsReqSchema.yaml
@@ -13,3 +13,6 @@ properties:
  metadata:
    type: object
    description: The return's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminPostReturnsReqSchema.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPostReturnsReqSchema.yaml
@@ -27,3 +27,6 @@ properties:
  metadata:
    type: object
    description: The return's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminPostReturnsRequestItemsActionReqSchema.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPostReturnsRequestItemsActionReqSchema.yaml
@@ -17,3 +17,6 @@ properties:
  metadata:
    type: object
    description: The claim's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminPostReturnsRequestItemsReqSchema.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPostReturnsRequestItemsReqSchema.yaml
@@ -35,3 +35,6 @@ properties:
        metadata:
          type: object
          description: The item's metadata, can hold custom key-value pairs.
+          externalDocs:
+            url: https://docs.medusajs.com/api/admin#manage-metadata
+            description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminPostReturnsReturnReqSchema.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPostReturnsReturnReqSchema.yaml
@@ -15,3 +15,6 @@ properties:
  metadata:
    type: object
    description: The return's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminPostReturnsShippingActionReqSchema.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPostReturnsShippingActionReqSchema.yaml
@@ -13,3 +13,6 @@ properties:
  metadata:
    type: object
    description: The return's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminPostReturnsShippingReqSchema.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPostReturnsShippingReqSchema.yaml
@@ -23,3 +23,6 @@ properties:
  metadata:
    type: object
    description: The exchange's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminProduct.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminProduct.yaml
@@ -86,6 +86,9 @@ properties:
  metadata:
    type: object
    description: The product's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminProductCategory.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminProductCategory.yaml
@@ -43,6 +43,9 @@ properties:
  metadata:
    type: object
    description: The category's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminProductImage.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminProductImage.yaml
@@ -28,6 +28,9 @@ properties:
  metadata:
    type: object
    description: The image's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  rank:
    type: number
    title: rank
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminProductOption.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminProductOption.yaml
@@ -27,6 +27,9 @@ properties:
  metadata:
    type: object
    description: The product option's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminProductOptionValue.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminProductOptionValue.yaml
@@ -22,6 +22,9 @@ properties:
  metadata:
    type: object
    description: The value's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminProductTag.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminProductTag.yaml
@@ -33,3 +33,6 @@ properties:
  metadata:
    type: object
    description: The tag's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminProductType.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminProductType.yaml
@@ -33,3 +33,6 @@ properties:
  metadata:
    type: object
    description: The type's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminProductVariant.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminProductVariant.yaml
@@ -136,6 +136,9 @@ properties:
  metadata:
    type: object
    description: The variant's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  inventory_items:
    type: array
    description: The variant's inventory items.
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminRefundReason.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminRefundReason.yaml
@@ -23,6 +23,9 @@ properties:
  metadata:
    type: object
    description: The refund reason's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminRegion.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminRegion.yaml
@@ -36,6 +36,9 @@ properties:
  metadata:
    type: object
    description: The region's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminReservation.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminReservation.yaml
@@ -43,6 +43,9 @@ properties:
  metadata:
    type: object
    description: The reservation's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_by:
    type: string
    title: created_by
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminReturnItem.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminReturnItem.yaml
@@ -48,3 +48,6 @@ properties:
  metadata:
    type: object
    description: The return item's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminReturnReason.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminReturnReason.yaml
@@ -27,6 +27,9 @@ properties:
  metadata:
    type: object
    description: The return reason's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminSalesChannel.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminSalesChannel.yaml
@@ -30,6 +30,9 @@ properties:
  metadata:
    type: object
    description: The sales channel's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminShippingOption.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminShippingOption.yaml
@@ -88,6 +88,9 @@ properties:
  metadata:
    type: object
    description: The shipping option's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminShippingProfile.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminShippingProfile.yaml
@@ -17,6 +17,9 @@ properties:
  metadata:
    type: object
    description: The shipping profile's metadata, holds custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminStore.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminStore.yaml
@@ -40,6 +40,9 @@ properties:
  metadata:
    type: object
    description: The store's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminStoreCreditAccount.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminStoreCreditAccount.yaml
@@ -49,6 +49,9 @@ properties:
  metadata:
    type: object
    description: The store credit account's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminTaxRate.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminTaxRate.yaml
@@ -37,6 +37,9 @@ properties:
  metadata:
    type: object
    description: The tax rate's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  tax_region_id:
    type: string
    title: tax_region_id
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminTaxRegion.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminTaxRegion.yaml
@@ -35,6 +35,9 @@ properties:
  metadata:
    type: object
    description: The tax region's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  parent_id:
    type: string
    title: parent_id
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminTransaction.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminTransaction.yaml
@@ -51,6 +51,9 @@ properties:
  metadata:
    type: object
    description: The transaction's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  created_at:
    type: string
    format: date-time
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminTransactionGroup.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminTransactionGroup.yaml
@@ -35,3 +35,6 @@ properties:
  metadata:
    type: object
    description: The transaction group's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateCustomerGroup.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateCustomerGroup.yaml
@@ -9,3 +9,6 @@ properties:
  metadata:
    type: object
    description: The customer group's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateDraftOrder.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateDraftOrder.yaml
@@ -59,6 +59,9 @@ properties:
      metadata:
        type: object
        description: The shipping address's metadata, can hold custom key-value pairs.
+        externalDocs:
+          url: https://docs.medusajs.com/api/admin#manage-metadata
+          description: Learn how to manage metadata
  billing_address:
    type: object
    description: The draft order's billing address.
@@ -111,9 +114,15 @@ properties:
      metadata:
        type: object
        description: The billing address's metadata, can hold custom key-value pairs.
+        externalDocs:
+          url: https://docs.medusajs.com/api/admin#manage-metadata
+          description: Learn how to manage metadata
  metadata:
    type: object
    description: The draft order's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  customer_id:
    type: string
    title: customer_id
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateDraftOrderActionShippingMethod.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateDraftOrderActionShippingMethod.yaml
@@ -25,3 +25,6 @@ properties:
  metadata:
    type: object
    description: The shipping method's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateFulfillmentSetServiceZones.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateFulfillmentSetServiceZones.yaml
@@ -25,6 +25,9 @@ properties:
            metadata:
              type: object
              description: The geo zone's metadata.
+              externalDocs:
+                url: https://docs.medusajs.com/api/admin#manage-metadata
+                description: Learn how to manage metadata
            country_code:
              type: string
              title: country_code
@@ -49,6 +52,9 @@ properties:
            metadata:
              type: object
              description: The geo zone's metadata.
+              externalDocs:
+                url: https://docs.medusajs.com/api/admin#manage-metadata
+                description: Learn how to manage metadata
            country_code:
              type: string
              title: country_code
@@ -82,6 +88,9 @@ properties:
            metadata:
              type: object
              description: The geo zone's metadata.
+              externalDocs:
+                url: https://docs.medusajs.com/api/admin#manage-metadata
+                description: Learn how to manage metadata
            city:
              type: string
              title: city
@@ -120,6 +129,9 @@ properties:
            metadata:
              type: object
              description: The geo zone's metadata.
+              externalDocs:
+                url: https://docs.medusajs.com/api/admin#manage-metadata
+                description: Learn how to manage metadata
            city:
              type: string
              title: city
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateGiftCardParams.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateGiftCardParams.yaml
@@ -32,3 +32,6 @@ properties:
  metadata:
    type: object
    description: The gift card's metadata.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateInventoryItem.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateInventoryItem.yaml
@@ -58,4 +58,7 @@ properties:
  metadata:
    type: object
    description: The inventory item's metadata. Can be custom data in key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
 x-schemaName: AdminUpdateInventoryItem
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateOrder.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateOrder.yaml
@@ -59,6 +59,9 @@ properties:
      metadata:
        type: object
        description: The address's metadata, can hold custom key-value pairs.
+        externalDocs:
+          url: https://docs.medusajs.com/api/admin#manage-metadata
+          description: Learn how to manage metadata
  billing_address:
    type: object
    description: The order's billing address.
@@ -111,6 +114,12 @@ properties:
      metadata:
        type: object
        description: The address's metadata, can hold custom key-value pairs.
+        externalDocs:
+          url: https://docs.medusajs.com/api/admin#manage-metadata
+          description: Learn how to manage metadata
  metadata:
    type: object
    description: The order's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateProduct.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateProduct.yaml
@@ -147,6 +147,9 @@ properties:
  metadata:
    type: object
    description: The product's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  external_id:
    type: string
    title: external_id
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateProductCategory.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateProductCategory.yaml
@@ -30,6 +30,9 @@ properties:
  metadata:
    type: object
    description: The product category's metadata. Can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  rank:
    type: number
    title: rank
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateProductTag.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateProductTag.yaml
@@ -8,4 +8,7 @@ properties:
  metadata:
    type: object
    description: The product tag's metadata. Can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
 x-schemaName: AdminUpdateProductTag
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateProductType.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateProductType.yaml
@@ -8,4 +8,7 @@ properties:
  metadata:
    type: object
    description: The product type's metadata. Can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
 x-schemaName: AdminUpdateProductType
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateProductVariant.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateProductVariant.yaml
@@ -71,6 +71,9 @@ properties:
  metadata:
    type: object
    description: The product variant's metadata, can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  prices:
    type: array
    description: The product variant's prices.
--- a/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateRegion.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateRegion.yaml
@@ -30,6 +30,9 @@ properties:
  metadata:
    type: object
    description: The region's metadata. Can hold custom key-value pairs.
+    externalDocs:
+      url: https://docs.medusajs.com/api/admin#manage-metadata
+      description: Learn how to manage metadata
  is_tax_inclusive:
    type: boolean
    title: is_tax_inclusive
--- a/Show More
+++ b/Show More