UiPath Documentation
activities
latest
false
Workflow activities

Delete Queue Items

Delete Queue Items activity that deletes items in any status except Deleted from a specified Orchestrator queue.

UiPath.Core.Activities.DeleteQueueItems

Description​

Enables you to delete items from a specified Orchestrator queue. Please note that in order to execute this activity in Studio, the Robot has to be connected to Orchestrator. When this activity is run, it uses the same authentication context as the Robot which executes it, inheriting its permissions. For the exact permissions it requires, see the Orchestrator permissions note below.

The activity deletes items in any queue item status except Deleted. It skips, without an error, items that are already deleted and items that changed in Orchestrator after you retrieved them. On Orchestrator 2023.10 and earlier, the activity does not delete In Progress items and skips them without an error.

Deleting items with a status other than New, such as Failed, can affect related counts, insights, or data integrity. If you have concerns about this impact, UiPath Support can help assess it before you delete items in bulk.

Note:

Orchestrator permissions

This activity runs under the Orchestrator account of the robot that executes it. It must hold the following Orchestrator role permissions on the target folder:

  • Queues.View: used to resolve the target queue
  • Transactions.Delete: used to delete queue items
  • Folders.View: used to browse and select the Orchestrator folder

Project compatibility​

Windows - Legacy | Windows | Cross-platform

Cross-Platform, Windows configuration​

  • Queue Items - The list of items that you want to mark as deleted in Orchestrator. They can be in any status except Deleted and should be retrieved via a Get Queue Items activity first. This property supports only IEnumerable<QueueItem> variables.

Advanced options​

  • Timeout (milliseconds) - Specifies the amount of time (in milliseconds) to wait for the activity to run before an error is thrown. The default value is 300000 milliseconds (5 minutes). Opening a connection to Orchestrator is always limited to 30 seconds, regardless of this value.
  • Continue On Error - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (true, false). The default value is false. As a result, if the field is not configured and an error is thrown, the execution of the project stops. If the value is set to true, the execution of the project continues regardless of any error.

Windows - Legacy configuration​

Properties panel​

Common​
  • Continue On Error - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (true, false). The default value is false. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to true, the execution of the project continues regardless of any error.
  • DisplayName - The display name of the activity.
  • Timeout (milliseconds) - Specifies the amount of time (in milliseconds) to wait for the activity to run before an error is thrown. The default value is 300000 milliseconds (5 minutes). Opening a connection to Orchestrator is always limited to 30 seconds, regardless of this value.
Input​
  • Queue Items - The list of items that you want to mark as deleted in Orchestrator. They can be in any status except Deleted and should be retrieved via a Get Queue Items activity first. This property supports only IEnumerable<QueueItem> variables.
  • Folder Path - The path of the folder where the specified QueueItems are located, if different from the folder where the process is running. This field only supports string values, with / as the separator to indicate subfolders. For example "Finance/Accounts Payable".

    Note:

    The FolderPath parameter does not work for processes executed by robots in classic folders. Only robots in modern folders have the ability to pass data outside of their folder. Relative folder paths are supported in an X-UIPATH-FolderPath-Encoded header, as follows:

    Path starting with / - starts from the root folder of the tree the ambient folder is part of.

    Path starting with . - starts from the ambient folder.

    Path starting with .. - starts one level up in the hierarchy of the ambient folder for each .. in the path (e.g. ../ for one level up, ../../ for two levels up in the hierarchy).

    Trailing slashes are not accepted.

  • Private - If selected, the values of variables and arguments are no longer logged at Verbose level.

  • Description​
  • Project compatibility​
  • Cross-Platform, Windows configuration​
  • Advanced options​
  • Windows - Legacy configuration​
  • Properties panel​

Was this page helpful?

Connect

Need help? Support(opens in new window)

Want to learn? UiPath Academy(opens in new window)

Have questions? UiPath Forum(opens in new window)

Stay updated