Skip to main content

Table of Contents

Scheduling when a Robotic Process Automation robot runs

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 version 19.1 and later and in the C:\Programdata\OpenSpan folder in version 8.0 SP1 and earlier. 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.

There are two methods for scheduling when robots perform work: Scheduled and OnDemand. This article discusses the Scheduled method. For information on the OnDemand method, see Configuring Pega Robot Manager version 6. You must have Robotic Automation version 8.0 SP1 2019 or later to work with Robot Manager version 6. If you are using version 8.0 SP1, update to version 8.0 SP1 2025 or later. For best results, update to version 19.1.

Before you begin

In the local RPAService.config file, you must set the Mode key to Scheduled. Also, make sure the RpaSchedule.json is located in the correct C:\Programdata folder.

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.
    The Pega RPA Service uses a 24-hour clock. For example, to start the service at 1:30 pm, set the StartTime property to 13:30.
  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
  1. 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 in to Windows by using the Windows credentials that are supplied by the Credentials Manager (credmgr.exe) utility. For more information about the Credentials Manager, see Pega Robotic Automation Credentials Manager 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:

  1. Completes the current work item, if any work is in progress.
  2. Shuts down Pega Robot Runtime.
  3. Logs off Windows.
Suggest Edit
Did you find this content helpful?

100% found this useful

Have a question? Get answers now.

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

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us