Skip to main content

Update Pricing Tier

PUT 
/api/product-pricing-tiers/:product_pricing_tier

Update an existing product pricing tier. currency_code cannot be changed on update.

Required scope: products:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Authentication: Requires Bearer token.

Request body fields (all optional on update):

  • name (string, max:255, unique)
  • pricing_type — absolute or relative
  • base_pricing_tier_id (nullable integer) — required if pricing_type=relative
  • adjustment_percentage (nullable numeric, -99.9999 to 999.9999) — required if pricing_type=relative
  • adjustment_fixed_amount (nullable numeric)
  • rounding_value (nullable numeric, gt:0)

Relative tiers (pricing_type=relative) require relative_basis, one of:

  • pricing_tier — derive from another tier's price. Requires base_pricing_tier_id + adjustment_percentage.
  • supplier_pricing_tier — cost-plus from the product's primary supplier cost. Optional base_supplier_pricing_tier_id (defaults to the default supplier tier) + adjustment_percentage.
  • attribute — derive from a numeric/integer product attribute: value × attr_rate + attr_offset. Requires base_attribute_id + attr_rate (optional attr_offset).

rounding_value and adjustment_fixed_amount apply to every basis. Supplier/pricing-tier bases inherit currency from their source; attribute basis uses currency_code.

Requires permission: pricing_tiers.update

Request​

Responses​

OK

Response Headers
    Content-Type