Approve a specific app version in a release label for distribution

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

Approve app version

Request URL

https://{server-hostname}:8383/api/v1/mdm/apps/{app_id}/labels/{release_label_id}/approve

Scope

MDMDeviceMgmt.CREATECopied!

Header

Authorization: d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Request Headers

Content-TypestringMandatory
application/jsonapplication/jsonCopied!
AcceptstringMandatory
application/jsonapplication/jsonCopied!

- Path Parameters

app_idstringMandatory

Unique identifier of the application. Obtain from the Get App List response

release_label_idstringMandatory

Unique identifier of the release label. Obtain from the Get App Details response

- Request Body

application/json
JSON Object
Hide Sub-Attributes
silent_installbooleanOptional

Allow silent installation. false = manual from App Catalog

notify_user_via_emailbooleanOptional

Notify users by e-mail upon distribution

retire_old_versionbooleanOptional

Retire old versions. If false, old versions removed

version_labelstringOptional

Channel name for the version label (e.g., Production)

distribute_updatebooleanOptional

true = distribute approved version to all devices/groups with older versions

Sample Request

Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request POST \
  --url https://appdomain/api/v1/mdm/apps/{app_id}/labels/{release_label_id}/approve \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/json' \
  --data '{"version_label":"Production","retire_old_version":false,"notify_user_via_email":true,"silent_install":true,"distribute_update":true}'

Sample Request Body

Approve version and distribute update to all devices/groups with older versions

Copied!
  {
    "version_label": "Production",
    "retire_old_version": false,
    "notify_user_via_email": true,
    "silent_install": true,
    "distribute_update": true
  }
                
Show full

Approve version without auto-distributing to existing devices

Copied!
  {
    "version_label": "Stable",
    "retire_old_version": true,
    "notify_user_via_email": false,
    "silent_install": false,
    "distribute_update": false
  }
                
Show full

Possible Response Codes

204HTTP code

Sample Response: HTTP 204

Copied!
204 No Content
Show full

Duration: 1 minute | Threshold: 60 | Lock period: 5 minutes

Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.