Run Now

The input triggers Run Now for all devices that resolve to the distribution, or only for devices that are not compliant with the distribution (for example, devices that must have the application but don't have it installed). This can be used as part of the app deployment process to speed it up. If successful, the distribution is applied to devices without having to wait for a check-in or for groups to be resolved on a schedule.

HTTP Method - POST

This method triggers Run Now for all devices that resolve to the distribution, or only for devices that are not compliant with the distribution.

POST Method

Request URI

POST api/SwdPackage/distribution/runNow/external

Running this API does not complete the Run Now process successfully on all devices; it only confirms that a message to trigger it was sent successfully.

Header Parameters

Name Type Description

Authorization

String

Use the Bearer <access-token> value determined during the Authentication process.

Request Body Parameters

Name Type Description
packageId

String

The required Package ID, from the App Catalog.

distributionId

String

The required Distribution ID.

runAll

Boolean

Indicates whether to run the distribution on all devices or only on devices that are not compliant.

Example Request


                /api/SwdPackage/distribution/runNow/external
                {
                "packageId": "7b3c8f2a-6e4d-4c1b-9a5e-3f7d2b8e1c6a",
                "distributionId": "a3f8d2e1-4b7c-4a9e-b2d1-7f3e5c8a9b4d",
                "runAll": true
                }