Update Master of Stock for a Source
PATCH/api/magento2/integration-instances/:magento2IntegrationInstance/inventory-sources/:sourceCode/master-of-stock
Update the Master of Stock direction for a single Magento MSI source.
Per the sales-channel standard §7.10, Master of Stock lives per-location (per MSI source for Magento 2), not as a single global value on the integration instance.
Authentication: Requires Bearer token.
Request body:
master_of_stock(string, required) — one ofsku.io,magento2,disabled.sku.io— SKU.io pushes on-hand to this Magento source on a schedule.magento2— RESERVED. Magento→SKU.io direction is not implemented yet; the UI exposes it as a disabled "(contact support)" option.disabled— no automatic sync for this source.
Responses:
200 OK— returns{ data: { source_code, master_of_stock } }.404 Not Found— the MSI source is not cached for this instance. Refresh sources on Settings → Locations first.422 Unprocessable Entity—master_of_stockmissing or not one of the allowed values.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not Found
Response Headers
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.