Skip to main content
The TestRail integration lets the AI Chat Assistant read your existing TestRail test cases, so you can explore them and turn them into QA.tech tests without re-authoring anything by hand.
Authentication: TestRail uses an email + API key (HTTP Basic auth). Your API key is stored encrypted and is never shown again after saving.

​
Before you start

Enable the API and generate a key in TestRail:
1

Enable the TestRail API

In TestRail, go to Administration → Site Settings → API and turn on Enable API. This requires TestRail administrator access.
2

Create an API key

Click your avatar → My Settings → API Keys → Add Key, then copy the generated key — TestRail shows it only once. See the TestRail API docs for details.

​
Setup

1

Open the TestRail integration

Go to Settings → Integrations in your project and select TestRail.
2

Enter your credentials

Fill in:
  • Instance URL — your TestRail address, e.g. https://yourco.testrail.io
  • Account email — the email the API key belongs to
  • API key — the key you generated above
Then click Connect TestRail.
3

Test the connection

Click Test connection to confirm QA.tech can reach your instance — it reports how many projects it can see.
Your TestRail instance must be reachable over https on a public address. Internal-only / private-network instances are not supported.

​
Using TestRail in chat

Once connected, ask the AI Chat Assistant to work with your TestRail cases. It can:
  • List your TestRail projects to find the right one
  • List test cases in a project, suite, or section (paginated for large projects)
  • Fetch a case in full, including its steps and preconditions
  • Turn a TestRail case into a QA.tech test
“List our TestRail projects”
“Show the test cases in the Checkout suite”
“Open TestRail case C1234 and create an equivalent QA.tech test”
For multi-suite projects, tell the assistant which suite you mean (or ask it to list the suites first) so it can scope the cases correctly.

​
Removing the integration

To disconnect, open Settings → Integrations → TestRail and click Remove. This deletes the stored credentials, including your API key. Test cases you have already imported into QA.tech are not affected.