Associate one or more apps to a managed device

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

Associating a app to the device

Request URL

https://{server-hostname}:8383/api/v1/mdm/devices/{device_id}/apps

Scope

MDMDeviceMgmt.CREATECopied!

Header

Authorization: d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Request Headers

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

- Path Parameters

device_idstringMandatory

Unique identifier of the device. Obtain from the Get Device List response

- Request Body

application/json
JSON Object
Hide Sub-Attributes
invite_userbooleanOptional

Whether to send an invitation to the user for app installation

do_not_uninstallbooleanOptional

Whether to retain the app on the device when disassociated

idlongOptional

Device ID to associate apps with. Fetch from Get Device List

app_detailsJSON ArrayMandatory

Array of app detail objects specifying app ID and release label

Show Sub-Attributes
JSON Object
Show Sub-Attributes
app_idstringMandatory

Unique app identifier to associate. Obtain from the Get App List response

release_label_idstringOptional

Release label ID for the app version to distribute. Obtain from the Get App Details response

notify_user_via_emailbooleanOptional

Whether to notify the user via email about the app installation

silent_installbooleanOptional

Whether to install the app silently without user interaction

Sample Request

Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request POST \
  --url https://appdomain/api/v1/mdm/devices/{device_id}/apps \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/json' \
  --data '{"invite_user":true,"do_not_uninstall":true,"app_details":[{"release_label_id":"90086789628394940","app_id":"9007199254740995"}],"notify_user_via_email":true,"id":9007199254741000,"silent_install":true}'

Sample Request Body

Associate apps with silent install and email notification

Copied!
  {
    "invite_user": true,
    "do_not_uninstall": true,
    "app_details": [
      {
        "release_label_id": "90086789628394940",
        "app_id": "9007199254740995"
      }
    ],
    "notify_user_via_email": true,
    "id": 9007199254741000,
    "silent_install": true
  }
                
Show full

Possible Response Codes

204HTTP code

Sample Response: HTTP 204

Copied!
204 No Content
Show full

Duration: 1 minute | Threshold: 300 | 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.