Distribute an app to one or more specific devices

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

Add app to device

Request URL

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

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
device_idsarrayMandatory

Array of device IDs to associate the app with. Obtain from the Get Device List response

silent_installbooleanOptional

Allow silent installation. Default: true

notify_user_via_emailbooleanOptional

Notify users by e-mail. Default: true

Sample Request

Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request POST \
  --url https://appdomain/api/v1/mdm/apps/{app_id}/labels/{release_label_id}/devices \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/json' \
  --data '{"notify_user_via_email":true,"device_ids":[1,2,3],"silent_install":true}'

Sample Request Body

Distribute app to multiple devices with silent install and email notification

Copied!
  {
    "notify_user_via_email": true,
    "device_ids": [
      1,
      2,
      3
    ],
    "silent_install": true
  }
                
Show full

Possible Response Codes

202HTTP code

Sample Response: HTTP 202

Copied!
202 Accepted
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.