docs: generate OAS for 2.11.2 (#13925)

www/apps/api-reference/generated/generated-admin-sidebar.mjs

@@ -301,6 +301,13 @@ const generatedgeneratedAdminSidebarSidebar = {
       "loaded": false,
       "showLoadingIfEmpty": true
     },
+    {
+      "type": "category",
+      "title": "Index",
+      "children": [],
+      "loaded": false,
+      "showLoadingIfEmpty": true
+    },
     {
       "type": "category",
       "title": "Inventory Items",

www/apps/api-reference/specs/admin/code_samples/JavaScript/admin_products_{id}_images_{image_id}_variants_batch/post.js

@@ -0,0 +1,17 @@
+import Medusa from "@medusajs/js-sdk"
+
+export const sdk = new Medusa({
+  baseUrl: import.meta.env.VITE_BACKEND_URL || "/",
+  debug: import.meta.env.DEV,
+  auth: {
+    type: "session",
+  },
+})
+
+sdk.admin.product.batchImageVariants("prod_123", "img_123", {
+  add: ["variant_123", "variant_456"],
+  remove: ["variant_789"]
+})
+.then(({ added, removed }) => {
+  console.log(added, removed)
+})

www/apps/api-reference/specs/admin/code_samples/JavaScript/admin_products_{id}_variants_{variant_id}_images_batch/post.js

@@ -0,0 +1,17 @@
+import Medusa from "@medusajs/js-sdk"
+
+export const sdk = new Medusa({
+  baseUrl: import.meta.env.VITE_BACKEND_URL || "/",
+  debug: import.meta.env.DEV,
+  auth: {
+    type: "session",
+  },
+})
+
+sdk.admin.product.batchVariantImages("prod_123", "variant_123", {
+  add: ["img_123", "img_456"],
+  remove: ["img_789"]
+})
+.then(({ added, removed }) => {
+  console.log(added, removed)
+})

www/apps/api-reference/specs/admin/code_samples/Shell/admin_index_details/get.sh

@@ -0,0 +1,2 @@
+curl '{backend_url}/admin/index/details' \
+-H 'Authorization: Bearer {access_token}'

www/apps/api-reference/specs/admin/code_samples/Shell/admin_index_sync/post.sh

@@ -0,0 +1,6 @@
+curl -X POST '{backend_url}/admin/index/sync' \
+-H 'Authorization: Bearer {access_token}' \
+-H 'Content-Type: application/json' \
+--data-raw '{
+  "strategy": "full"
+}'

www/apps/api-reference/specs/admin/code_samples/Shell/admin_products_{id}_images_{image_id}_variants_batch/post.sh

@@ -0,0 +1,7 @@
+curl -X POST '{backend_url}/admin/products/{id}/images/{image_id}/variants/batch' \
+-H 'Authorization: Bearer {access_token}' \
+-H 'Content-Type: application/json' \
+--data-raw '{
+  "add": ["variant_123", "variant_456"],
+  "remove": ["variant_789"]
+}'

www/apps/api-reference/specs/admin/code_samples/Shell/admin_products_{id}_variants_{variant_id}_images_batch/post.sh

@@ -0,0 +1,7 @@
+curl -X POST '{backend_url}/admin/products/{id}/variants/{variant_id}/images/batch' \
+-H 'Authorization: Bearer {access_token}' \
+-H 'Content-Type: application/json' \
+--data-raw '{
+  "add": ["img_123", "img_456"],
+  "remove": ["img_789"]
+}'

www/apps/api-reference/specs/admin/components/schemas/AdminAddClaimItems.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The details of the order items to add to the claim.
-x-schemaName: AdminPostClaimItemsReqSchema
+x-schemaName: AdminAddClaimItems
 properties:
   items:
     type: array

www/apps/api-reference/specs/admin/components/schemas/AdminAddClaimOutboundItems.yaml

@@ -0,0 +1,38 @@
+type: object
+description: The details of the outbound items to add to the claim.
+x-schemaName: AdminAddClaimOutboundItems
+properties:
+  items:
+    type: array
+    description: The outbound item's details.
+    items:
+      type: object
+      description: An item's details.
+      required:
+        - id
+        - quantity
+      properties:
+        quantity:
+          type: number
+          title: quantity
+          description: The quantity to send to the customer.
+        internal_note:
+          type: string
+          title: internal_note
+          description: A note viewed only by admin users.
+        id:
+          type: string
+          title: id
+          description: The item's ID.
+        reason:
+          type: string
+          description: The item's reason.
+          enum:
+            - missing_item
+            - wrong_item
+            - production_failure
+            - other
+        description:
+          type: string
+          title: description
+          description: The item's description.

www/apps/api-reference/specs/admin/components/schemas/AdminAddExchangeInboundItems.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The details of the inbound (return) items.
-x-schemaName: AdminPostExchangesReturnRequestItemsReqSchema
+x-schemaName: AdminAddExchangeInboundItems
 properties:
   items:
     type: array

www/apps/api-reference/specs/admin/components/schemas/AdminAddExchangeOutboundItems.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The details of outbound items.
-x-schemaName: AdminPostExchangesAddItemsReqSchema
+x-schemaName: AdminAddExchangeOutboundItems
 properties:
   items:
     type: array

www/apps/api-reference/specs/admin/components/schemas/AdminAddReturnItem.yaml

@@ -0,0 +1,29 @@
+type: object
+description: An item's details.
+required:
+  - id
+  - quantity
+properties:
+  id:
+    type: string
+    title: id
+    description: The item's ID.
+  quantity:
+    type: number
+    title: quantity
+    description: The item's quantity.
+  description:
+    type: string
+    title: description
+    description: The item's description.
+  internal_note:
+    type: string
+    title: internal_note
+    description: A note viewed only by admin users.
+  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
+x-schemaName: AdminAddReturnItem

www/apps/api-reference/specs/admin/components/schemas/AdminAddReturnItems.yaml

@@ -0,0 +1,11 @@
+type: object
+description: The items' details.
+x-schemaName: AdminAddReturnItems
+properties:
+  items:
+    type: array
+    description: The items' details.
+    items:
+      $ref: ./AdminAddReturnItem.yaml
+required:
+  - items

www/apps/api-reference/specs/admin/components/schemas/AdminAddReturnShipping.yaml

@@ -0,0 +1,28 @@
+type: object
+description: The shipping method's details.
+x-schemaName: AdminAddReturnShipping
+required:
+  - shipping_option_id
+properties:
+  shipping_option_id:
+    type: string
+    title: shipping_option_id
+    description: The ID of the associated shipping option.
+  custom_amount:
+    type: number
+    title: custom_amount
+    description: Set the price of the shipping method.
+  description:
+    type: string
+    title: description
+    description: The shipping method's description.
+  internal_note:
+    type: string
+    title: internal_note
+    description: A note viewed only by admin users.
+  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

www/apps/api-reference/specs/admin/components/schemas/AdminBatchCreateInventoryItemLocationLevels.yaml

@@ -15,4 +15,4 @@ properties:
     type: number
     title: incoming_quantity
     description: The inventory level's incoming quantity.
-x-schemaName: AdminCreateInventoryLocationLevel
+x-schemaName: AdminBatchCreateInventoryItemLocationLevels

www/apps/api-reference/specs/admin/components/schemas/AdminBatchImageVariantRequest.yaml

@@ -0,0 +1,18 @@
+type: object
+description: Details of the associations between variants and a product image to manage.
+x-schemaName: AdminBatchImageVariantRequest
+properties:
+  add:
+    type: array
+    description: The IDs of product variants to add the image to.
+    items:
+      type: string
+      title: add
+      description: The ID of the variant to add.
+  remove:
+    type: array
+    description: The IDs of product variants to remove the image from.
+    items:
+      type: string
+      title: remove
+      description: The ID of the variant to remove.

www/apps/api-reference/specs/admin/components/schemas/AdminBatchImageVariantResponse.yaml

@@ -0,0 +1,21 @@
+type: object
+description: Result of managing the associations between variants and a product image.
+x-schemaName: AdminBatchImageVariantResponse
+required:
+  - added
+  - removed
+properties:
+  added:
+    type: array
+    description: The IDs of product variants added the image to.
+    items:
+      type: string
+      title: added
+      description: The ID of the variant added.
+  removed:
+    type: array
+    description: The IDs of product variants removed the image from.
+    items:
+      type: string
+      title: removed
+      description: The ID of the variant removed.

www/apps/api-reference/specs/admin/components/schemas/AdminBatchLink.yaml

@@ -0,0 +1,18 @@
+type: object
+description: A batch operation to manage the associations between two entities.
+properties:
+  add:
+    type: array
+    description: The IDs of an entity to add to the other.
+    items:
+      type: string
+      title: add
+      description: The entity's ID.
+  remove:
+    type: array
+    description: The IDs of an entity to remove from the other.
+    items:
+      type: string
+      title: remove
+      description: The entity's ID.
+x-schemaName: AdminBatchLink

www/apps/api-reference/specs/admin/components/schemas/AdminBatchUpdateProduct.yaml

@@ -35,6 +35,10 @@ properties:
           type: string
           title: url
           description: The image's URL.
+        id:
+          type: string
+          title: id
+          description: The image's ID.
   thumbnail:
     type: string
     title: thumbnail

www/apps/api-reference/specs/admin/components/schemas/AdminBatchUpdateProductVariant.yaml

@@ -86,5 +86,9 @@ properties:
     type: string
     title: id
     description: The update's ID.
+  thumbnail:
+    type: string
+    title: thumbnail
+    description: The variant's thumbnail.
 required:
   - id

www/apps/api-reference/specs/admin/components/schemas/AdminBatchVariantImagesRequest.yaml

@@ -0,0 +1,18 @@
+type: object
+description: Details of the associations between images and a product variant to manage.
+x-schemaName: AdminBatchVariantImagesRequest
+properties:
+  add:
+    type: array
+    description: The IDs of product images to add to the variant.
+    items:
+      type: string
+      title: add
+      description: The ID of the image to add.
+  remove:
+    type: array
+    description: The IDs of product images to remove from the variant.
+    items:
+      type: string
+      title: remove
+      description: The ID of the image to remove.

www/apps/api-reference/specs/admin/components/schemas/AdminBatchVariantImagesResponse.yaml

@@ -0,0 +1,21 @@
+type: object
+description: Result of managing the associations between images and a product variant.
+x-schemaName: AdminBatchVariantImagesResponse
+required:
+  - added
+  - removed
+properties:
+  added:
+    type: array
+    description: The IDs of product images added to the variant.
+    items:
+      type: string
+      title: added
+      description: The ID of the image added.
+  removed:
+    type: array
+    description: The IDs of product images removed from the variant.
+    items:
+      type: string
+      title: removed
+      description: The ID of the image removed.

www/apps/api-reference/specs/admin/components/schemas/AdminCapturePayment.yaml

@@ -5,4 +5,4 @@ properties:
     type: number
     title: amount
     description: The amount to capture.
-x-schemaName: AdminCreatePaymentCapture
+x-schemaName: AdminCapturePayment

www/apps/api-reference/specs/admin/components/schemas/AdminClaimAddOutboundShipping.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The details of the shipping method used to ship outbound items.
-x-schemaName: AdminPostClaimsShippingReqSchema
+x-schemaName: AdminClaimAddOutboundShipping
 required:
   - shipping_option_id
 properties:

www/apps/api-reference/specs/admin/components/schemas/AdminClaimUpdateInboundShipping.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The details to update in the shipping method.
-x-schemaName: AdminPostClaimsShippingActionReqSchema
+x-schemaName: AdminClaimUpdateInboundShipping
 properties:
   custom_amount:
     type: number

www/apps/api-reference/specs/admin/components/schemas/AdminClaimUpdateOutboundShipping.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The details to update in the shipping method.
-x-schemaName: AdminPostClaimsShippingActionReqSchema
+x-schemaName: AdminClaimUpdateOutboundShipping
 properties:
   custom_amount:
     type: number

www/apps/api-reference/specs/admin/components/schemas/AdminConfirmReceiveReturn.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The confirmation's details.
-x-schemaName: AdminPostReturnsConfirmRequestReqSchema
+x-schemaName: AdminConfirmReceiveReturn
 properties:
   no_notification:
     type: boolean

www/apps/api-reference/specs/admin/components/schemas/AdminConfirmReturnRequest.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The confirmation's details.
-x-schemaName: AdminPostReturnsConfirmRequestReqSchema
+x-schemaName: AdminConfirmReturnRequest
 properties:
   no_notification:
     type: boolean

www/apps/api-reference/specs/admin/components/schemas/AdminCreateClaim.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The claim's details.
-x-schemaName: AdminPostOrderClaimsReqSchema
+x-schemaName: AdminCreateClaim
 required:
   - type
   - order_id

www/apps/api-reference/specs/admin/components/schemas/AdminCreateExchange.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The exchange's details.
-x-schemaName: AdminPostOrderExchangesReqSchema
+x-schemaName: AdminCreateExchange
 required:
   - order_id
 properties:

www/apps/api-reference/specs/admin/components/schemas/AdminCreateFulfillment.yaml

@@ -2,14 +2,12 @@ type: object
 description: The filfillment's details.
 x-schemaName: AdminCreateFulfillment
 required:
-  - items
-  - metadata
-  - order_id
-  - data
   - location_id
   - provider_id
   - delivery_address
+  - items
   - labels
+  - order_id
 properties:
   location_id:
     type: string
@@ -20,118 +18,17 @@ properties:
     title: provider_id
     description: The ID of the provider handling this fulfillment.
   delivery_address:
-    type: object
-    description: The address to deliver the items to.
-    properties:
-      first_name:
-        type: string
-        title: first_name
-        description: The customer's first name.
-      last_name:
-        type: string
-        title: last_name
-        description: The customer's last name.
-      phone:
-        type: string
-        title: phone
-        description: The customer's phone.
-      company:
-        type: string
-        title: company
-        description: The delivery address's company.
-      address_1:
-        type: string
-        title: address_1
-        description: The delivery address's first line.
-      address_2:
-        type: string
-        title: address_2
-        description: The delivery address's second line.
-      city:
-        type: string
-        title: city
-        description: The delivery address's city.
-      country_code:
-        type: string
-        title: country_code
-        description: The delivery address's country code.
-      province:
-        type: string
-        title: province
-        description: The delivery address's ISO 3166-2 province code. Must be lower-case.
-        example: us-ca
-        externalDocs:
-          url: https://en.wikipedia.org/wiki/ISO_3166-2
-          description: Learn more about ISO 3166-2
-      postal_code:
-        type: string
-        title: postal_code
-        description: The delivery address's postal code.
-      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
+    $ref: ./AdminFulfillmentDeliveryAddress.yaml
   items:
     type: array
     description: The items to fulfill.
     items:
-      type: object
-      description: An item to fulfill.
-      required:
-        - title
-        - quantity
-        - sku
-        - barcode
-      properties:
-        title:
-          type: string
-          title: title
-          description: The item's title.
-        sku:
-          type: string
-          title: sku
-          description: The item's SKU.
-        quantity:
-          type: number
-          title: quantity
-          description: The quantity to fulfill of the item.
-        barcode:
-          type: string
-          title: barcode
-          description: The item's barcode.
-        line_item_id:
-          type: string
-          title: line_item_id
-          description: The ID of the associated line item.
-        inventory_item_id:
-          type: string
-          title: inventory_item_id
-          description: The ID of the inventory item associated with the underlying variant.
+      $ref: ./AdminCreateFulfillmentItem.yaml
   labels:
     type: array
     description: The labels for the fulfillment's shipments.
     items:
-      type: object
-      description: A shipment's label.
-      required:
-        - tracking_number
-        - tracking_url
-        - label_url
-      properties:
-        tracking_number:
-          type: string
-          title: tracking_number
-          description: The label's tracking number.
-        tracking_url:
-          type: string
-          title: tracking_url
-          description: The label's tracking URL.
-        label_url:
-          type: string
-          title: label_url
-          description: The label's URL.
+      $ref: ./AdminCreateFulfillmentLabel.yaml
   order_id:
     type: string
     title: order_id

www/apps/api-reference/specs/admin/components/schemas/AdminCreateFulfillmentItem.yaml

@@ -0,0 +1,33 @@
+type: object
+description: An item to fulfill.
+required:
+  - title
+  - sku
+  - quantity
+  - barcode
+properties:
+  title:
+    type: string
+    title: title
+    description: The item's title.
+  sku:
+    type: string
+    title: sku
+    description: The item's SKU.
+  quantity:
+    type: number
+    title: quantity
+    description: The quantity to fulfill of the item.
+  barcode:
+    type: string
+    title: barcode
+    description: The item's barcode.
+  line_item_id:
+    type: string
+    title: line_item_id
+    description: The ID of the associated line item.
+  inventory_item_id:
+    type: string
+    title: inventory_item_id
+    description: The ID of the inventory item associated with the underlying variant.
+x-schemaName: AdminCreateFulfillmentItem

www/apps/api-reference/specs/admin/components/schemas/AdminCreateFulfillmentLabel.yaml

@@ -0,0 +1,20 @@
+type: object
+description: Details of the fulfillment label to create.
+required:
+  - tracking_number
+  - tracking_url
+  - label_url
+properties:
+  tracking_number:
+    type: string
+    title: tracking_number
+    description: The label's tracking number.
+  tracking_url:
+    type: string
+    title: tracking_url
+    description: The label's tracking URL.
+  label_url:
+    type: string
+    title: label_url
+    description: The label's URL.
+x-schemaName: AdminCreateFulfillmentLabel

www/apps/api-reference/specs/admin/components/schemas/AdminCreateFulfillmentSetServiceZone.yaml

@@ -1,7 +1,8 @@
 type: object
-description: The service zone's details.
+description: Details of the service zone to create for the fulfillment set.
 required:
   - name
+  - geo_zones
 properties:
   name:
     type: string
@@ -141,4 +142,4 @@ properties:
             postal_expression:
               type: object
               description: The geo zone's postal expression or ZIP code.
-x-schemaName: AdminCreateFulfillmentSetServiceZones
+x-schemaName: AdminCreateFulfillmentSetServiceZone

www/apps/api-reference/specs/admin/components/schemas/AdminCreateFulfillmentShipment.yaml

@@ -0,0 +1,11 @@
+type: object
+description: Details of the shipment to create for a fulfillment.
+x-schemaName: AdminCreateFulfillmentShipment
+required:
+  - labels
+properties:
+  labels:
+    type: array
+    description: The shipment's labels.
+    items:
+      $ref: ./AdminCreateFulfillmentLabel.yaml

www/apps/api-reference/specs/admin/components/schemas/AdminCreateOrderCreditLine.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The details of a credit line to add to an order.
-x-schemaName: AdminCreateOrderCreditLines
+x-schemaName: AdminCreateOrderCreditLine
 required:
   - amount
   - reference

www/apps/api-reference/specs/admin/components/schemas/AdminCreatePriceList.yaml

@@ -44,39 +44,4 @@ properties:
     type: array
     description: The price list's prices.
     items:
-      type: object
-      description: A price's details.
-      required:
-        - currency_code
-        - variant_id
-        - amount
-      properties:
-        currency_code:
-          type: string
-          title: currency_code
-          description: The price's currency code.
-        amount:
-          type: number
-          title: amount
-          description: The price's amount.
-        variant_id:
-          type: string
-          title: variant_id
-          description: The ID of the product variant this price is for.
-        min_quantity:
-          type: number
-          title: min_quantity
-          description: >-
-            The minimum quantity required in the cart for this price to be
-            applied.
-        max_quantity:
-          type: number
-          title: max_quantity
-          description: >-
-            The maximum quantity in the cart that shouldn't be crossed for this
-            price to be applied.
-        rules:
-          type: object
-          description: The price's rules.
-          example:
-            region_id: reg_123
+      $ref: ./AdminCreatePriceListPrice.yaml

www/apps/api-reference/specs/admin/components/schemas/AdminCreatePriceListPrice.yaml

@@ -0,0 +1,35 @@
+type: object
+description: The details of a price to be created within a price list.
+required:
+  - currency_code
+  - amount
+  - variant_id
+properties:
+  currency_code:
+    type: string
+    title: currency_code
+    description: The price's currency code.
+  amount:
+    type: number
+    title: amount
+    description: The price's amount.
+  variant_id:
+    type: string
+    title: variant_id
+    description: The ID of the product variant this price is for.
+  min_quantity:
+    type: number
+    title: min_quantity
+    description: The minimum quantity required in the cart for this price to be applied.
+  max_quantity:
+    type: number
+    title: max_quantity
+    description: >-
+      The maximum quantity in the cart that shouldn't be crossed for this price
+      to be applied.
+  rules:
+    type: object
+    description: The price's rules.
+    example:
+      region_id: reg_123
+x-schemaName: AdminCreatePriceListPrice

www/apps/api-reference/specs/admin/components/schemas/AdminCreateShipment.yaml

@@ -1,29 +0,0 @@
-type: object
-description: The shipment's details.
-x-schemaName: AdminCreateShipment
-required:
-  - labels
-properties:
-  labels:
-    type: array
-    description: The shipment's labels.
-    items:
-      type: object
-      description: A shipment label's details.
-      required:
-        - tracking_number
-        - tracking_url
-        - label_url
-      properties:
-        tracking_number:
-          type: string
-          title: tracking_number
-          description: The label's tracking number.
-        tracking_url:
-          type: string
-          title: tracking_url
-          description: The label's tracking URL.
-        label_url:
-          type: string
-          title: label_url
-          description: The label's URL.

www/apps/api-reference/specs/admin/components/schemas/AdminCreateStockLocationFulfillmentSet.yaml

@@ -1,8 +1,8 @@
 type: object
 description: The fulfillment set to create.
 required:
-  - type
   - name
+  - type
 properties:
   name:
     type: string

www/apps/api-reference/specs/admin/components/schemas/AdminCreateVariantInventoryItem.yaml

@@ -2,8 +2,8 @@ type: object
 description: The details of the variant-inventory item association.
 x-schemaName: AdminCreateVariantInventoryItem
 required:
-  - inventory_item_id
   - required_quantity
+  - inventory_item_id
 properties:
   required_quantity:
     type: number

www/apps/api-reference/specs/admin/components/schemas/AdminDismissItems.yaml

@@ -0,0 +1,26 @@
+type: object
+description: The items details.
+x-schemaName: AdminDismissItems
+properties:
+  items:
+    type: array
+    description: The items details.
+    items:
+      type: object
+      description: An item's details.
+      required:
+        - id
+        - quantity
+      properties:
+        id:
+          type: string
+          title: id
+          description: The ID of the item in the order.
+        quantity:
+          type: number
+          title: quantity
+          description: The item's quantity.
+        internal_note:
+          type: string
+          title: internal_note
+          description: A note viewed only by admin users.

www/apps/api-reference/specs/admin/components/schemas/AdminDraftOrder.yaml

@@ -6,13 +6,13 @@ required:
   - items
   - shipping_methods
   - status
-  - currency_code
   - id
   - version
   - region_id
   - customer_id
   - sales_channel_id
   - email
+  - currency_code
   - payment_status
   - fulfillment_status
   - summary

www/apps/api-reference/specs/admin/components/schemas/AdminDraftOrderParams.yaml

@@ -0,0 +1,12 @@
+type: object
+description: The parameters for retrieving draft orders.
+x-schemaName: AdminDraftOrderParams
+properties:
+  fields:
+    type: string
+    title: fields
+    description: >-
+      Comma-separated fields that should be included in the returned data. if a
+      field is prefixed with `+` it will be added to the default fields, using
+      `-` will remove it from the default fields. without prefix it will replace
+      the entire default fields.

www/apps/api-reference/specs/admin/components/schemas/AdminDraftOrderPreview.yaml

@@ -5,13 +5,13 @@ required:
   - return_requested_total
   - order_change
   - status
-  - currency_code
   - id
   - version
   - region_id
   - customer_id
   - sales_channel_id
   - email
+  - currency_code
   - payment_collections
   - payment_status
   - fulfillment_status

www/apps/api-reference/specs/admin/components/schemas/AdminExchangeAddOutboundShipping.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The outbound shipping method's details.
-x-schemaName: AdminPostExchangesShippingReqSchema
+x-schemaName: AdminExchangeAddOutboundShipping
 required:
   - shipping_option_id
 properties:

www/apps/api-reference/specs/admin/components/schemas/AdminExchangeUpdateInboundShipping.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The details of the shipping method to update.
-x-schemaName: AdminPostExchangesShippingActionReqSchema
+x-schemaName: AdminExchangeUpdateInboundShipping
 properties:
   custom_amount:
     type: number

www/apps/api-reference/specs/admin/components/schemas/AdminExchangeUpdateOutboundShipping.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The details of the shipping method to update.
-x-schemaName: AdminPostExchangesShippingActionReqSchema
+x-schemaName: AdminExchangeUpdateOutboundShipping
 properties:
   custom_amount:
     type: number

www/apps/api-reference/specs/admin/components/schemas/AdminFulfillmentDeliveryAddress.yaml

@@ -0,0 +1,54 @@
+type: object
+description: The address to deliver the items to.
+properties:
+  first_name:
+    type: string
+    title: first_name
+    description: The customer's first name.
+  last_name:
+    type: string
+    title: last_name
+    description: The customer's last name.
+  phone:
+    type: string
+    title: phone
+    description: The customer's phone.
+  company:
+    type: string
+    title: company
+    description: The delivery address's company.
+  address_1:
+    type: string
+    title: address_1
+    description: The delivery address's first line.
+  address_2:
+    type: string
+    title: address_2
+    description: The delivery address's second line.
+  city:
+    type: string
+    title: city
+    description: The delivery address's city.
+  country_code:
+    type: string
+    title: country_code
+    description: The delivery address's country code.
+  province:
+    type: string
+    title: province
+    description: The delivery address's ISO 3166-2 province code. Must be lower-case.
+    example: us-ca
+    externalDocs:
+      url: https://en.wikipedia.org/wiki/ISO_3166-2
+      description: Learn more about ISO 3166-2
+  postal_code:
+    type: string
+    title: postal_code
+    description: The delivery address's postal code.
+  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
+x-schemaName: AdminFulfillmentDeliveryAddress

www/apps/api-reference/specs/admin/components/schemas/AdminIndexDetailsResponse.yaml

@@ -0,0 +1,11 @@
+type: object
+description: The index's metadata details.
+x-schemaName: AdminIndexDetailsResponse
+required:
+  - metadata
+properties:
+  metadata:
+    type: array
+    description: The index's metadata.
+    items:
+      $ref: ./IndexInfo.yaml

www/apps/api-reference/specs/admin/components/schemas/AdminIndexSyncPayload.yaml

@@ -0,0 +1,14 @@
+type: object
+description: The details of the index sync.
+x-schemaName: AdminIndexSyncPayload
+required:
+  - strategy
+properties:
+  strategy:
+    type: string
+    description: >-
+      The syncing strategy. `full` indicates a full reindex, while `reset`
+      truncates tables and performs a fresh sync.
+    enum:
+      - full
+      - reset

www/apps/api-reference/specs/admin/components/schemas/AdminInitiateReceiveReturn.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The return receival details.
-x-schemaName: AdminPostReceiveReturnsReqSchema
+x-schemaName: AdminInitiateReceiveReturn
 properties:
   internal_note:
     type: string

www/apps/api-reference/specs/admin/components/schemas/AdminInitiateReturnRequest.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The return's details.
-x-schemaName: AdminPostReturnsReqSchema
+x-schemaName: AdminInitiateReturnRequest
 required:
   - order_id
 properties:

www/apps/api-reference/specs/admin/components/schemas/AdminMarkPaymentCollectionAsPaid.yaml

@@ -7,4 +7,4 @@ properties:
     type: string
     title: order_id
     description: The ID of the order associated with the payment collection.
-x-schemaName: AdminMarkPaymentCollectionPaid
+x-schemaName: AdminMarkPaymentCollectionAsPaid

www/apps/api-reference/specs/admin/components/schemas/AdminOrder.yaml

@@ -6,13 +6,13 @@ required:
   - items
   - shipping_methods
   - status
-  - currency_code
   - id
   - version
   - region_id
   - customer_id
   - sales_channel_id
   - email
+  - currency_code
   - payment_status
   - fulfillment_status
   - summary

www/apps/api-reference/specs/admin/components/schemas/AdminOrderChange.yaml

@@ -14,7 +14,6 @@ required:
   - created_at
   - updated_at
   - order_id
-  - canceled_at
   - return_id
   - exchange_id
   - claim_id
@@ -26,6 +25,7 @@ required:
   - declined_reason
   - declined_at
   - canceled_by
+  - canceled_at
 properties:
   id:
     type: string

www/apps/api-reference/specs/admin/components/schemas/AdminOrderPreview.yaml

@@ -7,13 +7,13 @@ required:
   - return_requested_total
   - order_change
   - status
-  - currency_code
   - id
   - version
   - region_id
   - customer_id
   - sales_channel_id
   - email
+  - currency_code
   - payment_collections
   - payment_status
   - fulfillment_status

www/apps/api-reference/specs/admin/components/schemas/AdminPostClaimsAddItemsReqSchema.yaml

@@ -1,36 +0,0 @@
-type: object
-description: The details of the outbound items to add to the claim.
-x-schemaName: AdminPostClaimsAddItemsReqSchema
-properties:
-  items:
-    type: array
-    description: The outbound item's details.
-    items:
-      type: object
-      description: An item's details.
-      required:
-        - variant_id
-        - quantity
-      properties:
-        variant_id:
-          type: string
-          title: variant_id
-          description: The ID of the associated product variant.
-        quantity:
-          type: number
-          title: quantity
-          description: The quantity to send to the customer.
-        unit_price:
-          type: number
-          title: unit_price
-          description: The item's unit price.
-        internal_note:
-          type: string
-          title: internal_note
-          description: A note viewed only by admin users.
-        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

www/apps/api-reference/specs/admin/components/schemas/AdminProduct.yaml

@@ -9,13 +9,13 @@ required:
   - length
   - title
   - status
-  - description
   - id
   - created_at
   - updated_at
   - subtitle
   - thumbnail
   - handle
+  - description
   - is_giftcard
   - width
   - weight

www/apps/api-reference/specs/admin/components/schemas/AdminProductImage.yaml

@@ -35,6 +35,13 @@ properties:
     type: number
     title: rank
     description: The image's rank among sibling images.
+  product:
+    type: object
+  variants:
+    type: array
+    description: The variants associated with the image.
+    items:
+      type: object
 required:
   - id
   - url

www/apps/api-reference/specs/admin/components/schemas/AdminProductVariant.yaml

@@ -10,6 +10,7 @@ required:
   - barcode
   - ean
   - upc
+  - thumbnail
   - allow_backorder
   - manage_inventory
   - hs_code
@@ -144,3 +145,12 @@ properties:
     description: The variant's inventory items.
     items:
       $ref: ./AdminProductVariantInventoryItemLink.yaml
+  images:
+    type: array
+    description: The variant's images.
+    items:
+      $ref: ./AdminProductImage.yaml
+  thumbnail:
+    type: string
+    title: thumbnail
+    description: The variant's thumbnail.

www/apps/api-reference/specs/admin/components/schemas/AdminReceiveItems.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The items details.
-x-schemaName: AdminPostReturnsReceiveItemsReqSchema
+x-schemaName: AdminReceiveItems
 properties:
   items:
     type: array

www/apps/api-reference/specs/admin/components/schemas/AdminRefundPayment.yaml

@@ -13,4 +13,4 @@ properties:
     type: string
     title: note
     description: A note to attach to the refund.
-x-schemaName: AdminCreatePaymentRefund
+x-schemaName: AdminRefundPayment

www/apps/api-reference/specs/admin/components/schemas/AdminRegion.yaml

@@ -2,9 +2,9 @@ type: object
 description: The region's details.
 x-schemaName: AdminRegion
 required:
-  - name
-  - currency_code
   - id
+  - currency_code
+  - name
 properties:
   id:
     type: string

www/apps/api-reference/specs/admin/components/schemas/AdminRequestOrderTransfer.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The details of the request to transfer the order.
-x-schemaName: AdminTransferOrder
+x-schemaName: AdminRequestOrderTransfer
 required:
   - customer_id
 properties:

www/apps/api-reference/specs/admin/components/schemas/AdminUpdateClaimItem.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The details to update in the item.
-x-schemaName: AdminPostClaimsItemsActionReqSchema
+x-schemaName: AdminUpdateClaimItem
 properties:
   quantity:
     type: number

www/apps/api-reference/specs/admin/components/schemas/AdminUpdateClaimOutboundItem.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The details to update in the item.
-x-schemaName: AdminPostClaimsItemsActionReqSchema
+x-schemaName: AdminUpdateClaimOutboundItem
 properties:
   quantity:
     type: number

www/apps/api-reference/specs/admin/components/schemas/AdminUpdateDraftOrder.yaml

@@ -8,115 +8,9 @@ properties:
     description: The customer email associated with the draft order.
     format: email
   shipping_address:
-    type: object
-    description: The draft order's shipping address.
-    properties:
-      first_name:
-        type: string
-        title: first_name
-        description: The shipping address's first name.
-      last_name:
-        type: string
-        title: last_name
-        description: The shipping address's last name.
-      phone:
-        type: string
-        title: phone
-        description: The shipping address's phone.
-      company:
-        type: string
-        title: company
-        description: The shipping address's company.
-      address_1:
-        type: string
-        title: address_1
-        description: The first address line.
-      address_2:
-        type: string
-        title: address_2
-        description: The second address line.
-      city:
-        type: string
-        title: city
-        description: The shipping address's city.
-      country_code:
-        type: string
-        title: country_code
-        description: The shipping address's country code.
-        example: us
-      province:
-        type: string
-        title: province
-        description: The shipping address's ISO 3166-2 province code. Must be lower-case.
-        example: us-ca
-        externalDocs:
-          url: https://en.wikipedia.org/wiki/ISO_3166-2
-          description: Learn more about ISO 3166-2
-      postal_code:
-        type: string
-        title: postal_code
-        description: The shipping address's postal code.
-      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
+    $ref: ./OrderAddress.yaml
   billing_address:
-    type: object
-    description: The draft order's billing address.
-    properties:
-      first_name:
-        type: string
-        title: first_name
-        description: The billing address's first name.
-      last_name:
-        type: string
-        title: last_name
-        description: The billing address's last name.
-      phone:
-        type: string
-        title: phone
-        description: The billing address's phone.
-      company:
-        type: string
-        title: company
-        description: The billing address's company.
-      address_1:
-        type: string
-        title: address_1
-        description: The first address line.
-      address_2:
-        type: string
-        title: address_2
-        description: The second address line.
-      city:
-        type: string
-        title: city
-        description: The billing address's city.
-      country_code:
-        type: string
-        title: country_code
-        description: The billing address's country code.
-        example: us
-      province:
-        type: string
-        title: province
-        description: The billing address's ISO 3166-2 province code. Must be lower-case.
-        example: us-ca
-        externalDocs:
-          url: https://en.wikipedia.org/wiki/ISO_3166-2
-          description: Learn more about ISO 3166-2
-      postal_code:
-        type: string
-        title: postal_code
-        description: The billing address's postal code.
-      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
+    $ref: ./OrderAddress.yaml
   metadata:
     type: object
     description: The draft order's metadata, can hold custom key-value pairs.

www/apps/api-reference/specs/admin/components/schemas/AdminUpdateExchangeOutboundItem.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The details to update in an outbound item.
-x-schemaName: AdminPostExchangesItemsActionReqSchema
+x-schemaName: AdminUpdateExchangeOutboundItem
 properties:
   quantity:
     type: number

www/apps/api-reference/specs/admin/components/schemas/AdminUpdateFulfillmentSetServiceZone.yaml

@@ -155,4 +155,4 @@ properties:
               type: string
               title: id
               description: The ID of an existing geo zone.
-x-schemaName: AdminUpdateFulfillmentSetServiceZones
+x-schemaName: AdminUpdateFulfillmentSetServiceZone

www/apps/api-reference/specs/admin/components/schemas/AdminUpdateInventoryLevel.yaml

@@ -9,4 +9,4 @@ properties:
     type: number
     title: incoming_quantity
     description: The inventory level's incoming quantity.
-x-schemaName: AdminUpdateInventoryLocationLevel
+x-schemaName: AdminUpdateInventoryLevel

www/apps/api-reference/specs/admin/components/schemas/AdminUpdateOrder.yaml

@@ -8,115 +8,9 @@ properties:
     description: The order's email.
     format: email
   shipping_address:
-    type: object
-    description: The order's shipping address.
-    properties:
-      first_name:
-        type: string
-        title: first_name
-        description: The address's first name.
-      last_name:
-        type: string
-        title: last_name
-        description: The address's last name.
-      phone:
-        type: string
-        title: phone
-        description: The address's phone.
-      company:
-        type: string
-        title: company
-        description: The address's company.
-      address_1:
-        type: string
-        title: address_1
-        description: The address's first line.
-      address_2:
-        type: string
-        title: address_2
-        description: The address's second line.
-      city:
-        type: string
-        title: city
-        description: The address's city.
-      country_code:
-        type: string
-        title: country_code
-        description: The address's country code.
-        example: us
-      province:
-        type: string
-        title: province
-        description: The address's ISO 3166-2 province code. Must be lower-case.
-        example: us-ca
-        externalDocs:
-          url: https://en.wikipedia.org/wiki/ISO_3166-2
-          description: Learn more about ISO 3166-2
-      postal_code:
-        type: string
-        title: postal_code
-        description: The address's postal code.
-      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
+    $ref: ./OrderAddress.yaml
   billing_address:
-    type: object
-    description: The order's billing address.
-    properties:
-      first_name:
-        type: string
-        title: first_name
-        description: The address's first name.
-      last_name:
-        type: string
-        title: last_name
-        description: The address's last name.
-      phone:
-        type: string
-        title: phone
-        description: The address's phone.
-      company:
-        type: string
-        title: company
-        description: The address's company.
-      address_1:
-        type: string
-        title: address_1
-        description: The address's first line.
-      address_2:
-        type: string
-        title: address_2
-        description: The address's second line.
-      city:
-        type: string
-        title: city
-        description: The address's city.
-      country_code:
-        type: string
-        title: country_code
-        description: The address's country code.
-        example: us
-      province:
-        type: string
-        title: province
-        description: The address's ISO 3166-2 province code. Must be lower-case.
-        example: us-ca
-        externalDocs:
-          url: https://en.wikipedia.org/wiki/ISO_3166-2
-          description: Learn more about ISO 3166-2
-      postal_code:
-        type: string
-        title: postal_code
-        description: The address's postal code.
-      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
+    $ref: ./OrderAddress.yaml
   metadata:
     type: object
     description: The order's metadata, can hold custom key-value pairs.

www/apps/api-reference/specs/admin/components/schemas/AdminUpdateRefundReason.yaml

@@ -13,4 +13,10 @@ properties:
     type: string
     title: code
     description: The refund reason's code.
-x-schemaName: AdminUpdatePaymentRefundReason
+  metadata:
+    type: object
+    description: The refund reason's metadata.
+x-schemaName: AdminUpdateRefundReason
+required:
+  - label
+  - code

www/apps/api-reference/specs/admin/components/schemas/AdminUpdateReturnItems.yaml

@@ -0,0 +1,22 @@
+type: object
+description: The details to update in the item.
+x-schemaName: AdminUpdateReturnItems
+properties:
+  quantity:
+    type: number
+    title: quantity
+    description: The item's quantity.
+  internal_note:
+    type: string
+    title: internal_note
+    description: A note viewed only by admin users.
+  reason_id:
+    type: string
+    title: reason_id
+    description: The ID of the associated return reason.
+  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

www/apps/api-reference/specs/admin/components/schemas/AdminUpdateReturnRequest.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The return's details.
-x-schemaName: AdminPostReturnsReturnReqSchema
+x-schemaName: AdminUpdateReturnRequest
 properties:
   location_id:
     type: string

www/apps/api-reference/specs/admin/components/schemas/AdminUpdateReturnShipping.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The shipping method's details.
-x-schemaName: AdminPostReturnsShippingActionReqSchema
+x-schemaName: AdminUpdateReturnShipping
 properties:
   custom_amount:
     type: number

www/apps/api-reference/specs/admin/components/schemas/AdminUpdateShippingOption.yaml

@@ -0,0 +1,209 @@
+type: object
+description: The properties to update in the shipping option type.
+properties:
+  name:
+    type: string
+    title: name
+    description: The shipping option's name.
+  data:
+    type: object
+    description: The shipping option's data.
+  price_type:
+    type: string
+    description: The shipping option's price type.
+    enum:
+      - flat
+      - calculated
+  provider_id:
+    type: string
+    title: provider_id
+    description: The shipping option's provider id.
+  shipping_profile_id:
+    type: string
+    title: shipping_profile_id
+    description: The shipping option's shipping profile id.
+  type:
+    $ref: ./AdminCreateShippingOptionType.yaml
+  type_id:
+    type: string
+    title: type_id
+    description: The shipping option's type id.
+  prices:
+    type: array
+    description: The shipping option's prices.
+    items:
+      oneOf:
+        - type: object
+          description: The price's prices.
+          x-schemaName: AdminUpdateShippingOptionPriceWithCurrency
+          properties:
+            id:
+              type: string
+              title: id
+              description: The price's ID.
+            currency_code:
+              type: string
+              title: currency_code
+              description: The price's currency code.
+            amount:
+              type: number
+              title: amount
+              description: The price's amount.
+            rules:
+              type: array
+              description: The price's rules.
+              items:
+                type: object
+                description: The rule's rules.
+                x-schemaName: PriceRule
+                required:
+                  - attribute
+                  - operator
+                  - value
+                properties:
+                  attribute:
+                    type: string
+                    title: attribute
+                    description: The rule's attribute.
+                  operator:
+                    type: string
+                    description: The rule's operator.
+                    enum:
+                      - gt
+                      - lt
+                      - eq
+                      - lte
+                      - gte
+                  value:
+                    type: number
+                    title: value
+                    description: The rule's value.
+        - type: object
+          description: The price's prices.
+          x-schemaName: AdminUpdateShippingOptionPriceWithRegion
+          properties:
+            id:
+              type: string
+              title: id
+              description: The price's ID.
+            region_id:
+              type: string
+              title: region_id
+              description: The price's region id.
+            amount:
+              type: number
+              title: amount
+              description: The price's amount.
+            rules:
+              type: array
+              description: The price's rules.
+              items:
+                type: object
+                description: The rule's rules.
+                x-schemaName: PriceRule
+                required:
+                  - attribute
+                  - operator
+                  - value
+                properties:
+                  attribute:
+                    type: string
+                    title: attribute
+                    description: The rule's attribute.
+                  operator:
+                    type: string
+                    description: The rule's operator.
+                    enum:
+                      - gt
+                      - lt
+                      - eq
+                      - lte
+                      - gte
+                  value:
+                    type: number
+                    title: value
+                    description: The rule's value.
+  rules:
+    type: array
+    description: The shipping option's rules.
+    items:
+      oneOf:
+        - type: object
+          description: The rule's rules.
+          x-schemaName: AdminCreateShippingOptionRule
+          required:
+            - operator
+            - attribute
+            - value
+          properties:
+            operator:
+              type: string
+              description: The rule's operator.
+              enum:
+                - gt
+                - lt
+                - eq
+                - ne
+                - in
+                - lte
+                - gte
+                - nin
+            attribute:
+              type: string
+              title: attribute
+              description: The rule's attribute.
+            value:
+              oneOf:
+                - type: string
+                  title: value
+                  description: The rule's value.
+                - type: array
+                  description: The rule's value.
+                  items:
+                    type: string
+                    title: value
+                    description: The value's details.
+        - type: object
+          description: The rule's rules.
+          x-schemaName: AdminUpdateShippingOptionRule
+          required:
+            - id
+            - operator
+            - attribute
+            - value
+          properties:
+            id:
+              type: string
+              title: id
+              description: The rule's ID.
+            operator:
+              type: string
+              description: The rule's operator.
+              enum:
+                - gt
+                - lt
+                - eq
+                - ne
+                - in
+                - lte
+                - gte
+                - nin
+            attribute:
+              type: string
+              title: attribute
+              description: The rule's attribute.
+            value:
+              oneOf:
+                - type: string
+                  title: value
+                  description: The rule's value.
+                - type: array
+                  description: The rule's value.
+                  items:
+                    type: string
+                    title: value
+                    description: The value's details.
+  metadata:
+    type: object
+    description: The shipping option's metadata.
+x-schemaName: AdminUpdateShippingOption

www/apps/api-reference/specs/admin/components/schemas/AdminUpdateStockLocation.yaml

@@ -7,51 +7,7 @@ properties:
     title: name
     description: The stock location's name.
   address:
-    type: object
-    description: >-
-      The stock location's address. Pass this property if you're creating a new
-      address to associate with the location.
-    required:
-      - address_1
-      - country_code
-    properties:
-      address_1:
-        type: string
-        title: address_1
-        description: The address's first line.
-      address_2:
-        type: string
-        title: address_2
-        description: The address's second line.
-      company:
-        type: string
-        title: company
-        description: The address's company.
-      city:
-        type: string
-        title: city
-        description: The address's city.
-      country_code:
-        type: string
-        title: country_code
-        description: The address's country code.
-        example: us
-      phone:
-        type: string
-        title: phone
-        description: The address's phone.
-      postal_code:
-        type: string
-        title: postal_code
-        description: The address's postal code.
-      province:
-        type: string
-        title: province
-        description: The address's ISO 3166-2 province code. Must be lower-case.
-        example: us-ca
-        externalDocs:
-          url: https://en.wikipedia.org/wiki/ISO_3166-2
-          description: Learn more about ISO 3166-2
+    $ref: ./AdminUpsertStockLocationAddress.yaml
   address_id:
     type: string
     title: address_id

www/apps/api-reference/specs/admin/components/schemas/AdminUpdateStore.yaml

@@ -10,24 +10,7 @@ properties:
     type: array
     description: The store's supported currencies.
     items:
-      type: object
-      description: A store currency.
-      required:
-        - currency_code
-      properties:
-        currency_code:
-          type: string
-          title: currency_code
-          description: The currency's code.
-          example: usd
-        is_default:
-          type: boolean
-          title: is_default
-          description: Whether the currency is the default in the store.
-        is_tax_inclusive:
-          type: boolean
-          title: is_tax_inclusive
-          description: Whether prices using this currency are tax inclusive.
+      $ref: ./AdminUpdateStoreSupportedCurrency.yaml
   default_sales_channel_id:
     type: string
     title: default_sales_channel_id

www/apps/api-reference/specs/admin/components/schemas/AdminUpdateStoreSupportedCurrency.yaml

@@ -0,0 +1,19 @@
+type: object
+description: The details to update in a supported currency of the store.
+required:
+  - currency_code
+properties:
+  currency_code:
+    type: string
+    title: currency_code
+    description: The currency's code.
+    example: usd
+  is_default:
+    type: boolean
+    title: is_default
+    description: Whether the currency is the default in the store.
+  is_tax_inclusive:
+    type: boolean
+    title: is_tax_inclusive
+    description: Whether prices using this currency are tax inclusive.
+x-schemaName: AdminUpdateStoreSupportedCurrency

www/apps/api-reference/specs/admin/components/schemas/AdminUpdateTaxRate.yaml

@@ -14,22 +14,7 @@ properties:
     type: array
     description: The tax rate's rules.
     items:
-      type: object
-      description: A tax rate rule.
-      required:
-        - reference
-        - reference_id
-      properties:
-        reference:
-          type: string
-          title: reference
-          description: The name of the table this rule references.
-          example: product_type
-        reference_id:
-          type: string
-          title: reference_id
-          description: The ID of the record in the table that the rule references.
-          example: ptyp_123
+      $ref: ./AdminCreateTaxRateRule.yaml
   name:
     type: string
     title: name
@@ -51,3 +36,5 @@ properties:
     externalDocs:
       url: https://docs.medusajs.com/api/admin#manage-metadata
       description: Learn how to manage metadata
+required:
+  - code

www/apps/api-reference/specs/admin/components/schemas/BaseProductVariant.yaml

@@ -8,6 +8,7 @@ required:
   - barcode
   - ean
   - upc
+  - thumbnail
   - allow_backorder
   - manage_inventory
   - hs_code
@@ -133,3 +134,7 @@ properties:
     externalDocs:
       url: https://docs.medusajs.com/api/store#manage-metadata
       description: Learn how to manage metadata
+  thumbnail:
+    type: string
+    title: thumbnail
+    description: The variant's thumbnail.

www/apps/api-reference/specs/admin/components/schemas/IndexInfo.yaml

@@ -0,0 +1,43 @@
+type: object
+description: The index's metadata information.
+x-schemaName: IndexInfo
+required:
+  - id
+  - entity
+  - status
+  - fields
+  - updated_at
+  - last_synced_key
+properties:
+  id:
+    type: string
+    title: id
+    description: The index's ID.
+  entity:
+    type: string
+    title: entity
+    description: The index's entity.
+  status:
+    type: string
+    description: The index's syncing or ingesting status.
+    enum:
+      - pending
+      - error
+      - done
+      - processing
+  fields:
+    type: array
+    description: The index's fields.
+    items:
+      type: string
+      title: fields
+      description: The index's fields.
+  updated_at:
+    type: string
+    format: date-time
+    title: updated_at
+    description: The date the index was last updated.
+  last_synced_key:
+    type: string
+    title: last_synced_key
+    description: The key of the last index sync.

www/apps/api-reference/specs/admin/components/schemas/StoreCart.yaml

@@ -3,8 +3,8 @@ description: The cart's details.
 x-schemaName: StoreCart
 required:
   - promotions
-  - currency_code
   - id
+  - currency_code
   - original_item_total
   - original_item_subtotal
   - original_item_tax_total

www/apps/api-reference/specs/admin/components/schemas/StoreDeclineOrderTransfer.yaml

@@ -1,6 +1,6 @@
 type: object
 description: The details of declining the order transfer request.
-x-schemaName: StoreDeclineOrderTransferRequest
+x-schemaName: StoreDeclineOrderTransfer
 required:
   - token
 properties:

www/apps/api-reference/specs/admin/components/schemas/StoreOrder.yaml

@@ -5,12 +5,12 @@ required:
   - items
   - shipping_methods
   - status
-  - currency_code
   - id
   - region_id
   - customer_id
   - sales_channel_id
   - email
+  - currency_code
   - payment_status
   - fulfillment_status
   - summary

www/apps/api-reference/specs/admin/components/schemas/StoreProductVariant.yaml

@@ -120,6 +120,10 @@ properties:
     description: The variant's rank among its siblings.
   calculated_price:
     $ref: ./BaseCalculatedPriceSet.yaml
+  thumbnail:
+    type: string
+    title: thumbnail
+    description: The variant's thumbnail.
 required:
   - options
   - length
@@ -127,6 +131,7 @@ required:
   - id
   - created_at
   - updated_at
+  - thumbnail
   - width
   - weight
   - height
@@ -135,9 +140,9 @@ required:
   - mid_code
   - material
   - deleted_at
-  - sku
-  - barcode
   - manage_inventory
   - allow_backorder
   - ean
   - upc
+  - barcode
+  - sku

www/apps/api-reference/specs/admin/openapi.yaml

@@ -201,6 +201,14 @@ tags:
       </Note>
     x-associatedSchema:
       $ref: ./components/schemas/AdminGiftCard.yaml
+  - name: Index
+    description: >
+      The Index Module is a tool to perform high-performance queries across
+      modules, for example, to filter linked modules.
+
+      The Index Module is currently experimental and is hidden behind a feature
+      flag. Learn more about it and how to enable it in the [Index Module
+      guide](https://docs.medusajs.com/learn/fundamentals/module-links/index-module).
   - name: Inventory Items
     description: |
       An inventory item is a stock-kept product whose inventory is managed.
@@ -874,6 +882,10 @@ paths:
     $ref: paths/admin_gift-cards_{id}_orders.yaml
   /admin/gift-cards/{id}/redeem:
     $ref: paths/admin_gift-cards_{id}_redeem.yaml
+  /admin/index/details:
+    $ref: paths/admin_index_details.yaml
+  /admin/index/sync:
+    $ref: paths/admin_index_sync.yaml
   /admin/inventory-items:
     $ref: paths/admin_inventory-items.yaml
   /admin/inventory-items/location-levels/batch:
@@ -1011,6 +1023,8 @@ paths:
     $ref: paths/admin_products_imports_{transaction_id}_confirm.yaml
   /admin/products/{id}:
     $ref: paths/admin_products_{id}.yaml
+  /admin/products/{id}/images/{image_id}/variants/batch:
+    $ref: paths/admin_products_{id}_images_{image_id}_variants_batch.yaml
   /admin/products/{id}/options:
     $ref: paths/admin_products_{id}_options.yaml
   /admin/products/{id}/options/{option_id}:
@@ -1023,6 +1037,8 @@ paths:
     $ref: paths/admin_products_{id}_variants_inventory-items_batch.yaml
   /admin/products/{id}/variants/{variant_id}:
     $ref: paths/admin_products_{id}_variants_{variant_id}.yaml
+  /admin/products/{id}/variants/{variant_id}/images/batch:
+    $ref: paths/admin_products_{id}_variants_{variant_id}_images_batch.yaml
   /admin/products/{id}/variants/{variant_id}/inventory-items:
     $ref: paths/admin_products_{id}_variants_{variant_id}_inventory-items.yaml
   /admin/products/{id}/variants/{variant_id}/inventory-items/{inventory_item_id}:

www/apps/api-reference/specs/admin/paths/admin_api-keys_{id}_sales-channels.yaml

@@ -39,23 +39,7 @@ post:
     content:
       application/json:
         schema:
-          type: object
-          description: The sales channels to add or remove from the publishable API key.
-          properties:
-            add:
-              type: array
-              description: The sales channels to add to the publishable API key.
-              items:
-                type: string
-                title: add
-                description: A sales channel's ID.
-            remove:
-              type: array
-              description: The sales channels to remove from the publishable API key.
-              items:
-                type: string
-                title: remove
-                description: A sales channel's ID.
+          $ref: ../components/schemas/AdminBatchLink.yaml
   x-codeSamples:
     - lang: JavaScript
       label: JS SDK

www/apps/api-reference/specs/admin/paths/admin_campaigns.yaml

@@ -65,6 +65,63 @@ get:
         type: boolean
         title: with_deleted
         description: Whether to include deleted records in the result.
+    - name: q
+      in: query
+      description: Apply a search query to the campaign's searchable properties.
+      required: false
+      schema:
+        type: string
+        title: q
+        description: Apply a search query to the campaign's searchable properties.
+    - name: campaign_identifier
+      in: query
+      description: Filter by a campaign identifier.
+      required: false
+      schema:
+        type: string
+        title: campaign_identifier
+        description: Filter by a campaign identifier.
+    - name: budget
+      in: query
+      description: Filter by the campaign's budget.
+      required: false
+      schema:
+        type: object
+        description: Filter by the campaign's budget.
+        properties:
+          currency_code:
+            type: string
+            title: currency_code
+            description: The budget's currency code.
+            example: usd
+    - name: $and
+      in: query
+      description: >-
+        Join query parameters with an AND condition. Each object's content is
+        the same type as the expected query parameters.
+      required: false
+      schema:
+        type: array
+        description: >-
+          Join query parameters with an AND condition. Each object's content is
+          the same type as the expected query parameters.
+        items:
+          type: object
+        title: $and
+    - name: $or
+      in: query
+      description: >-
+        Join query parameters with an OR condition. Each object's content is the
+        same type as the expected query parameters.
+      required: false
+      schema:
+        type: array
+        description: >-
+          Join query parameters with an OR condition. Each object's content is
+          the same type as the expected query parameters.
+        items:
+          type: object
+        title: $or
   security:
     - api_token: []
     - cookie_auth: []

www/apps/api-reference/specs/admin/paths/admin_campaigns_{id}_promotions.yaml

@@ -39,23 +39,7 @@ post:
     content:
       application/json:
         schema:
-          type: object
-          description: The promotions to add or remove from the campaign.
-          properties:
-            add:
-              type: array
-              description: The promotions to add to the campaign.
-              items:
-                type: string
-                title: add
-                description: A promotion's ID.
-            remove:
-              type: array
-              description: The promotions to remove from the campaign.
-              items:
-                type: string
-                title: remove
-                description: A promotion's ID.
+          $ref: ../components/schemas/AdminBatchLink.yaml
   x-codeSamples:
     - lang: JavaScript
       label: JS SDK

www/apps/api-reference/specs/admin/paths/admin_claims.yaml

@@ -59,11 +59,11 @@ get:
           with `-`.
     - name: deleted_at
       in: query
-      description: The claim's deleted at.
+      description: Filter by the claim's deletion date.
       required: false
       schema:
         type: object
-        description: The claim's deleted at.
+        description: The claim's deletion date.
         properties:
           $and:
             type: array
@@ -383,20 +383,20 @@ get:
         oneOf:
           - type: string
             title: status
-            description: The claim's status.
+            description: Filter by the claim's status.
           - type: array
-            description: The claim's status.
+            description: Filter by the claim's status.
             items:
               type: string
               title: status
-              description: The status's details.
+              description: The claim's status.
     - name: created_at
       in: query
-      description: The claim's created at.
+      description: Filter by the claim's creation date.
       required: false
       schema:
         type: object
-        description: The claim's created at.
+        description: The claim's creation date.
         properties:
           $and:
             type: array
@@ -675,11 +675,11 @@ get:
             description: Filter by whether a value for this parameter exists (not `null`).
     - name: updated_at
       in: query
-      description: The claim's updated at.
+      description: Filter by the claim's update date.
       required: false
       schema:
         type: object
-        description: The claim's updated at.
+        description: The claim's update date.
         properties:
           $and:
             type: array
@@ -1052,6 +1052,451 @@ post:
           prefix it will replace the entire default fields.
         externalDocs:
           url: '#select-fields-and-relations'
+    - name: id
+      in: query
+      required: false
+      schema:
+        oneOf:
+          - type: string
+            title: id
+            description: Filter by the claim's ID.
+          - type: array
+            description: Filter by multiple claim IDs.
+            items:
+              type: string
+              title: id
+              description: A claim ID.
+    - name: status
+      in: query
+      required: false
+      schema:
+        oneOf:
+          - type: string
+            title: status
+            description: Filter by the claim's status.
+          - type: array
+            description: Filter by multiple claim statuses.
+            items:
+              type: string
+              title: status
+              description: A claim status.
+    - name: created_at
+      in: query
+      description: Filter by a claim's creation date.
+      required: false
+      schema:
+        type: object
+        description: Filter by a claim's creation date.
+        properties:
+          $and:
+            type: array
+            description: >-
+              Join query parameters with an AND condition. Each object's content
+              is the same type as the expected query parameters.
+            items:
+              type: object
+            title: $and
+          $or:
+            type: array
+            description: >-
+              Join query parameters with an OR condition. Each object's content
+              is the same type as the expected query parameters.
+            items:
+              type: object
+            title: $or
+          $eq:
+            oneOf:
+              - type: string
+                title: $eq
+                description: Filter by an exact match.
+              - type: array
+                description: Filter by an exact match.
+                items:
+                  type: string
+                  title: $eq
+                  description: Filter by an exact match.
+          $ne:
+            type: string
+            title: $ne
+            description: Filter by values not equal to this parameter.
+          $in:
+            type: array
+            description: Filter by values in this array.
+            items:
+              type: string
+              title: $in
+              description: Filter by values in this array.
+          $nin:
+            type: array
+            description: Filter by values not in this array.
+            items:
+              type: string
+              title: $nin
+              description: Filter by values not in this array.
+          $not:
+            oneOf:
+              - type: string
+                title: $not
+                description: >-
+                  Filter by values not matching the conditions in this
+                  parameter.
+              - type: object
+                description: >-
+                  Filter by values not matching the conditions in this
+                  parameter.
+              - type: array
+                description: >-
+                  Filter by values not matching the conditions in this
+                  parameter.
+                items:
+                  type: string
+                  title: $not
+                  description: >-
+                    Filter by values not matching the conditions in this
+                    parameter.
+          $gt:
+            type: string
+            title: $gt
+            description: >-
+              Filter by values greater than this parameter. Useful for numbers
+              and dates only.
+          $gte:
+            type: string
+            title: $gte
+            description: >-
+              Filter by values greater than or equal to this parameter. Useful
+              for numbers and dates only.
+          $lt:
+            type: string
+            title: $lt
+            description: >-
+              Filter by values less than this parameter. Useful for numbers and
+              dates only.
+          $lte:
+            type: string
+            title: $lte
+            description: >-
+              Filter by values less than or equal to this parameter. Useful for
+              numbers and dates only.
+          $like:
+            type: string
+            title: $like
+            description: Apply a `like` filter. Useful for strings only.
+          $re:
+            type: string
+            title: $re
+            description: Apply a regex filter. Useful for strings only.
+          $ilike:
+            type: string
+            title: $ilike
+            description: Apply a case-insensitive `like` filter. Useful for strings only.
+          $fulltext:
+            type: string
+            title: $fulltext
+            description: Filter to apply on full-text properties.
+          $overlap:
+            type: array
+            description: Filter arrays that have overlapping values with this parameter.
+            items:
+              type: string
+              title: $overlap
+              description: Filter arrays that have overlapping values with this parameter.
+          $contains:
+            type: array
+            description: Filter arrays that contain some of the values of this parameter.
+            items:
+              type: string
+              title: $contains
+              description: Filter arrays that contain some of the values of this parameter.
+          $contained:
+            type: array
+            description: Filter arrays that contain all values of this parameter.
+            items:
+              type: string
+              title: $contained
+              description: Filter arrays that contain all values of this parameter.
+          $exists:
+            type: boolean
+            title: $exists
+            description: Filter by whether a value for this parameter exists (not `null`).
+    - name: updated_at
+      in: query
+      description: Filter by a claim's update date.
+      required: false
+      schema:
+        type: object
+        description: Filter by a claim's update date.
+        properties:
+          $and:
+            type: array
+            description: >-
+              Join query parameters with an AND condition. Each object's content
+              is the same type as the expected query parameters.
+            items:
+              type: object
+            title: $and
+          $or:
+            type: array
+            description: >-
+              Join query parameters with an OR condition. Each object's content
+              is the same type as the expected query parameters.
+            items:
+              type: object
+            title: $or
+          $eq:
+            oneOf:
+              - type: string
+                title: $eq
+                description: Filter by an exact match.
+              - type: array
+                description: Filter by an exact match.
+                items:
+                  type: string
+                  title: $eq
+                  description: Filter by an exact match.
+          $ne:
+            type: string
+            title: $ne
+            description: Filter by values not equal to this parameter.
+          $in:
+            type: array
+            description: Filter by values in this array.
+            items:
+              type: string
+              title: $in
+              description: Filter by values in this array.
+          $nin:
+            type: array
+            description: Filter by values not in this array.
+            items:
+              type: string
+              title: $nin
+              description: Filter by values not in this array.
+          $not:
+            oneOf:
+              - type: string
+                title: $not
+                description: >-
+                  Filter by values not matching the conditions in this
+                  parameter.
+              - type: object
+                description: >-
+                  Filter by values not matching the conditions in this
+                  parameter.
+              - type: array
+                description: >-
+                  Filter by values not matching the conditions in this
+                  parameter.
+                items:
+                  type: string
+                  title: $not
+                  description: >-
+                    Filter by values not matching the conditions in this
+                    parameter.
+          $gt:
+            type: string
+            title: $gt
+            description: >-
+              Filter by values greater than this parameter. Useful for numbers
+              and dates only.
+          $gte:
+            type: string
+            title: $gte
+            description: >-
+              Filter by values greater than or equal to this parameter. Useful
+              for numbers and dates only.
+          $lt:
+            type: string
+            title: $lt
+            description: >-
+              Filter by values less than this parameter. Useful for numbers and
+              dates only.
+          $lte:
+            type: string
+            title: $lte
+            description: >-
+              Filter by values less than or equal to this parameter. Useful for
+              numbers and dates only.
+          $like:
+            type: string
+            title: $like
+            description: Apply a `like` filter. Useful for strings only.
+          $re:
+            type: string
+            title: $re
+            description: Apply a regex filter. Useful for strings only.
+          $ilike:
+            type: string
+            title: $ilike
+            description: Apply a case-insensitive `like` filter. Useful for strings only.
+          $fulltext:
+            type: string
+            title: $fulltext
+            description: Filter to apply on full-text properties.
+          $overlap:
+            type: array
+            description: Filter arrays that have overlapping values with this parameter.
+            items:
+              type: string
+              title: $overlap
+              description: Filter arrays that have overlapping values with this parameter.
+          $contains:
+            type: array
+            description: Filter arrays that contain some of the values of this parameter.
+            items:
+              type: string
+              title: $contains
+              description: Filter arrays that contain some of the values of this parameter.
+          $contained:
+            type: array
+            description: Filter arrays that contain all values of this parameter.
+            items:
+              type: string
+              title: $contained
+              description: Filter arrays that contain all values of this parameter.
+          $exists:
+            type: boolean
+            title: $exists
+            description: Filter by whether a value for this parameter exists (not `null`).
+    - name: deleted_at
+      in: query
+      description: Filter by a claim's deletion date.
+      required: false
+      schema:
+        type: object
+        description: Filter by a claim's deletion date.
+        properties:
+          $and:
+            type: array
+            description: >-
+              Join query parameters with an AND condition. Each object's content
+              is the same type as the expected query parameters.
+            items:
+              type: object
+            title: $and
+          $or:
+            type: array
+            description: >-
+              Join query parameters with an OR condition. Each object's content
+              is the same type as the expected query parameters.
+            items:
+              type: object
+            title: $or
+          $eq:
+            oneOf:
+              - type: string
+                title: $eq
+                description: Filter by an exact match.
+              - type: array
+                description: Filter by an exact match.
+                items:
+                  type: string
+                  title: $eq
+                  description: Filter by an exact match.
+          $ne:
+            type: string
+            title: $ne
+            description: Filter by values not equal to this parameter.
+          $in:
+            type: array
+            description: Filter by values in this array.
+            items:
+              type: string
+              title: $in
+              description: Filter by values in this array.
+          $nin:
+            type: array
+            description: Filter by values not in this array.
+            items:
+              type: string
+              title: $nin
+              description: Filter by values not in this array.
+          $not:
+            oneOf:
+              - type: string
+                title: $not
+                description: >-
+                  Filter by values not matching the conditions in this
+                  parameter.
+              - type: object
+                description: >-
+                  Filter by values not matching the conditions in this
+                  parameter.
+              - type: array
+                description: >-
+                  Filter by values not matching the conditions in this
+                  parameter.
+                items:
+                  type: string
+                  title: $not
+                  description: >-
+                    Filter by values not matching the conditions in this
+                    parameter.
+          $gt:
+            type: string
+            title: $gt
+            description: >-
+              Filter by values greater than this parameter. Useful for numbers
+              and dates only.
+          $gte:
+            type: string
+            title: $gte
+            description: >-
+              Filter by values greater than or equal to this parameter. Useful
+              for numbers and dates only.
+          $lt:
+            type: string
+            title: $lt
+            description: >-
+              Filter by values less than this parameter. Useful for numbers and
+              dates only.
+          $lte:
+            type: string
+            title: $lte
+            description: >-
+              Filter by values less than or equal to this parameter. Useful for
+              numbers and dates only.
+          $like:
+            type: string
+            title: $like
+            description: Apply a `like` filter. Useful for strings only.
+          $re:
+            type: string
+            title: $re
+            description: Apply a regex filter. Useful for strings only.
+          $ilike:
+            type: string
+            title: $ilike
+            description: Apply a case-insensitive `like` filter. Useful for strings only.
+          $fulltext:
+            type: string
+            title: $fulltext
+            description: Filter to apply on full-text properties.
+          $overlap:
+            type: array
+            description: Filter arrays that have overlapping values with this parameter.
+            items:
+              type: string
+              title: $overlap
+              description: Filter arrays that have overlapping values with this parameter.
+          $contains:
+            type: array
+            description: Filter arrays that contain some of the values of this parameter.
+            items:
+              type: string
+              title: $contains
+              description: Filter arrays that contain some of the values of this parameter.
+          $contained:
+            type: array
+            description: Filter arrays that contain all values of this parameter.
+            items:
+              type: string
+              title: $contained
+              description: Filter arrays that contain all values of this parameter.
+          $exists:
+            type: boolean
+            title: $exists
+            description: Filter by whether a value for this parameter exists (not `null`).
   security:
     - api_token: []
     - cookie_auth: []
@@ -1060,7 +1505,7 @@ post:
     content:
       application/json:
         schema:
-          $ref: ../components/schemas/AdminPostOrderClaimsReqSchema.yaml
+          $ref: ../components/schemas/AdminCreateClaim.yaml
   x-codeSamples:
     - lang: JavaScript
       label: JS SDK

www/apps/api-reference/specs/admin/paths/admin_claims_{id}_claim-items.yaml

@@ -39,7 +39,7 @@ post:
     content:
       application/json:
         schema:
-          $ref: ../components/schemas/AdminPostClaimItemsReqSchema.yaml
+          $ref: ../components/schemas/AdminAddClaimItems.yaml
   x-codeSamples:
     - lang: JavaScript
       label: JS SDK

www/apps/api-reference/specs/admin/paths/admin_claims_{id}_claim-items_{action_id}.yaml

@@ -49,7 +49,7 @@ post:
     content:
       application/json:
         schema:
-          $ref: ../components/schemas/AdminPostClaimsItemsActionReqSchema.yaml
+          $ref: ../components/schemas/AdminUpdateClaimItem.yaml
   x-codeSamples:
     - lang: JavaScript
       label: JS SDK

www/apps/api-reference/specs/admin/paths/admin_claims_{id}_inbound_shipping-method_{action_id}.yaml

@@ -50,7 +50,7 @@ post:
     content:
       application/json:
         schema:
-          $ref: ../components/schemas/AdminPostClaimsShippingActionReqSchema.yaml
+          $ref: ../components/schemas/AdminClaimUpdateInboundShipping.yaml
   x-codeSamples:
     - lang: JavaScript
       label: JS SDK

www/apps/api-reference/specs/admin/paths/admin_claims_{id}_outbound_items.yaml

@@ -39,7 +39,7 @@ post:
     content:
       application/json:
         schema:
-          $ref: ../components/schemas/AdminPostClaimsAddItemsReqSchema.yaml
+          $ref: ../components/schemas/AdminAddClaimOutboundItems.yaml
   x-codeSamples:
     - lang: JavaScript
       label: JS SDK

www/apps/api-reference/specs/admin/paths/admin_claims_{id}_outbound_items_{action_id}.yaml

@@ -50,7 +50,7 @@ post:
     content:
       application/json:
         schema:
-          $ref: ../components/schemas/AdminPostClaimsItemsActionReqSchema.yaml
+          $ref: ../components/schemas/AdminUpdateClaimOutboundItem.yaml
   x-codeSamples:
     - lang: JavaScript
       label: JS SDK

www/apps/api-reference/specs/admin/paths/admin_claims_{id}_outbound_shipping-method.yaml

@@ -39,7 +39,7 @@ post:
     content:
       application/json:
         schema:
-          $ref: ../components/schemas/AdminPostClaimsShippingReqSchema.yaml
+          $ref: ../components/schemas/AdminClaimAddOutboundShipping.yaml
   x-codeSamples:
     - lang: JavaScript
       label: JS SDK

www/apps/api-reference/specs/admin/paths/admin_claims_{id}_outbound_shipping-method_{action_id}.yaml

@@ -50,7 +50,7 @@ post:
     content:
       application/json:
         schema:
-          $ref: ../components/schemas/AdminPostClaimsShippingActionReqSchema.yaml
+          $ref: ../components/schemas/AdminClaimUpdateOutboundShipping.yaml
   x-codeSamples:
     - lang: JavaScript
       label: JS SDK