Run a test suite

You can run a test suite four ways: manually, on a schedule, through the web API, or in parallel.

Run manually

Select Execute test suite to run the suite on demand. Results appear on the Test Recorder page.

Schedule a suite to run on every build or to monitor a production application. You can also set up failure notifications.

Select the calendar icon next to the suite.
Set the schedule to active.
Choose a frequency:
- Every 15 minutes, 30 minutes or hour runs at a fixed interval. Use it to monitor health and alert when a service is down.
- Daily or weekly runs on the days and times you choose, such as a nightly regression run.
Select the time zone.
Enter the Base URL, the start URL of the application, for example production or staging.
Choose the browsers.

The web API starts a suite and reports its status, so you can call it from any CI/CD tool or script.

API key. Generate it on the My Account page, from the account menu at the top right.
Suite ID. Open the suite’s more-options menu and choose Details. See Test suites.

Send a POST request with your API key in the Authorization header.

POST https://app.cloudqa.io/api/v1/suites/<suiteId>/runs
Authorization: ApiKey <your_api_key>

To choose the browser or pass variables, add an optional JSON body:

{
  "Browser": "Firefox",
  "Variables": {
    "Variable1": "Value1",
    "Variable2": "Value2"
  }
}

The API responds immediately with status 202. The response body contains a run ID and the status started.

Use the run ID in a GET request.

GET https://app.cloudqa.io/api/v1/suites/<suiteId>/runs/<runId>
Authorization: ApiKey <your_api_key>

You can also try requests in the API Runner.

Tests in a suite can run in parallel instead of in order.