---
title: Run Now
slug: neurons-api/run-now
createdAt: 2026-08-19T08:34:10.413Z
---

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 /api/SwdPackage/distribution/runNow/external](docId\:rqy0TbQcKhDNdemfMz1qb)

## 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 [../Shared-Content/authenticate\_api.htm](docId\:g63kPQj5_TALr1zpNkeeN)[app-distribution-authentication.htm](docId\:fd5_JmdAucKSdgC_uJ35I)[Authentication](docId\:g63kPQj5_TALr1zpNkeeN) 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

```xml

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