POST

Bulk Update Inventory Items


Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Updates multiple inventory items.

Each time an inventory item is updated, revision increments by 1. The current revision must be passed when updating an inventory item. This ensures you're working with the latest inventory item and prevents unintended overwrites.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage Stores - all permissions
Manage Products
Manage Restaurants - all permissions
Manage v3 catalog
Inventory write in v3 catalog
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/stores/v3/bulk/inventory-items/update

Body Params
inventoryItemsArray <MaskedInventoryItem>RequiredminItems 1maxItems 1000

Inventory items to update.


returnEntityboolean

Whether to return the full inventory item entities in the response.

Default: false


reasonstring

Reason for update.

Response Object
resultsArray <BulkInventoryItemResult>minItems 1maxItems 1000

Inventory items updated by bulk action.


bulkActionMetadataBulkActionMetadata

Bulk action metadata.

Bulk Update inventory items example - minimum required fields

Bulk Update inventory items associated with product, variant, and location.

Request
cURL
Response
JSON
Errors
428Failed Precondition

There are 2 errors with this status code.

This method may also return standard errors. Learn more about standard Wix errors.

Did this help?