Edit a Promotion

You can update an existing Promotion through the Aptoide Connect Developer Console or programmatically via this API endpoint.

Endpoint

Method	URL
PATCH	https://ws.catappult.io/api/promotions/{uid}

Authentication

To access this API, you need to have an active account subscription on Aptoide Connect and authenticate with an API key (check here how to generate one).

⚠️

Account type required

Promotions can only be created, edited, or deleted by accounts of type Partner.

Headers

Header	Type	Required	Description
Api-Key	string	Required	Used to authenticate your API requests. The value is your Aptoide Connect API key.

Path Parameters

Parameter	Type	Description
uid	string	The unique identifier (UUID) of the promotion (e.g. 9dbf70ff-30a4-4d82-b062-42ab24126e59).

Body Parameters

All body parameters are optional — only the fields you include in the request will be updated. The endpoint accepts either application/json or multipart/form-data.

Parameter	Type	Description
name	string	Updates the promotion's display name.
description	string	Updates the free-text description of the promotion.
eventUid	string	Links this promotion to an existing Event by UUID. The promotion's event field will be updated to reference that event.
startTimestamp	string	New promotion start date/time. Format: YYYY-MM-DD HH:mm:ss.
endTimestamp	string	New promotion end date/time. Format: YYYY-MM-DD HH:mm:ss.
partnerName	string	Updates the owning partner identifier. See List Available Partners for valid values.
files[<index>]	file	Image files showcasing how the promotion looks (e.g. screenshots or banner assets), sent as multipart/form-data. Use indexed keys ([0], [1], …) to upload multiple images.
filesIds	string	Comma-separated list of existing file IDs to keep (e.g. 385,386). Any existing files whose IDs are not listed will be removed. Combine with files[<index>] to keep some files and add new ones.

⚠️

Note

To preserve previously uploaded files when editing, list their IDs in filesIds. Omitting them will remove the stored files.

File uploads require multipart/form-data — they cannot be sent via JSON.

Examples

Updating text fields via JSON

curl -X PATCH "https://ws.catappult.io/api/promotions/9dbf70ff-30a4-4d82-b062-42ab24126e59" \
  -H "Api-Key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Promotion Name",
    "startTimestamp": "2026-03-16 00:00:00",
    "endTimestamp": "2026-04-30 00:00:00"
  }'

Keeping existing files and adding a new one

curl -X PATCH "https://ws.catappult.io/api/promotions/9dbf70ff-30a4-4d82-b062-42ab24126e59" \
  -H "Api-Key: <YOUR_API_KEY>" \
  -F "filesIds=385" \
  -F "files[0]=@/path/to/new-asset.png"

Response

Success

If the API call returns an HTTP 200 status code, the request was successful and the promotion has been updated.

Example Response

"Promotion updated."