Update Product Variant's Inventory Details

cURL

curl -X POST '{backend_url}/admin/products/{id}/variants/{variant_id}/inventory-items/{inventory_item_id}' \
-H 'Authorization: Bearer {jwt_token}' \
-H 'Content-Type: application/json' \
--data-raw '{
  "required_quantity": 5324804697620480
}'

{
  "variant": {
    "prices": [
      {
        "id": "<string>",
        "title": "<string>",
        "currency_code": "usd",
        "amount": 123,
        "raw_amount": {},
        "min_quantity": 123,
        "max_quantity": 123,
        "price_set_id": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "deleted_at": "2023-11-07T05:31:56Z"
      }
    ],
    "id": "<string>",
    "title": "<string>",
    "sku": "<string>",
    "barcode": "<string>",
    "ean": "<string>",
    "upc": "<string>",
    "allow_backorder": true,
    "manage_inventory": true,
    "hs_code": "<string>",
    "origin_country": "<string>",
    "mid_code": "<string>",
    "material": "<string>",
    "weight": 123,
    "length": 123,
    "height": 123,
    "width": 123,
    "options": [
      {
        "id": "<string>",
        "value": "<string>",
        "option": {
          "id": "<string>",
          "title": "<string>",
          "product": {},
          "product_id": "<string>",
          "values": [
            {}
          ],
          "metadata": {},
          "created_at": "2023-11-07T05:31:56Z",
          "updated_at": "2023-11-07T05:31:56Z",
          "deleted_at": "2023-11-07T05:31:56Z"
        },
        "option_id": "<string>",
        "metadata": {},
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "deleted_at": "2023-11-07T05:31:56Z"
      }
    ],
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "deleted_at": "2023-11-07T05:31:56Z",
    "images": [
      {
        "id": "<string>",
        "url": "<string>",
        "rank": 123,
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "deleted_at": "2023-11-07T05:31:56Z",
        "metadata": {}
      }
    ],
    "thumbnail": "<string>",
    "inventory_quantity": 123,
    "variant_rank": 123,
    "product": {},
    "product_id": "<string>",
    "calculated_price": {
      "id": "<string>",
      "calculated_amount": 123,
      "original_amount": 123,
      "currency_code": "usd",
      "original_amount_with_tax": 123,
      "original_amount_without_tax": 123,
      "is_calculated_price_price_list": true,
      "is_calculated_price_tax_inclusive": true,
      "calculated_amount_with_tax": 123,
      "calculated_amount_without_tax": 123,
      "is_original_price_price_list": true,
      "is_original_price_tax_inclusive": true,
      "calculated_price": {},
      "original_price": {}
    },
    "metadata": {},
    "inventory_items": [
      {
        "id": "<string>",
        "variant_id": "<string>",
        "inventory_item_id": "<string>",
        "variant": {},
        "inventory": {
          "id": "<string>",
          "requires_shipping": true,
          "sku": "<string>",
          "origin_country": "<string>",
          "hs_code": "<string>",
          "mid_code": "<string>",
          "material": "<string>",
          "weight": 123,
          "length": 123,
          "height": 123,
          "width": 123,
          "title": "<string>",
          "description": "<string>",
          "thumbnail": "<string>",
          "metadata": {},
          "location_levels": [
            {
              "id": "<string>",
              "created_at": "2023-11-07T05:31:56Z",
              "updated_at": "2023-11-07T05:31:56Z",
              "deleted_at": "2023-11-07T05:31:56Z",
              "inventory_item_id": "<string>",
              "location_id": "<string>",
              "stocked_quantity": 123,
              "reserved_quantity": 123,
              "incoming_quantity": 123,
              "metadata": {},
              "available_quantity": 123,
              "inventory_item": {}
            }
          ]
        },
        "required_quantity": 123
      }
    ]
  }
}

POST

admin

products

{id}

variants

{variant_id}

inventory-items

{inventory_item_id}

cURL

curl -X POST '{backend_url}/admin/products/{id}/variants/{variant_id}/inventory-items/{inventory_item_id}' \
-H 'Authorization: Bearer {jwt_token}' \
-H 'Content-Type: application/json' \
--data-raw '{
  "required_quantity": 5324804697620480
}'

{
  "variant": {
    "prices": [
      {
        "id": "<string>",
        "title": "<string>",
        "currency_code": "usd",
        "amount": 123,
        "raw_amount": {},
        "min_quantity": 123,
        "max_quantity": 123,
        "price_set_id": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "deleted_at": "2023-11-07T05:31:56Z"
      }
    ],
    "id": "<string>",
    "title": "<string>",
    "sku": "<string>",
    "barcode": "<string>",
    "ean": "<string>",
    "upc": "<string>",
    "allow_backorder": true,
    "manage_inventory": true,
    "hs_code": "<string>",
    "origin_country": "<string>",
    "mid_code": "<string>",
    "material": "<string>",
    "weight": 123,
    "length": 123,
    "height": 123,
    "width": 123,
    "options": [
      {
        "id": "<string>",
        "value": "<string>",
        "option": {
          "id": "<string>",
          "title": "<string>",
          "product": {},
          "product_id": "<string>",
          "values": [
            {}
          ],
          "metadata": {},
          "created_at": "2023-11-07T05:31:56Z",
          "updated_at": "2023-11-07T05:31:56Z",
          "deleted_at": "2023-11-07T05:31:56Z"
        },
        "option_id": "<string>",
        "metadata": {},
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "deleted_at": "2023-11-07T05:31:56Z"
      }
    ],
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "deleted_at": "2023-11-07T05:31:56Z",
    "images": [
      {
        "id": "<string>",
        "url": "<string>",
        "rank": 123,
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "deleted_at": "2023-11-07T05:31:56Z",
        "metadata": {}
      }
    ],
    "thumbnail": "<string>",
    "inventory_quantity": 123,
    "variant_rank": 123,
    "product": {},
    "product_id": "<string>",
    "calculated_price": {
      "id": "<string>",
      "calculated_amount": 123,
      "original_amount": 123,
      "currency_code": "usd",
      "original_amount_with_tax": 123,
      "original_amount_without_tax": 123,
      "is_calculated_price_price_list": true,
      "is_calculated_price_tax_inclusive": true,
      "calculated_amount_with_tax": 123,
      "calculated_amount_without_tax": 123,
      "is_original_price_price_list": true,
      "is_original_price_tax_inclusive": true,
      "calculated_price": {},
      "original_price": {}
    },
    "metadata": {},
    "inventory_items": [
      {
        "id": "<string>",
        "variant_id": "<string>",
        "inventory_item_id": "<string>",
        "variant": {},
        "inventory": {
          "id": "<string>",
          "requires_shipping": true,
          "sku": "<string>",
          "origin_country": "<string>",
          "hs_code": "<string>",
          "mid_code": "<string>",
          "material": "<string>",
          "weight": 123,
          "length": 123,
          "height": 123,
          "width": 123,
          "title": "<string>",
          "description": "<string>",
          "thumbnail": "<string>",
          "metadata": {},
          "location_levels": [
            {
              "id": "<string>",
              "created_at": "2023-11-07T05:31:56Z",
              "updated_at": "2023-11-07T05:31:56Z",
              "deleted_at": "2023-11-07T05:31:56Z",
              "inventory_item_id": "<string>",
              "location_id": "<string>",
              "stocked_quantity": 123,
              "reserved_quantity": 123,
              "incoming_quantity": 123,
              "metadata": {},
              "available_quantity": 123,
              "inventory_item": {}
            }
          ]
        },
        "required_quantity": 123
      }
    ]
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

The product's ID.

variant_id

string

required

The variant's ID.

inventory_item_id

string

required

The inventory item's ID.

Query Parameters

fields

string

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.

Body

application/json

The properties to update of the variant's inventory item association.

required_quantity

number

required

The number of units a single quantity is equivalent to. For example, if a customer orders one quantity of the variant, Medusa checks the availability of the quantity multiplied by the value set for required_quantity. When the customer orders the quantity, Medusa reserves the ordered quantity multiplied by the value set for required_quantity.

Response

The product variant's details.

variant

object

required

The product variant's details.

Show child attributes

variant.prices

object[]

required

The variant's prices.

Show child attributes

variant.prices.id

string

required

The price's ID.

variant.prices.title

string

required

The price's title.

variant.prices.currency_code

string

required

The price's currency code.

Example:

"usd"

variant.prices.amount

number

required

The price's amount.

variant.prices.raw_amount

object

required

The price's raw amount.

variant.prices.min_quantity

number

required

The minimum quantity that must be available in the cart for the price to be applied.

variant.prices.max_quantity

number

required

The maximum quantity allowed to be available in the cart for the price to be applied.

variant.prices.price_set_id

string

required

The ID of the associated price set.

variant.prices.created_at

string<date-time>

required

The date the price was created.

variant.prices.updated_at

string<date-time>

required

The date the price was updated.

variant.prices.deleted_at

string<date-time>

required

The date the price was deleted.

variant.id

string

required

The variant's ID.

variant.title

string

required

The variant's title.

variant.sku

string

required

The variant's SKU.

variant.barcode

string

required

The variant's barcode.

variant.ean

string

required

The variant's EAN code.

variant.upc

string

required

The variant's UPC.

variant.allow_backorder

boolean

required

Whether the variant can be ordered even if it's out of stock.

variant.manage_inventory

boolean

required

Whether the Medusa application manages the variant's inventory quantity and availablility. If disabled, the variant is always considered in stock.

variant.hs_code

string

required

The variant's HS code.

variant.origin_country

string

required

The variant's origin country.

variant.mid_code

string

required

The variant's MID code.

variant.material

string

required

The variant's material.

variant.weight

number

required

The variant's weight.

variant.length

number

required

The variant's length.

variant.height

number

required

The variant's height.

variant.width

number

required

The variant's width.

variant.options

object[]

required

The variant's option values.

Show child attributes

variant.options.id

string

required

The value's ID.

variant.options.value

string

required

The value.

variant.options.option

object

The product option's details.

Show child attributes

variant.options.option.id

string

required

The product option's ID.

variant.options.option.title

string

required

The product option's title.

variant.options.option.product

object

variant.options.option.product_id

string

The ID of the product this option belongs to.

variant.options.option.values

object[]

The product option's values.

variant.options.option.metadata

object

The product option's metadata, can hold custom key-value pairs.

variant.options.option.created_at

string<date-time>

The date the product option was created.

variant.options.option.updated_at

string<date-time>

The date the product option was updated.

variant.options.option.deleted_at

string<date-time>

The date the product option was deleted.

variant.options.option_id

string

The ID of the option this value belongs to.

variant.options.metadata

object

The value's metadata, can hold custom key-value pairs.

variant.options.created_at

string<date-time>

The date the value was created.

variant.options.updated_at

string<date-time>

The date the value was updated.

variant.options.deleted_at

string<date-time>

The date the value was deleted.

variant.created_at

string<date-time>

required

The date the variant was created.

variant.updated_at

string<date-time>

required

The date the variant was updated.

variant.deleted_at

string<date-time>

required

The date the variant was deleted.

variant.images

object[]

required

The variant's images.

Show child attributes

variant.images.id

string

required

The image's ID.

variant.images.url

string

required

The image's URL.

variant.images.rank

number

required

The image's rank among its sibling images.

variant.images.created_at

string<date-time>

The date the image was created.

variant.images.updated_at

string<date-time>

The date the image was updated.

variant.images.deleted_at

string<date-time>

The date the image was deleted.

variant.images.metadata

object

The image's metadata, can hold custom key-value pairs.

variant.thumbnail

string

required

The variant's thumbnail.

variant.inventory_quantity

number

The variant's inventory quantity. This is only included if you pass in the fields query parameter a +variants.inventory_quantity parameter.

variant.variant_rank

number

The variant's rank among its sibling variants.

variant.product

object

variant.product_id

string

The ID of the product that the variant belongs to.

variant.calculated_price

object

The calculated price's details.

Show child attributes

variant.calculated_price.id

string

required

The calculated price's ID.

variant.calculated_price.calculated_amount

number

required

The amount of the calculated price, or null if there isn't a calculated price. This is the amount shown to the customer.

variant.calculated_price.original_amount

number

required

The amount of the original price, or null if there isn't an original price. This amount is useful to compare with the calculated_amount, such as to check for discounted value.

variant.calculated_price.currency_code

string

required

The calculated price's currency code.

Example:

"usd"

variant.calculated_price.original_amount_with_tax

number

required

The amount of the original price with taxes applied.

variant.calculated_price.original_amount_without_tax

number

required

The amount of the original price without taxes.

variant.calculated_price.is_calculated_price_price_list

boolean

Whether the calculated price belongs to a price list.

variant.calculated_price.is_calculated_price_tax_inclusive

boolean

Whether the calculated price is tax inclusive.

variant.calculated_price.calculated_amount_with_tax

number

The calculated price's amount with taxes applied.

variant.calculated_price.calculated_amount_without_tax

number

The calculated price's amount without taxes applied.

variant.calculated_price.is_original_price_price_list

boolean

Whether the original price belongs to a price list.

variant.calculated_price.is_original_price_tax_inclusive

boolean

Whether the original price is tax inclusive.

variant.calculated_price.calculated_price

object

The calculated price's details.

variant.calculated_price.original_price

object

The original price's details.

variant.metadata

object

The variant's metadata, can hold custom key-value pairs.

variant.inventory_items

object[]

The variant's inventory items.

Show child attributes

variant.inventory_items.id

string

required

The ID of the association.

variant.inventory_items.variant_id

string

required

The associated product variant's ID.

variant.inventory_items.inventory_item_id

string

required

The associated inventory item's ID.

variant.inventory_items.variant

object

variant.inventory_items.inventory

object

The inventory item's details.

Show child attributes

variant.inventory_items.inventory.id

string

required

The inventory item's ID.

variant.inventory_items.inventory.requires_shipping

boolean

required

Whether the inventory item requires shipping.

variant.inventory_items.inventory.sku

string

The inventory item's sku.

variant.inventory_items.inventory.origin_country

string

The inventory item's origin country.

variant.inventory_items.inventory.hs_code

string

The inventory item's HS code.

variant.inventory_items.inventory.mid_code

string

The inventory item's MID code.

variant.inventory_items.inventory.material

string

The inventory item's material.

variant.inventory_items.inventory.weight

number

The inventory item's weight.

variant.inventory_items.inventory.length

number

The inventory item's length.

variant.inventory_items.inventory.height

number

The inventory item's height.

variant.inventory_items.inventory.width

number

The inventory item's width.

variant.inventory_items.inventory.title

string

The inventory item's title.

variant.inventory_items.inventory.description

string

The inventory item's description.

variant.inventory_items.inventory.thumbnail

string

The thumbnail URL of the inventory item.

variant.inventory_items.inventory.metadata

object

Custom key-value pairs, used to store additional information about the inventory item.

variant.inventory_items.inventory.location_levels

object[]

The inventory item's location levels.

Show child attributes

variant.inventory_items.inventory.location_levels.id

string

required

The location level's ID.

variant.inventory_items.inventory.location_levels.created_at

string<date-time>

required

The location level's created at.

variant.inventory_items.inventory.location_levels.updated_at

string<date-time>

required

The location level's updated at.

variant.inventory_items.inventory.location_levels.deleted_at

string<date-time>

required

The location level's deleted at.

variant.inventory_items.inventory.location_levels.inventory_item_id

string

required

The location level's inventory item id.

variant.inventory_items.inventory.location_levels.location_id

string

required

The location level's location id.

variant.inventory_items.inventory.location_levels.stocked_quantity

number

required

The location level's stocked quantity.

variant.inventory_items.inventory.location_levels.reserved_quantity

number

required

The location level's reserved quantity.

variant.inventory_items.inventory.location_levels.incoming_quantity

number

required

The location level's incoming quantity.

variant.inventory_items.inventory.location_levels.metadata

object

required

The location level's metadata.

variant.inventory_items.inventory.location_levels.available_quantity

number

required

The location level's available quantity.

variant.inventory_items.inventory.location_levels.inventory_item

object

variant.inventory_items.required_quantity

number

The inventory item's required quantity.

Associate Variant with Inventory Item

Remove Inventory Item Association with Product Variant

⌘I

Overview

Scanner API

Admin API

Update Product Variant's Inventory Details

Authorizations

Path Parameters

Query Parameters

Body

Response