propose_write

Propose a percentage discount across one or more products. Returns a plan-card row the user must review and approve befo

Propose a percentage discount across one or more products. Returns a plan-card row the user must review and approve before any Shopify write occurs. Never executes the discount directly.

post/api/v1/tools/propose_discount

Request

  • Base URL: https://app.magistry.io
  • URL: https://app.magistry.io/api/v1/tools/propose_discount
  • 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: promotions:write)

Request body

product_idsstring[] required

UUIDs of the products to discount.

discount_percentnumber required

Percentage to discount (e.g. 20 = 20% off).

reasonstring required

Human-readable reason for this proposed discount.

Response

Tool result

okboolean required
resultunknown required

Changes

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