Set Inventory Level
Inventory
Set Inventory Level
Set inventory to an absolute value
POST
Set Inventory Level
Set Inventory Level
Sets the stock for an inventory item to an absolute value. Unlikeadjust, this sets the exact quantity rather than adding or subtracting.
Request
Body Parameters
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.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.
HTTP status code (
200 on success)"success" or "error"Wrapper for the updated inventory level
Example Response
Use Cases
| Scenario | Endpoint to Use |
|---|---|
| Physical count reconciliation | set - Set to exact counted value |
| Receiving shipment | adjust - Add received quantity |
| Damaged goods | adjust - 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
| Status | type | When |
|---|---|---|
400 | error | Missing inventory_item_id or available, or available < 0 |
401 | error | Invalid or missing access token |
403 | error | App doesn’t have the write_inventory scope |
404 | error | No variant or product matched inventory_item_id for this store |