chore(docs): Updated API Reference (automated) (#10258)
Automated changes by [create-pull-request](https://github.com/peter-evans/create-pull-request) GitHub action Co-authored-by: Oli Juhl <59018053+olivermrbl@users.noreply.github.com> Co-authored-by: Shahed Nasser <27354907+shahednasser@users.noreply.github.com>
This commit is contained in:
73 files changed
+2943
-275
No files matched your search
@@ -13,7 +13,7 @@
|
||||
* type: array
|
||||
* description: The products to update.
|
||||
* items:
|
||||
* $ref: "#/components/schemas/AdminUpdateProduct"
|
||||
* $ref: "#/components/schemas/AdminBatchUpdateProduct"
|
||||
* delete:
|
||||
* type: array
|
||||
* description: The products to delete.
|
||||
|
||||
@@ -0,0 +1,162 @@
|
||||
/**
|
||||
* @schema AdminBatchUpdateProduct
|
||||
* type: object
|
||||
* description: The product's details.
|
||||
* x-schemaName: AdminBatchUpdateProduct
|
||||
* properties:
|
||||
* title:
|
||||
* type: string
|
||||
* title: title
|
||||
* description: The product's title.
|
||||
* subtitle:
|
||||
* type: string
|
||||
* title: subtitle
|
||||
* description: The product's subtitle.
|
||||
* description:
|
||||
* type: string
|
||||
* title: description
|
||||
* description: The product's description.
|
||||
* is_giftcard:
|
||||
* type: boolean
|
||||
* title: is_giftcard
|
||||
* description: Whether the product is a gift card.
|
||||
* discountable:
|
||||
* type: boolean
|
||||
* title: discountable
|
||||
* description: Whether discounts can be applied on the product.
|
||||
* images:
|
||||
* type: array
|
||||
* description: The product's images.
|
||||
* items:
|
||||
* type: object
|
||||
* description: The image's details.
|
||||
* required:
|
||||
* - url
|
||||
* properties:
|
||||
* url:
|
||||
* type: string
|
||||
* title: url
|
||||
* description: The image's URL.
|
||||
* thumbnail:
|
||||
* type: string
|
||||
* title: thumbnail
|
||||
* description: The product's thumbnail URL.
|
||||
* handle:
|
||||
* type: string
|
||||
* title: handle
|
||||
* description: The product's unique handle.
|
||||
* status:
|
||||
* type: string
|
||||
* description: The product's status.
|
||||
* enum:
|
||||
* - draft
|
||||
* - proposed
|
||||
* - published
|
||||
* - rejected
|
||||
* type_id:
|
||||
* type: string
|
||||
* title: type_id
|
||||
* description: The ID of the product's type.
|
||||
* collection_id:
|
||||
* type: string
|
||||
* title: collection_id
|
||||
* description: The ID of the product's collection.
|
||||
* categories:
|
||||
* type: array
|
||||
* description: The product's categories.
|
||||
* items:
|
||||
* type: object
|
||||
* description: The product's category.
|
||||
* required:
|
||||
* - id
|
||||
* properties:
|
||||
* id:
|
||||
* type: string
|
||||
* title: id
|
||||
* description: The category's ID.
|
||||
* tags:
|
||||
* type: array
|
||||
* description: The product's tags.
|
||||
* items:
|
||||
* type: object
|
||||
* description: The product's tag.
|
||||
* required:
|
||||
* - id
|
||||
* properties:
|
||||
* id:
|
||||
* type: string
|
||||
* title: id
|
||||
* description: The tag's ID.
|
||||
* options:
|
||||
* type: array
|
||||
* description: The product's options.
|
||||
* items:
|
||||
* $ref: "#/components/schemas/AdminUpdateProductOption"
|
||||
* variants:
|
||||
* type: array
|
||||
* description: The product's variants. You can add new variants or update existing ones, passing their IDs in the object.
|
||||
* items:
|
||||
* oneOf:
|
||||
* - $ref: "#/components/schemas/AdminCreateProductVariant"
|
||||
* - $ref: "#/components/schemas/AdminUpdateProductVariant"
|
||||
* sales_channels:
|
||||
* type: array
|
||||
* description: The sales channels that the product is available in.
|
||||
* items:
|
||||
* type: object
|
||||
* description: The sales channel's details.
|
||||
* required:
|
||||
* - id
|
||||
* properties:
|
||||
* id:
|
||||
* type: string
|
||||
* title: id
|
||||
* description: The sales channel's ID.
|
||||
* weight:
|
||||
* type: number
|
||||
* title: weight
|
||||
* description: The product's weight.
|
||||
* length:
|
||||
* type: number
|
||||
* title: length
|
||||
* description: The product's length.
|
||||
* height:
|
||||
* type: number
|
||||
* title: height
|
||||
* description: The product's height.
|
||||
* width:
|
||||
* type: number
|
||||
* title: width
|
||||
* description: The product's width.
|
||||
* hs_code:
|
||||
* type: string
|
||||
* title: hs_code
|
||||
* description: The product's HS code.
|
||||
* mid_code:
|
||||
* type: string
|
||||
* title: mid_code
|
||||
* description: The product's MID code.
|
||||
* origin_country:
|
||||
* type: string
|
||||
* title: origin_country
|
||||
* description: The product's origin country.
|
||||
* material:
|
||||
* type: string
|
||||
* title: material
|
||||
* description: The product's material.
|
||||
* metadata:
|
||||
* type: object
|
||||
* description: The product's metadata, can hold custom key-value pairs.
|
||||
* external_id:
|
||||
* type: string
|
||||
* title: external_id
|
||||
* description: The ID of the product in an external or third-party system.
|
||||
* id:
|
||||
* type: string
|
||||
* title: id
|
||||
* description: The product's ID.
|
||||
* required:
|
||||
* - id
|
||||
*
|
||||
*/
|
||||
|
||||
@@ -30,9 +30,14 @@
|
||||
* metadata:
|
||||
* type: object
|
||||
* description: The image's metadata, can hold custom key-value pairs.
|
||||
* rank:
|
||||
* type: number
|
||||
* title: rank
|
||||
* description: The image's rank among sibling images.
|
||||
* required:
|
||||
* - id
|
||||
* - url
|
||||
* - rank
|
||||
*
|
||||
*/
|
||||
|
||||
@@ -0,0 +1,23 @@
|
||||
/**
|
||||
* @schema AdminTransferOrder
|
||||
* type: object
|
||||
* description: The details of the request to transfer the order.
|
||||
* x-schemaName: AdminTransferOrder
|
||||
* required:
|
||||
* - customer_id
|
||||
* properties:
|
||||
* customer_id:
|
||||
* type: string
|
||||
* title: customer_id
|
||||
* description: The ID of the customer to transfer the order to.
|
||||
* description:
|
||||
* type: string
|
||||
* title: description
|
||||
* description: The description of the order transfer, which can be shown to the customer receiving the order transfer request.
|
||||
* internal_note:
|
||||
* type: string
|
||||
* title: internal_note
|
||||
* description: An internal note viewable only by admin users.
|
||||
*
|
||||
*/
|
||||
|
||||
@@ -53,9 +53,63 @@
|
||||
* calculated_price:
|
||||
* type: object
|
||||
* description: The calculated price's details.
|
||||
* properties:
|
||||
* id:
|
||||
* type: string
|
||||
* title: id
|
||||
* description: The ID of the price.
|
||||
* price_list_id:
|
||||
* type: string
|
||||
* title: price_list_id
|
||||
* description: The ID of the associated price list.
|
||||
* price_list_type:
|
||||
* type: string
|
||||
* title: price_list_type
|
||||
* description: The price list's type. For example, sale.
|
||||
* min_quantity:
|
||||
* type: number
|
||||
* title: min_quantity
|
||||
* description: The minimum quantity required in the cart for this price to apply.
|
||||
* max_quantity:
|
||||
* type: number
|
||||
* title: max_quantity
|
||||
* description: The maximum quantity allowed in the cart for this price to apply.
|
||||
* required:
|
||||
* - id
|
||||
* - price_list_id
|
||||
* - price_list_type
|
||||
* - min_quantity
|
||||
* - max_quantity
|
||||
* original_price:
|
||||
* type: object
|
||||
* description: The original price's details.
|
||||
* properties:
|
||||
* id:
|
||||
* type: string
|
||||
* title: id
|
||||
* description: The ID of the price.
|
||||
* price_list_id:
|
||||
* type: string
|
||||
* title: price_list_id
|
||||
* description: The ID of the associated price list.
|
||||
* price_list_type:
|
||||
* type: string
|
||||
* title: price_list_type
|
||||
* description: The price list's type. For example, sale.
|
||||
* min_quantity:
|
||||
* type: number
|
||||
* title: min_quantity
|
||||
* description: The minimum quantity required in the cart for this price to apply.
|
||||
* max_quantity:
|
||||
* type: number
|
||||
* title: max_quantity
|
||||
* description: The maximum quantity allowed in the cart for this price to apply.
|
||||
* required:
|
||||
* - id
|
||||
* - price_list_id
|
||||
* - price_list_type
|
||||
* - min_quantity
|
||||
* - max_quantity
|
||||
*
|
||||
*/
|
||||
|
||||
@@ -52,7 +52,7 @@
|
||||
* type: object
|
||||
* description: The shipping method's data, useful for fulfillment handling by third-party services.
|
||||
* externalDocs:
|
||||
* url: https://docs.medusajs.com/v2/resources/commerce-modules/cart/concepts#data-property
|
||||
* url: https://docs.medusajs.com/resources/commerce-modules/cart/concepts#data-property
|
||||
* metadata:
|
||||
* type: object
|
||||
* description: The shipping method's metadata, can hold custom key-value pairs.
|
||||
@@ -77,36 +77,36 @@
|
||||
* title: updated_at
|
||||
* description: The date the shipping method was updated.
|
||||
* original_total:
|
||||
* type: string
|
||||
* type: number
|
||||
* title: original_total
|
||||
* description: The shipping method's total including taxes, excluding promotions.
|
||||
* original_subtotal:
|
||||
* type: string
|
||||
* type: number
|
||||
* title: original_subtotal
|
||||
* description: The shipping method's total excluding taxes, including promotions.
|
||||
* original_tax_total:
|
||||
* type: string
|
||||
* type: number
|
||||
* title: original_tax_total
|
||||
* description: The total taxes applied on the shipping method's amount including promotions.
|
||||
* total:
|
||||
* type: string
|
||||
* type: number
|
||||
* title: total
|
||||
* description: The shipping method's total amount including taxes and promotions.
|
||||
* subtotal:
|
||||
* type: string
|
||||
* type: number
|
||||
* title: subtotal
|
||||
* description: The shipping method's total amount excluding taxes, including promotions.
|
||||
* tax_total:
|
||||
* type: string
|
||||
* type: number
|
||||
* title: tax_total
|
||||
* description: The total taxes applied on the shipping method's amount including promotions.
|
||||
* discount_total:
|
||||
* type: string
|
||||
* type: number
|
||||
* title: discount_total
|
||||
* description: The total amount discounted.
|
||||
* discount_tax_total:
|
||||
* type: string
|
||||
* title: discount_total
|
||||
* type: number
|
||||
* title: discount_tax_total
|
||||
* description: The taxes applied on the discounted amount.
|
||||
*
|
||||
*/
|
||||
|
||||
@@ -3,6 +3,14 @@
|
||||
* type: object
|
||||
* description: The adjustment's details.
|
||||
* x-schemaName: BaseLineItemAdjustment
|
||||
* required:
|
||||
* - item
|
||||
* - item_id
|
||||
* - id
|
||||
* - amount
|
||||
* - cart_id
|
||||
* - created_at
|
||||
* - updated_at
|
||||
* properties:
|
||||
* item:
|
||||
* $ref: "#/components/schemas/BaseCartLineItem"
|
||||
@@ -48,14 +56,6 @@
|
||||
* format: date-time
|
||||
* title: updated_at
|
||||
* description: The date the adjustment was updated.
|
||||
* required:
|
||||
* - item
|
||||
* - item_id
|
||||
* - id
|
||||
* - amount
|
||||
* - cart_id
|
||||
* - created_at
|
||||
* - updated_at
|
||||
*
|
||||
*/
|
||||
|
||||
@@ -3,6 +3,16 @@
|
||||
* type: object
|
||||
* description: The tax line's details
|
||||
* x-schemaName: BaseLineItemTaxLine
|
||||
* required:
|
||||
* - item
|
||||
* - item_id
|
||||
* - total
|
||||
* - subtotal
|
||||
* - id
|
||||
* - code
|
||||
* - rate
|
||||
* - created_at
|
||||
* - updated_at
|
||||
* properties:
|
||||
* item:
|
||||
* $ref: "#/components/schemas/BaseCartLineItem"
|
||||
@@ -52,16 +62,6 @@
|
||||
* format: date-time
|
||||
* title: updated_at
|
||||
* description: The date the tax line was updated.
|
||||
* required:
|
||||
* - item
|
||||
* - item_id
|
||||
* - total
|
||||
* - subtotal
|
||||
* - id
|
||||
* - code
|
||||
* - rate
|
||||
* - created_at
|
||||
* - updated_at
|
||||
*
|
||||
*/
|
||||
|
||||
@@ -30,9 +30,14 @@
|
||||
* metadata:
|
||||
* type: object
|
||||
* description: The image's metadata, can hold custom key-value pairs.
|
||||
* rank:
|
||||
* type: number
|
||||
* title: rank
|
||||
* description: The image's rank among its sibling images.
|
||||
* required:
|
||||
* - id
|
||||
* - url
|
||||
* - rank
|
||||
*
|
||||
*/
|
||||
|
||||
@@ -0,0 +1,15 @@
|
||||
/**
|
||||
* @schema StoreAcceptOrderTransfer
|
||||
* type: object
|
||||
* description: The details of accepting the order transfer.
|
||||
* x-schemaName: StoreAcceptOrderTransfer
|
||||
* required:
|
||||
* - token
|
||||
* properties:
|
||||
* token:
|
||||
* type: string
|
||||
* title: token
|
||||
* description: The order transfer's token issued when the transfer was requested.
|
||||
*
|
||||
*/
|
||||
|
||||
@@ -0,0 +1,15 @@
|
||||
/**
|
||||
* @schema StoreDeclineOrderTransferRequest
|
||||
* type: object
|
||||
* description: The details of declining the order transfer request.
|
||||
* x-schemaName: StoreDeclineOrderTransferRequest
|
||||
* required:
|
||||
* - token
|
||||
* properties:
|
||||
* token:
|
||||
* type: string
|
||||
* title: token
|
||||
* description: The order transfer's token issued when the transfer was requested.
|
||||
*
|
||||
*/
|
||||
|
||||
@@ -6,6 +6,7 @@
|
||||
* required:
|
||||
* - id
|
||||
* - url
|
||||
* - rank
|
||||
* properties:
|
||||
* id:
|
||||
* type: string
|
||||
@@ -33,6 +34,10 @@
|
||||
* metadata:
|
||||
* type: object
|
||||
* description: The image's metadata, can hold custom key-value pairs.
|
||||
* rank:
|
||||
* type: number
|
||||
* title: rank
|
||||
* description: The image's rank among its sibling images
|
||||
*
|
||||
*/
|
||||
|
||||
@@ -0,0 +1,13 @@
|
||||
/**
|
||||
* @schema StoreRequestOrderTransfer
|
||||
* type: object
|
||||
* description: The details of requesting the order transfer.
|
||||
* x-schemaName: StoreRequestOrderTransfer
|
||||
* properties:
|
||||
* description:
|
||||
* type: string
|
||||
* title: description
|
||||
* description: The transfer's description, which can be shown to the other customer receiving the request.
|
||||
*
|
||||
*/
|
||||
|
||||
Reference in new issue
Block a user