Device Workflow Validation Errors Following Upgrade to Director 22.x / 23.x (PR 154926)


In Versa Director releases prior to September 2024 (including earlier builds of 22.1.4), serial number input fields lacked strict character validation, allowing special characters such as underscores (_) or asterisks (*). Beginning with releases post-September 2024 in the 22.x and 23.x trains, enhanced input validation was introduced to block special characters in serial numbers.

As a result, environments upgraded from older releases to 23.x may encounter validation errors during Device Workflow execution if existing deployed workflows contain legacy special characters in their serial number fields.

To address this without requiring manual workflow reconfigurations, PR 154926 introduces a configurable toggle on the Director GUI (available in 23.x hotfixes released after August 14, 2026). This setting allows administrators to control serial number validation behavior as needed.

Resolution / Action Required

If your deployment contains active Device Workflows with special characters in their serial numbers, or if you plan to use special characters in future workflows, disable serial-number validation in the Versa Director GUI.

  1. Log in to Versa Director.
  2. Navigate to Administration > System > Settings.
  3. Expand the Advanced section and locate Validation Flags.
  4. Find the Serial Number Check setting:
    • Checked (default): Strict validation is enforced, and special characters are not allowed in serial numbers.
    • Unchecked: Strict validation is disabled, and special characters are allowed in serial numbers.
  5. Uncheck Serial Number Check, and then save the settings.


This change allows Device Workflows containing special characters in their serial numbers to pass validation and resolves the associated workflow validation errors.