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

# Execute a Test Suite API

<Badge icon="arrow-left" color="gray">[Back to API List](/ai-for-service/apis/automation/api-list)</Badge>

Executes Conversation Test Suites and returns the execution status along with a `testRunId` to track progress. This API only initiates the test — use the [Conversation Test Suite Execution Status API](/ai-for-service/apis/automation/batch-test-execution-status) to retrieve results.

<Note>
  Testers cannot run conversation test suites through the interface or API.
</Note>

| Property          | Value                                                                                                                                 |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **Method**        | POST                                                                                                                                  |
| **Endpoint**      | `https://{{host}}/api/public/stream/{{streamId}}/conversation/testsuite/{{testSuiteName}}/run`                                        |
| **Content Type**  | `application/json`                                                                                                                    |
| **Authorization** | `auth: {{JWT}}`<br />See [How to generate the JWT Token](/ai-for-service/apis/automation/api-introduction/#generating-the-jwt-token). |
| **API Scope**     | App Builder: Conversation Tests Execution; Admin Console: Conversation Tests Execution                                                |

## Query Parameters

| Parameter       | Description                                                          | Required |
| --------------- | -------------------------------------------------------------------- | -------- |
| `host`          | Environment URL. For example, `https://platform.kore.ai`             | Required |
| `StreamID`      | Stream ID, accessible under **General Settings** on the App Builder. | Required |
| `testSuiteName` | Name of the test suite on the App Builder.                           | Required |

## Sample Request

```bash theme={null}
curl --location \
      'https://{{host}}/api/public/stream/{{streamId}}/conversation/testsuite/{{testSuiteName}}/run' \
      --header 'auth: {{jwt-token}}' \
      --header 'bot-language: {{language-code}}' \
      --header 'Content-Type: application/json' \
      --data-raw '{
         "version": "published",
         "userEmailId": "email-id-of-the-bot-owner-or-developer"
         }'
```

## Body Parameters

| Parameter     | Description                                                                                                               | Required |
| ------------- | ------------------------------------------------------------------------------------------------------------------------- | -------- |
| `version`     | Version of the bot to test against: `published` for the published version, or `inDevelopment` for the configured version. | Required |
| `userEmailId` | Email ID of the app owner or a developer the app is shared with. For example, `"userEmailId": "john.doe@example.com"`     | Required |

## Sample Response

```json theme={null}
{
    "status": "IN_PROGRESS",
    "testRunId": "ctr-80xxxx9a-bxx1-58xx-axx7-d5xxxxxxxxxx"
}
```