This API is used to update catalog promotion and link/de-link to a reward(s)

Expired: Do not allow any of the fields to be edited.

Running:

1. Cannot change: start date, discount_type, discount_value.
2. Can change (impacts rewards discounted points)

end date: end date >= now and end date >= start date.

isEnabled - Disable but cannot enable again. After disabling, the linked reward can be linked to another active promotion. Re-enabling will violate the constraint of only one reward linked to an active promotion.

Linking a reward - update the link table accordingly.

Unlinking a reward - Set isActive = false in the link table.

3. Can change other details of the promotion (name, desc….etc)

Scheduled: Similar to running but start_date, discount_type, discount_value fields also can be updated.

Cannot delete a promotion similar to a reward.

👍

Note

For detailed information about our APIs and for hands-on testing, refer documentation in API overview and step-by-step guide on making your first API call in Make your first API call.

Example request

curl --location --request PUT 'https://eu.api.capillarytech.com/api_gateway/rewards/core/v1/promotion/14862/brand/61' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'accept: application/json' \
--header 'Authorization: Basic bWFkaHV2YQ==' \
--header 'Cookie: _cfuvid=qrR26fiL9O7hSaVDD64eltEicRcuyxTkMuk2MPS2moc-1764581884487-0.0.1.1-604800000' \
--data '
{
  "startTime": "2025-12-04T10:08:00.000Z",
  "endTime": "2025-12-14T06:10:00.000Z",
  "discountType": "PERCENTAGE",
  "discountValue": 20,
  "brandId": "61",
  "languageSpecificInfo": [
    {
      "languageCode": "en",
      "name": 72738382,
      "description": 7273838,
      "enabled": true
    }  
  ],
  "rewardIds": [
    496584
  ]
}
'

Prerequisites

• Authentication: Basic or OAuth authentication
• Default access group

Resource information

Request path parameters

Request body parameters

Example response

{
    "status": {
        "success": true,
        "code": 11021,
        "message": "Catalog promotion updated successfully."
    },
    "catalogPromotion": {
        "id": 14862
    },
    "failedRewards": []
}

Response parameters

{
   "status": {
       "success": true,
       "code": 11021,
       "message": "Catalog promotion updated successfully."
   },
   "catalogPromotion": {
       "id": 8
   },
   "failedRewards": []
}

Error codes