A Test Suite in Qodex is a collection of multiple test scenarios grouped together ideal for validating end-to-end workflows, regression testing, or running all auth-related APIs in one go.

​
From the Qodex Web App

  1. Navigate to Test Suites from the left sidebar.
  2. Select an existing test suite or create one by clicking + Add Test Suite.
  3. Inside the suite, confirm all relevant test scenarios are added.
  4. Click Run Suite.
  5. Choose the environment to run against (e.g., .env.staging, .env.production).
  6. Monitor test progress and results in the Build Reports section.
Each test scenario will run sequentially or in parallel (as supported), and logs will be grouped under a single test suite execution report.

​
From CLI (Local)

You can run a full test suite locally after syncing it with GitHub. 
qodex run --suite "Regression Suite" --env .env.staging
Use the exact name of the test suite and point to the appropriate .env file for variables.

​
From CI/CD

To run a full suite via CI/CD, include the —suite flag in your automation scripts or trigger a test plan that includes the suite. Example (GitHub Actions): 
- name: Run full suite
  run: qodex run --suite "Critical Flows" --env .env.ci

​
Why Use This?

  • Run all test flows before deployments
  • Validate interdependent APIs together
  • Ensure consistent behavior across environments
  • Ideal for daily scheduled runs or post-merge validations
For recurring execution, link your suite to a Test Plan and set a schedule.