propose_write

Set available inventory for a product’s variants at the primary location. `option_qty` maps a variant’s option values (j

Set available inventory for a product’s variants at the primary location. option_qty maps a variant’s option values (joined by "/", e.g. "Brown/10") to a quantity. Approval/auto-apply gated.

post/api/v1/tools/shopify_update_inventory

Request

  • Base URL: https://app.magistry.io
  • URL: https://app.magistry.io/api/v1/tools/shopify_update_inventory
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.magistry.io/api/oauth/authorize, token URL https://app.magistry.io/api/oauth/token, scopes: catalog:write)

Request body

shopify_product_idinteger required
option_qtyobject required

Map of "Opt1/Opt2" → quantity. Single-option variants use just the value.

expected_option_qtyobject

Same keys: the available quantity you read before proposing. Sent as the compare side, so if stock moved before the write runs (a sale while this waits for approval) the write is refused instead of overwriting it. Omit only when you did not read it.

Response

Tool result

okboolean required
resultunknown required

Changes

No recorded changes to this operation across all 3 revisions of this API.