Edit an Event

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

Endpoint

Method	URL
PATCH	https://ws.catappult.io/api/events/{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

Events can only be created, edited, or deleted by accounts of type Developer.

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 event (e.g. 56fd535b-b071-402c-a4fa-29807eb050c9).

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 event's display name.
startTimestamp	string	New event start date/time. Format: YYYY-MM-DD HH:mm:ss.
endTimestamp	string	New event end date/time. Format: YYYY-MM-DD HH:mm:ss.
allowedPartners	string	Comma-separated list of partner identifiers (e.g. APTOIDE-GAMES,APTOIDE-VANILLA). See List Available Partners for valid values.
locales[<localeName>][description]	string	Short description for the given locale (e.g. en_GB).
locales[<localeName>][longDescription]	string	Long description for the given locale.
locales[<localeName>][files][<index>]	file	Asset file for the given locale, sent as multipart/form-data. Use indexed keys ([0], [1], …) to upload multiple files. The server auto-derives each file's ratio from its dimensions.
locales[<localeName>][filesIds]	string	Comma-separated list of existing file IDs to keep (e.g. 863,953). Any existing files whose IDs are not listed will be removed. Combine with files[<index>] to keep some files and add new ones.

⚠️

Note

Updating a locale replaces the whole entry for that locale, so any fields you don't include (including uploaded files) will be cleared. To preserve previously uploaded files, list their IDs in filesIds.

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/events/56fd535b-b071-402c-a4fa-29807eb050c9" \
  -H "Api-Key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Event Name",
    "startTimestamp": "2026-02-04 00:30:00",
    "endTimestamp": "2026-04-30 00:00:00",
    "allowedPartners": "APTOIDE-GAMES,APTOIDE-VANILLA",
    "locales": {
      "en_GB": {
        "description": "Test",
        "longDescription": "Test"
      }
    }
  }'

Uploading locale files via multipart/form-data

curl -X PATCH "https://ws.catappult.io/api/events/56fd535b-b071-402c-a4fa-29807eb050c9" \
  -H "Api-Key: <YOUR_API_KEY>" \
  -F "locales[en_GB][description]=Test" \
  -F "locales[en_GB][longDescription]=Test" \
  -F "locales[en_GB][files][0]=@/path/to/asset-1.webp" \
  -F "locales[en_GB][files][1]=@/path/to/asset-2.webp"

Keeping existing files and adding a new one

curl -X PATCH "https://ws.catappult.io/api/events/56fd535b-b071-402c-a4fa-29807eb050c9" \
  -H "Api-Key: <YOUR_API_KEY>" \
  -F "locales[en_GB][description]=Test" \
  -F "locales[en_GB][longDescription]=Test" \
  -F "locales[en_GB][filesIds]=863,953" \
  -F "locales[en_GB][files][0]=@/path/to/new-asset.webp"

Response

Success

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

Example Response

"Event updated."