Skip to main content
POST
Set Inventory Level

Set Inventory Level

Sets the stock for an inventory item to an absolute value. Unlike adjust, this sets the exact quantity rather than adding or subtracting.

Request

Body Parameters

inventory_item_id
string
required
The inventory item ID to update — a variant UUID (varientId) or a product ID. The variant’s stock is updated first; if no variant matches, the product-level stock is set as a fallback.
available
integer
required
The absolute available quantity to set (must be >= 0)

Response

Responses use the standard platform envelope: status, type, and a data object containing the updated inventory_level.
status
integer
HTTP status code (200 on success)
type
string
"success" or "error"
data
object
Wrapper for the updated inventory level

Example Response

Use Cases

ScenarioEndpoint to Use
Physical count reconciliationset - Set to exact counted value
Receiving shipmentadjust - Add received quantity
Damaged goodsadjust - Subtract damaged quantity
LaunchMyStore tracks a single stock value per variant (with a product-level fallback) — there is no per-location inventory model. Inventory is set or adjusted on the item directly, so there are no location connect/disconnect operations.

Error Responses

StatustypeWhen
400errorMissing inventory_item_id or available, or available < 0
401errorInvalid or missing access token
403errorApp doesn’t have the write_inventory scope
404errorNo variant or product matched inventory_item_id for this store