BAbagisto
Admin Marketing: Promotions

Update a catalog rule

Partial update — send only the fields you change. channels + customer_groups, when supplied, fully replace the current pivots.

put/marketing/catalog-rules/{id}

Request

Path parameters

idstring required

Marketing catalog rule ID

Request body

namestring
descriptionstring
channelsinteger[]
customer_groupsinteger[]
condition_type1 | 2
conditionsobject[]
end_other_rules0 | 1
action_type'by_percent' | 'by_fixed'
discount_amountnumber
sort_orderinteger
starts_fromstring
ends_tillstring
status0 | 1

Example request

{
  "name": "Summer 15% off",
  "description": "Updated description",
  "channels": [
    1
  ],
  "customer_groups": [
    1,
    2
  ],
  "condition_type": 1,
  "conditions": [
    {
      "attribute": "product|category_ids",
      "operator": "{}",
      "value": "5",
      "attribute_type": "select"
    }
  ],
  "action_type": "by_percent",
  "discount_amount": 15,
  "starts_from": "2026-06-01",
  "ends_till": "2026-08-31",
  "status": 1
}

Response

Catalog rule updated; returns the updated detail.

Changes

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