Execute remedial action subflow
Use the Execute remedial action subflow to run a DEX remedial action on a device, and test it in Workflow Studio.
Before you begin
- The remedial action is active. To create a custom remedial action, see Create a remedial action.
- The target device is online.
Role required: admin
Procedure
-
Navigate to All > Remedial Actions Framework > Administration > Remedial actions.
-
Select a remedial action and copy its sys_id.
-
In the Remedial Action parameters related list on the remedial action record, note the column name of each required parameter.
-
Navigate to All > Configuration > Computers.
-
Select the device to run the remedial action on, and copy the sys_id of its computer configuration item (CI).
Warning: Copy the sys_id of the
cmdb_ci_computerrecord, not the sys_id of the agent record. -
To track the run, copy the sys_id of a remedial action origin from All > Remedial Actions Framework > Administration > Remedial action origins.
The origin is used to track the run in the remedial action execution record. Each run creates a remedial action execution record.
-
Navigate to All > Process Automation > Workflow Studio.
-
Open the list of subflows and filter it by application = DEX Application and Device Health = Name Execute remedial action.
-
Open the Execute Remedial Action subflow.
-
Select Test.
-
Enter the inputs that you prepared.
Input Value device_id The sys_id of the computer CI. remedial_action_id The sys_id of the remedial action. action_params A JSON object that maps the column name of each remedial action parameter to its value. If the remedial action has no parameters, enter {}.origin_sys_id (optional) The sys_id of the remedial action origin. For example, the
action_paramsvalue for a remedial action with two parameters looks like this:JSON{ "first_parameter_name": "value", "second_parameter_name": "value"}Warning: The JSON must be formatted correctly. Formatting errors prevent the run.
-
Run the test.
The subflow triggers the remedial action on the device and waits for the action to complete.
-
Review the subflow outputs.
If the remedial action completes successfully, the outputs show the message
Remedial action completed successfullyand a status of completed. For all outputs and messages, see Execute remedial action subflow inputs and outputs.
Result
The remedial action runs on the device, and the subflow outputs report the outcome.
What to do next
To review the execution record, see View remedial action execution.
---
title: Execute remedial action subflow
description: Use the Execute remedial action subflow to run a DEX remedial action on a device, and test it in Workflow Studio.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/it-operations-management/digital-end-user-experience-dex/execute-remedial-action-subflow.html
release: australia
product: Digital End-User Experience \(DEX\)
classification: digital-end-user-experience-dex
topic_type: task
last_updated: "2026-10-23"
reading_time_minutes: 2
keywords: [remedial action, subflow, Workflow Studio, device remediation]
breadcrumb: [Triggering remedial actions from flows, Creating DEX remedial actions, Configure, Digital End-User Experience, IT Operations Management]
---
# Execute remedial action subflow
Use the Execute remedial action subflow to run a DEX remedial action on a device, and test it in Workflow Studio.
## Before you begin
- The remedial action is active. To create a custom remedial action, see [Create a remedial action](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/digital-end-user-experience-dex/create-remedial-action.md).
- The target device is online.
Role required: admin
## Procedure
1. Navigate to **All** > **Remedial Actions Framework** > **Administration** > **Remedial actions**.
2. Select a remedial action and copy its sys\_id.
3. In the Remedial Action parameters related list on the remedial action record, note the column name of each required parameter.
4. Navigate to **All** > **Configuration** > **Computers**.
5. Select the device to run the remedial action on, and copy the sys\_id of its computer configuration item \(CI\).
**Warning:** Copy the sys\_id of the `cmdb_ci_computer` record, not the sys\_id of the agent record.
6. To track the run, copy the sys\_id of a remedial action origin from **All** > **Remedial Actions Framework** > **Administration** > **Remedial action origins**.
The origin is used to track the run in the remedial action execution record. Each run creates a remedial action execution record.
7. Navigate to **All** > **Process Automation** > **Workflow Studio**.
8. Open the list of subflows and filter it by application = DEX Application and Device Health = Name **Execute remedial action**.
9. Open the **Execute Remedial Action** subflow.
10. Select **Test**.
11. Enter the inputs that you prepared.
|Input|Value|
|-----|-----|
|device\_id|The sys\_id of the computer CI.|
|remedial\_action\_id|The sys\_id of the remedial action.|
|action\_params|A JSON object that maps the column name of each remedial action parameter to its value. If the remedial action has no parameters, enter `{}`.|
|origin\_sys\_id \(optional\)|The sys\_id of the remedial action origin.|
For example, the `action_params` value for a remedial action with two parameters looks like this:
```
{
"first_parameter_name": "value",
"second_parameter_name": "value"
}
```
**Warning:** The JSON must be formatted correctly. Formatting errors prevent the run.
12. Run the test.
The subflow triggers the remedial action on the device and waits for the action to complete.
13. Review the subflow outputs.
If the remedial action completes successfully, the outputs show the message `Remedial action completed successfully` and a status of completed. For all outputs and messages, see [Execute remedial action subflow inputs and outputs](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/digital-end-user-experience-dex/execute-remedial-action-subflow-reference.md).
## Result
The remedial action runs on the device, and the subflow outputs report the outcome.
## What to do next
To review the execution record, see [View remedial action execution](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/digital-end-user-experience-dex/view-remedial-action-execution.md).
| title | Execute remedial action subflow |
| description | Use the Execute remedial action subflow to run a DEX remedial action on a device, and test it in Workflow Studio. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/australia/it-operations-management/digital-end-user-experience-dex/execute-remedial-action-subflow.html |
| release | australia |
| product | Digital End-User Experience \(DEX\) |
| classification | digital-end-user-experience-dex |
| topic_type | task |
| last_updated | 2026-10-23 |
| reading_time_minutes | 2 |
| keywords | remedial actionsubflowWorkflow Studiodevice remediation |
| breadcrumb | Triggering remedial actions from flowsCreating DEX remedial actionsConfigureDigital End-User ExperienceIT Operations Management |