Execute remedial action subflow

task brazil Updated Oct 23, 2026 2 min read execute-remedial-action-subflow.md
Raw file servicenow.com

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

  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:

    JSON
    {  "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.

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.

Keywords remedial actionsubflowWorkflow Studiodevice remediation
Search documentation
Search document titles and file paths on the brazil branch