> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qa.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Testmo

> Pull your existing Testmo cases into the QA.tech AI chat and turn them into tests

The Testmo integration lets the [AI Chat Assistant](https://docs.qa.tech/core-concepts/ai-chat-assistant.md) read the test cases you already have in Testmo. You can explore them in chat and turn any of them into a QA.tech test without re-authoring the steps by hand. Nothing is written back to Testmo, and nothing is synced in the background. Cases are fetched when you ask for them.

> [!NOTE]
>
> **Authentication:** a Testmo API token, sent as a bearer token. The token is
> stored encrypted and is never shown again after you save it.
>
> **Reachability:** the instance must be a Testmo Cloud address,
> `https://<name>.testmo.net`.

## Before you start

**1. Create an API token**

In Testmo, open your user profile from the avatar in the top right, then
**API access**, and add a key. Testmo shows the key only once. See the
[Testmo API authentication
docs](https://support.testmo.com/hc/en-us/articles/37838838517517-API-Authentication).

**2. Prefer an API user**

On a Business or Enterprise subscription, create an API user under **Admin →
Users & roles** and generate the token there. API users do not use a seat,
and the connection keeps working when a person leaves.

## Setup

**1. Open the Testmo integration**

In your project, go to **Settings → Integrations** and select **Testmo**.

**2. Enter your credentials**

Fill in:

* **Instance URL:** your Testmo address, for example `https://yourco.testmo.net`
* **API token:** the key you generated above

Then click **Connect Testmo**.

**3. Test the connection**

Click **Test connection**. QA.tech reads the user the token belongs to,
which confirms the token and the instance URL match.

To change the token later, open the integration, enter a new token, and save. Leave the token field blank to keep the stored one. Changing the instance URL requires the token again.

## Using Testmo in chat

Once connected, ask the [AI Chat Assistant](https://docs.qa.tech/core-concepts/ai-chat-assistant.md) to work with your Testmo cases. It reads them through your project's credentials and does not create or edit anything in Testmo.

| You ask for | What the assistant does |
| - | - |
| Your Testmo projects | Lists the projects the token can see |
| Folders in a project | Lists the case repository's folders, so you can pick one |
| Cases in a project | Lists case names, paginated so large projects stay readable |
| Cases in a folder | Scopes the list to that folder, including sub-folders if you ask |
| Cases matching a word | Filters the list by a partial match on the case name |
| A single case in full | Fetches the name, description, and steps for one case |
| A QA.tech test from a case | Reads the case and drafts an equivalent QA.tech test |

The QA.tech test keeps a link to the Testmo case it came from. That link is what a later results report would use. Reporting results back to Testmo is not part of this integration yet.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.