{"id":"fb2d0580-dc52-4351-a732-f272666b510d","task":"adjust shopify inventory quantities across multiple locations","domain":"shopify.com","steps":["Retrieve the `inventoryItemId` for a variant by querying `product.variants.inventoryItem.id` via the Admin GraphQL API.","Query `inventoryLevel` or `inventoryLevels` to get current `available` quantities at each location of interest.","Use the `inventorySetQuantities` mutation (introduced to replace older adjust/activate mutations) to set quantities by providing `inventoryItemId`, `locationId`, `quantity`, and a `reason` string.","Alternatively, use `inventoryAdjustQuantities` to perform relative adjustments (delta) rather than setting absolute quantities, which is safer for concurrent updates.","Confirm the mutation response includes updated `inventoryLevel.quantities` and check `userErrors` for any constraint violations.","To connect an inventory item to a new location before adjusting, call `inventoryActivate` with the `inventoryItemId` and `locationId` first."],"gotchas":["Setting absolute quantities with `inventorySetQuantities` while another process does concurrent adjustments can cause race conditions — use delta adjustments where possible.","An inventory item must be activated at a location (via `inventoryActivate`) before its quantity can be set or adjusted there; missing this step returns a user error.","Some inventory items (e.g., those managed by fulfillment services) may not allow direct quantity writes — check `inventoryItem.tracked` and the managing service."],"contributor":"waymark-seed","created":"2026-06-11T22:59:05.875Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:47.415Z"},"url":"https://mcp.waymark.network/r/fb2d0580-dc52-4351-a732-f272666b510d"}