OnDemand

In this method, the on-demand distribution category is assigned to the device. The app is installed once, with continual re-installation not being required.

HTTP Method - POST

Adds a new device to the on-demand distribution list and attempts to install the app on the targeted device as soon as possible.

POST Method

Request URI

Enter the specific landscape (only used by RapidApi) to get the requests.

Example request uri: rapidapi.com

POST /targetDevice/external

Adds a device to the system for on-demand distribution of the specified apps (package IDs).

Header Parameters

Name Type Description

Authorization

String

Use the Bearer <access-token> value determined during the Authenticate to the Patch Management API process.

X-Landscape-Url

String

Directs the request to the specified landscape (only used by RapidApi)

X-RapidAPI-Key

Enum

The key that applications and developers need to invoke the API.

X-RapidAPI-Host

String

The name that identifies which API will be used. For example: my-api-name.ivanti.rapidapi.com.

Request Body Parameters

Name Type Description
api-version

String

The current API version number.

Example Response

{
  "device": {
    "agentId": "string",
    "discoveryId": "string",
    "displayName": "string",
    "domain": "string",
    "platform": "string",
    "os": "string",
    "deviceType": "string",
    "addedDate": "2024-08-28T06:52:27.990Z",
    "addedUser": "string",
    "addedUserId": "string",
    "addedUserName": "string"
  },
  "packageIds": [
    "string"
  ]
}