> ## 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.

# Batch Test Execution API

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

To execute Batch Test Suites and get results. This API only initiates the test process. Use the [Batch Test Execution Status API](https://koreai.mintlify.site/ai-for-service/apis/automation/batch-test-execution-status) for the results.

| Field | Value |
| - | - |
| **Method** | POST |
| **Endpoint** | `https://{{host}}/api/public/bot/{{BotID}}/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: Batch Tests Execution; Admin Console: Not Applicable |

## Query Parameters

| Parameter | Description | Mandate |
| - | - | - |
| **host** | The environment URL. For example, `https://platform.kore.ai` | Required |
| **BotID** | *Bot ID* or *Stream ID* can be accessed under **General Settings** on the App Builder. | Required |
| **testSuiteName** | Name of the test suite on the App Builder. | Required |

## Sample Request

```json theme={null}
curl --location --request POST \
      'https://{host}/api/public/stream/{streamId}/testsuite/{testSuiteName}/run' \
      --header 'auth: {{jwt-token}}' \
      --header 'bot-language: {{language-code}}' \
      --header 'Content-Type: application/json' \
      --data-raw '{
         "version":"inDevelopment",
         "engine":"dgpt"
         }'
```

> [!NOTE]
>
> * If `engine = "regression"` (or empty) or engine isn't provided, it executes ML Batch Testing.
> * If engine is set to `"dgpt"`, it executes Dialog GPT Batch Testing.

## Body Parameters

| Parameter | Description | Mandate |
| - | - | - |
| **version** | The version of the bot against which the execution is required: `published` for Published version, `inDevelopment` for the Configured version. | Required |

## Sample Response

```json theme={null}
{
    "status": "accepted",
    "requestId": "tr-acfxxbff-xxxf-xaxx-bbbx-exxxabaxxcxx"
}
```


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