Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Scheduling when a Robotic Process Automation robot runs

Updated on October 19, 2022

Use the Pega RPA Service to schedule when RPA robots start and stop.

The schedule is stored in the RpaSchedule.json file. This file is located in the C:Programdata\Pegasystems folder. In this file, there is a JSON element for each day of the week. In each JSON element, you specify when the robot will start and how long its session will last. You can schedule one session per day.

To specify an RPA robot's schedule, perform the following steps:

  1. Open the RpaSchedule.json file in a text editor.
  2. Set the Enabled property to True for the days on which you want the robot to run.
  3. In the StartTime property, specify the time in HH:MM format at which you want the Pega RPA Service to start looking for jobs to send to the robots.
  4. Set the DurationMinutes property to the number of minutes you want the Pega RPA Service to look for jobs. The following code is an example that shows how you set up a robot to run on Tuesday from 1 a.m. until 5 am:
      "Tuesday": {
        "Enabled": true,
        "StartTime": "01:00",
        "DurationMinutes": 240
  5. Save and then close the file.

    Restart the Pega RPA Service any time you change the RpaSchedule.json file settings.

    When the Pega RPA Service detects that a robot should be started, the service performs the following tasks:

    • Logs into Windows by using the Windows credentials that are supplied by the Credentials Manager (credmgr.exe) utility.
    • Starts Pega Robot Runtime as the user specified by the Credentials Manager utility by using the --Runtime flag. If you do not supply Pega Robot Runtime credentials, the Pega RPA Service starts Pega Robot Runtime as the user who is logged in to Windows.

    It can take up to three minutes to complete the Windows login and Pega Robot Runtime startup process.

    When Pega Robot Runtime detects that the scheduled session has ended, it performs the following tasks:

    • Completes the current work item, if any work is in progress.
    • Shuts down Pega Robot Runtime.
    • Logs off Windows.
  • Previous topic Configuring Robot Runtime in RPA implementations
  • Next topic Understanding the SchedulerDefinitions.xml file for managing login pathways

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us