Update Multiple Inventory Items

Updates multiple inventory items in a single request. This consumes a single rate limit token rather than one token per item.

Each inventory item must include an id field so the correct record can be properly updated.

All fields should be passed through. Any empty fields will be set to blank on the record.

Legacy clients that cannot issue PUT can send POST with the X-HTTP-Method-Override: PUT header.

put

Authorizations

ORDERDESK-API-KEYstringRequired

Your API key, found under Store Settings on the API tab. This should be kept server-side.

ORDERDESK-STORE-IDstringRequired

Your store ID, found under Store Settings on the API tab.

Bodyall of[]

idintegerRequired

Each inventory item must include an id field so the correct record can be properly updated.

Example: 100009

namestringOptionalExample: ODU Campus Hoodie

codestringOptional

Product's unique SKU. This is how Order Desk matches an order line to an inventory record, so it must match the code that your orders arrive with.

Example: ODU-HOOD-NVY-L

pricenumber · doubleOptionalExample: 19

costnumber · doubleOptional

Item cost in decimal format.

Example: 7.25

weightnumber · doubleOptional

The shipping weight of the item.

Example: 1.2

stockintegerOptional

The number of available units.

Example: 52

Other propertiesanyOptional

Other propertiesanyOptional

manufacturer_skustringOptional

The SKU used by the manufacturer. This can be used as print_sku.

Example: GT5000

locationstringOptional

Warehouse or fulfillment method responsible for the item.

Example: Main Warehouse

update_sourcestringOptional

The name of the last system to update the item's details. Setting this allows those updates to be excluded later using the update_source_not search parameter.

Example: Warehouse Sync

Responses

200

The items were updated.

application/json

statusstring · enumRequired

Either success or error.

Possible values:

messagestringOptional

Describes the result. Always present when an error occurs.

execution_timestringOptional

Time taken to process the request.

Example: 0.1524 seconds

400

The request was rejected. message names the problem.

application/json

401

Authentication failed. See the Authentication guide, and note that an invalid store ID blocks your store rather than simply failing the request.

application/json

429

You are sending too fast. Wait X-Retry-After seconds. See the Rate Limits guide.

application/json

default

The request could not be completed.

application/json

put/batch-inventory-items

curl "https://app.orderdesk.me/api/v2/batch-inventory-items" \
  -X PUT \
  -H "ORDERDESK-STORE-ID: your-store-id" \
  -H "ORDERDESK-API-KEY: your-api-key" \
  -H "Content-Type: application/json" \
  -d '[{"id": 100009, "name": "ODU Campus Hoodie", "code": "ODU-HOOD-NVY-L", "price": 11, "stock": 52, "manufacturer_sku": "GT5000", "variation_list": {"Size": "Large", "Color": "Red"}, "metadata": {"image": "https://example.com/odu-hoodie.jpg", "print_sku": "x533"}}, {"id": 10011, "name": "ODU Ceramic Mug", "code": "ODU-MUG-12OZ", "price": 12, "stock": 19}]'

{
  "status": "success",
  "message": "Inventory Item Updated",
  "execution_time": "0.1420 seconds"
}