[PATCH] Edit an In-App Product

You can update existing In-App Products for your application via the Aptoide Connect Developer Console or programmatically using this API endpoint.

Endpoint

Method	URL
PATCH	https://ws.catappult.io/api/applications/{applicationName}/consumables/{sku}

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).

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
applicationName	string	The unique package name of the application (e.g. com.example.test).
sku	string	The unique identifier of the in-app product to update (e.g., product01).

Query Parameters

Parameter	Type	Required	Description
operatingSystem	string (URL)or file	Optional (default: android)	Specifies the operating system for the in-app product. Possible values: • android • ios

Body Parameters

⚠️ Important

All parameters must always be sent as form data (multipart/form-data), even when you’re providing URLs instead of uploading files.

JSON requests are not supported. Use the -F flag in cURL to send each field.

Notes:

• If no country-specific retail price is defined, the final charge will be automatically converted from the reference price at the time of purchase.
• All countryPrices parameters (countryPrices[<country_code>][...]) can use any supported ISO 3166-1 alpha-2 country code.
• All locale parameters (locales[<language_code>][...]) can use any ISO 639 language code. You can provide locale parameters for multiple languages at once, but only one can be set as the default.

Parameter	Type	Required	Description
referencePriceCurrency	string	Required	ISO 4217 currency code of the reference price. See available currency codes.
referencePriceAmount	string	Required	Numeric value of the reference price.
countryPrices[<country_code>]	string	Optional	Price in the specified country.
locales[<language_code>][title]	string	Optional	Title in the specified language.
locales[<language_code>][description]	string	Optional	Description in the specified language.
locales[<language_code>][isDefault]	boolean	Optional	Set this language as default.

Response

Success

If the API call returns an HTTP 200 status code, the request was successful, and the in-app product was updated successfully.

Examples

Example for the in-app product product01 in the app com.example.app, with a reference price of 1 EUR, a country-specific price for United States of America (US) set to 2 USD, and localized content for English (en) (cURL)

curl -X PATCH "https://ws.catappult.io/api/applications/com.example.app/consumables/product01?operatingSystem=android" \
  -H "Api-Key: YOUR_API_KEY" \
  -F "referencePriceCurrency=EUR" \
  -F "referencePriceAmount=1" \
  -F "countryPrices[US]=2" \
  -F "locales[en][title]=Title" \
  -F "locales[en][description]=Description" \
  -F "locales[en][isDefault]=true"