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

# Execute a Test Suite API

[Back to API List](https://koreai.mintlify.site/ai-for-service/apis/automation/api-list)

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](https://koreai.mintlify.site/ai-for-service/apis/automation/batch-test-execution-status) to retrieve results.

> [!NOTE]
>
> Testers can't run conversation test suites through the interface or API.

| Property | Value |
| - | - |
| **Method** | POST |
| **Endpoint** | `https://{{host}}/api/public/stream/{{streamId}}/conversation/testsuite/{{testSuiteName}}/run` |
| **Content Type** | `application/json` |
| **Authorization** | `auth: {{JWT}}` See [How to generate the JWT Token](https://koreai.mintlify.site/ai-for-service/apis/automation/api-introduction.md#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"
}
```


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