Skip to main content
PUT
/
components
/
v1
/
offer-design
/
{externalId}
curl -X PUT \
  'https://api.appcharge.com/components/v1/offer-design/reward-calendar-design-1' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'x-publisher-token: <x-publisher-token>' \
  --data '{
    "offerUiType": "PopUp",
    "offerUiSubType": "RewardCalendar",
    "name": "Updated Reward Calendar Design",
    "externalId": "reward-calendar-design-1",
    "backgroundImageUrl": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/reward-calendar-background-v2.png",
    "rewardCalendar": {
      "collectibleBadgeImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/collectible-badge-v2.png",
      "lockedBadgeImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/locked-badge-v2.png",
      "backgroundColor": "#111832",
      "collectIconImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/collect-icon-v2.png",
      "lockedIconImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/locked-icon-v2.png",
      "dayFontColor": "#FFFFFF",
      "headerImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/header.png"
    }
  }'

{
  "id": "68d2b9cf7a8b4d2f1b8e0a31",
  "offerUiType": "PopUp",
  "offerUiSubType": "RewardCalendar",
  "name": "Updated Reward Calendar Design",
  "externalId": "reward-calendar-design-1",
  "backgroundImageUrl": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/reward-calendar-background-v2.png",
  "rewardCalendar": {
    "collectibleBadgeImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/collectible-badge-v2.png",
    "lockedBadgeImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/locked-badge-v2.png",
    "backgroundColor": "#111832",
    "collectIconImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/collect-icon-v2.png",
    "lockedIconImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/locked-icon-v2.png",
    "dayFontColor": "#FFFFFF",
    "headerImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/header.png",
  }
}

curl -X PUT \
  'https://api.appcharge.com/components/v1/offer-design/reward-calendar-design-1' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'x-publisher-token: <x-publisher-token>' \
  --data '{
    "offerUiType": "PopUp",
    "offerUiSubType": "RewardCalendar",
    "name": "Updated Reward Calendar Design",
    "externalId": "reward-calendar-design-1",
    "backgroundImageUrl": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/reward-calendar-background-v2.png",
    "rewardCalendar": {
      "collectibleBadgeImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/collectible-badge-v2.png",
      "lockedBadgeImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/locked-badge-v2.png",
      "backgroundColor": "#111832",
      "collectIconImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/collect-icon-v2.png",
      "lockedIconImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/locked-icon-v2.png",
      "dayFontColor": "#FFFFFF",
      "headerImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/header.png"
    }
  }'

{
  "id": "68d2b9cf7a8b4d2f1b8e0a31",
  "offerUiType": "PopUp",
  "offerUiSubType": "RewardCalendar",
  "name": "Updated Reward Calendar Design",
  "externalId": "reward-calendar-design-1",
  "backgroundImageUrl": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/reward-calendar-background-v2.png",
  "rewardCalendar": {
    "collectibleBadgeImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/collectible-badge-v2.png",
    "lockedBadgeImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/locked-badge-v2.png",
    "backgroundColor": "#111832",
    "collectIconImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/collect-icon-v2.png",
    "lockedIconImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/locked-icon-v2.png",
    "dayFontColor": "#FFFFFF",
    "headerImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/header.png",
  }
}

Authorizations

​
x-publisher-token
string
header
required

Publisher token, as displayed in the Publisher Dashboard.

Path Parameters

​
externalId
string
required

Offer design ID that you defined.

Body

application/json

Updates a reward calendar design.

​
offerUiType
enum<string>

Type of offer design.

Available options:
PopUp
Example:

"PopUp"

​
offerUiSubType
enum<string>

Offer subtype.

Available options:
RewardCalendar
Example:

"RewardCalendar"

​
name
string

Offer design name.

Example:

"Weekly Reward Calendar"

​
externalId
string

Offer design ID that you define.

Example:

"reward-calendar-ui"

​
backgroundImageUrl
string<url>

Background image URL in PNG or JPEG format.

For uploaded files, this is the Appcharge-hosted CDN URL. For external image URLs, this is the original image URL served from the provided URL. External image URLs are saved and used as-is, and Appcharge doesn't download, copy, upload, or host them. Images must remain available at the provided URLs.

We recommend uploading image files instead of using external URLs when possible.

Example:

"https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/reward-calendar-background.png"

​
rewardCalendar
object

Information about the reward calendar design.

Response

Offer design updated successfully.

​
id
string

Offer design ID.

Example:

"68d2b9cf7a8b4d2f1b8e0a31"

​
offerUiType
enum<string>

Type of offer design.

Available options:
PopUp
Example:

"PopUp"

​
offerUiSubType
enum<string>

Offer subtype.

Available options:
RewardCalendar
Example:

"RewardCalendar"

​
name
string

Offer design name.

Example:

"Weekly Reward Calendar"

​
externalId
string

Offer design ID that you defined.

Example:

"reward-calendar-ui"

​
backgroundImageUrl
string<url>

Background image URL. For uploaded files, this is the Appcharge-hosted CDN URL. For external image URLs, this is the original image URL served from the provided URL.

Example:

"https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/reward-calendar-background.png"

​
externalBackgroundImageUrl
string<url>

Original background image URL when the design uses an external image URL. This URL is used as provided to serve the image.

Example:

"https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/reward-calendar-background.png"

​
rewardCalendar
object

Information about the reward calendar design.