Skip to main content

Scheduling API Tests

You can schedule tests to run as often as you’d like, with granular control as to when tests run. Let’s take a look at how it works.

What You'll Need


The Schedule functionality is available only for published tests. For more information, see Publish Your Test.

Scheduling Tests

  1. On the Tests page, click the checkbox next to one or more tests that you want to schedule, or click the All checkbox, and then click Schedule.
Schedule Tests

As a shortcut to schedule a single test, hover over the test, and then click the Calendar icon to open the scheduler directly.

Schedule a Single Test
  1. In the New Schedule window, enter a Schedule Name (Description is optional).
  2. Optionally, you can click a checkbox next to one or more tests to add or remove tests from the schedule.
  3. Choose a Time Zone, but verify that you're using the right one. For example, if you're in Berlin and want to run at your local time, make sure to select Europe/Berlin instead of America/Los Angeles.
  4. Use the Minute, Hour, Day, and Month parameters to schedule the frequency at which you'd like your test to run. It will repeat at your configured time and interval.
  5. Optionally, you can add a Sauce Connect Proxy tunnel by selecting one from the No tunnel dropdown or entering a key=value variable override.

When an override variable is declared, its value will be injected into the test when it’s executed. If the variable has already been declared in the Vault or the Globals/Input set, it will be rewritten with the new value.

  1. When you're finished, click Save. The test schedule is displayed on the Schedules page.

Test Schedule Options

Hover your mouse over the schedule name to access the Pause, Edit, and Delete options for a schedule.

Test Schedule Options

To pause all test schedules in the same group (Single or Global), click Pause.

Pause Tests

More Information