API : FlexCare : App whitelist : Update release

API : FlexCare : App whitelist : Update release

Introduction

This will update a single release (APK version) of a whitelisted app.

Only the properties sent in the body are written; everything else on the release is left unchanged. An app must always have exactly one default release, so the default flag cannot be cleared on the current default release. Making a release the default instead clears the flag on all other releases of the app.

Request

URL	https://api.telecomx.dk/flexcare/appwhitelist/APP_ID/release/RELEASE_ID
Method	POST
Access level	ADMIN, or RESELLER admin with the TV employee feature
Param	APP_ID	Unique id (ObjectId) of the app
Param	RELEASE_ID	Unique id (ObjectId) of the release
body	version	String	`[optional]` App version
	versionCode	Number	`[optional]` Android version code (build number)
	file	ObjectId	`[optional]` File id of the APK (may be null)
	default	Boolean	`[optional]` True to make this the default version of the app. Cannot be set to false on the current default release.
	minAndroidVersion	Number	`[optional]` Minimum Android version required for this APK
	notes	String	`[optional]` Release notes for this version
	bundle	Array	`[optional]` Additional files bundled with the APK. Replaces the whole array.
	bundle[].file	ObjectId	`[required]` Unique id of the bundle file
	bundle[].url	String	`[required]` Url where file is located

At least one body property must be sent. _id and releaseDate are not accepted — they are owned by the server.

Query examples

https://api.telecomx.dk/flexcare/appwhitelist/1234567890ABCD1234567890/release/1234567890ABCD1234657980

Body example

{
  default: true,
  notes: "Fixes crash on startup"
}

Response

The updated release is returned as a bare object, as stored after the update. The app itself is not included.

JSON object
_id	ObjectId	Unique object id of the release
version	String	App version
versionCode	Number	Android version code (build number)
default	Boolean	True if this is chosen as the default version of the app
minAndroidVersion	Number	Minimum Android version required for this APK
file	ObjectId	File id of the APK (null if none)
notes	String	Release notes for this version
releaseDate	Date	Date the version was added
bundle	Array	Additional files bundled with the APK
bundle[].file	ObjectId	Unique id of the bundle file
bundle[].url	String	Url where file is located

Example

{
  _id: "1234567890ABCD1234657980",
  version: "1.0",
  versionCode: 100,
  default: true,
  minAndroidVersion: 8,
  file: "1224657890ABCD1234567980",
  notes: "Fixes crash on startup",
  releaseDate: "2026-05-01T10:00:00.000Z",
  bundle: []
}

Errors

Error code	Message	Description
422	id	Invalid app id (must be a 24-character hex ObjectId).
422	releaseId	Invalid release id (must be a 24-character hex ObjectId).
422	<field>	Invalid body field (e.g. `version`, `versionCode`, `file`, `bundle[].file`, `bundle[].url`).
400	bad_request	No properties to update. The body contained none of the updatable fields.
403	access_denied	Insufficient access level, or the reseller admin lacks the TV employee feature.
404	id	App not found.
404	releaseId	Release not found on the app.
409	default	Cannot unset the default release. Make another release the default instead.
500	internal_error	<Unspecified>

Table of Contents