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
- Navigate to Test Suites from the left sidebar.
- Select an existing test suite or create one by clicking + Add Test Suite.
- Inside the suite, confirm all relevant test scenarios are added.
- Click Run Suite.
- Choose the environment to run against (e.g., .env.staging, .env.production).
- 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.