Refresh User Workspace

Add the Refresh User Workspace action to force a refresh of the Ivanti Workspace Control session of the subscriber. This is useful in Ivanti Workspace Control environments, for example if a service installs new software and the user workspace needs to be refreshed before it is available.

  • This action requires the installation of the Windows Client on the device of the subscriber.



Explanation and Tips

Action Name

Optionally specify a friendly name for the action. This name must be unique in the workflow.


This field always specifies Subscriber, because this action always refreshes the user workspace of the subscriber to the service.


Specify a message.

  • The markup editor supports styling functionality like headings, colors and numbered lists, but also hyperlinks and drag-and-drop.

Send e-mail notification

Enable e-mail notification for this specific action. This sends an e-mail to the user that a message has been delivered in the Web Portal, if you have enabled E-mail Integration (at Setup > E-mail Integration).

  • This option is selected by default. It is also selected in upgraded environments.
  • Clear the option to disable e-mail notification. This is useful in actions that send notifications to multiple actors as the result of a smart rule: it prevents unnecessary e-mail notifications. For example, if you configured a service with a Refresh User Workspace action that is sent to all actors on a smart rule list, and the workflow should proceed with the first response, you probably do not want to send this notification by e-mail. You can prevent this by disabling e-mail notification for this specific action.

After confirmation

Ask the subscriber to confirm the refresh of the user workspace.

  • If you clear the option, the user workspace refreshes immediately.

Email reminder

Starting with Identity Director 2021.2, you can optionally notify the person that needs to approve or confirm the action, according to the time interval you input.

  • You can set the time interval to a number of hours, days, weeks, or months.

  • The system keeps sending notifications until the action is approved, canceled, or when it expires.


Specify when the action expires. If the action hasn't been performed in time, it fails.

  • You can use placeholders to make the expiration time for the action dynamic.
    • When the action is executed, the placeholder needs to resolve into an integer (e.g. "9"). Invalid input (e.g. "Nine") causes the action to ignore the expiration time. The transaction continues immediately.
  • If Ivanti Workspace Control users already have pending refreshes when they log on to a workspace session, this results in a single refresh.
  • The Windows Client polls the Mobile Gateway at an interval of 10 seconds. If it receives multiple refresh messages within this time frame, this results in a single refresh.
  • If the Windows Client receives multiple refresh messages that include both manual and auto-refresh messages, this results in a single auto-refresh.
  • When the Windows Client has executed a refresh message, it isn't marked as done for another 10 seconds. In multiple concurrent workspace sessions that use the same user account, this allows the Windows Clients in the other workspace sessions to execute the refresh.
  • This action can be translated. The RESX file of the service that uses the action, contains the translatable fields.
See also