The Schedule tool, accessible from within each test, allows you to schedule API tests to run as often as you’d like, with granular control as to when it runs. Let’s take a look at how it works.
- A Sauce Labs account (Log in or sign up for a free trial license).
- An existing API Testing Project and Test. For details on how to create them, see the Quickstart guide.
Our API Testing interface has a unique Working Copy / Published Copy system that allows you to edit a test without affecting the live, currently active version.
- Once you've finish editing your test, navigate to the Unpublished changes section, where it states that your test is currently unpublished.
- Hover your mouse over the section to reveal the Clear and Publish buttons.
- Click the Publish button to publish your working copy.
Click the Schedule tab to access the Scheduler.
Click Create Schedule.
The New Schedule window will appear.
Enter a Schedule Name (Description is optional).
Choose a Time Zone to specify when you'd like test will run. Double-check that you're using the right one (i.e., if you're in Berlin and want to run at your local time, make sure to select
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.
Optionally, you can add a Sauce Connect Proxy tunnel by selecting one from the No tunnel dropdown and/or enter a
When you're finished, click Save.
You'll be taken back to the Schedule page. The test you've scheduled should populate in the nav.
If you hover your mouse over it, you can see the options to Pause, Edit, or Delete the schedule.
If you need to edit the schedule or any other part of the test, here's a shortcut:
- Go to your the Tests tab of your Project.
- Hover your mouse over the test line item. You'll see icons that allow you to apply edits to your actual test and to the schedule.
From left to right:
- Pencil icon: Edits the test (opens the Compose tab).
- Play icon: Runs the test manually.
- Calendar icon: Opens the scheduler directly without opening the test first.
- Trash icon: Deletes the test.