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

# ML Utterances Train API

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

Initiates ML training for a bot.

| **Field**         | **Value**                                                                                                                          |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Method**        | POST                                                                                                                               |
| **Endpoint**      | `https://{{host}}/api/public/bot/{{BotID}}/ml/train`                                                                               |
| **Content Type**  | `application/json`                                                                                                                 |
| **Authorization** | `auth: {{JWT}}` — See [How to generate the JWT Token](/ai-for-service/apis/automation/api-introduction/#generating-the-jwt-token). |
| **API Scope**     | App Builder: Train ML; Admin Console: Test and Train > Train ML                                                                    |

## Query Parameters

| **Parameter** | **Required/Optional** | **Description**                                                                |
| ------------- | --------------------- | ------------------------------------------------------------------------------ |
| `host`        | Required              | The environment URL. For example, `https://platform.kore.ai`                   |
| `BotID`       | Required              | Bot ID or Stream ID. Accessible under **General Settings** on the App Builder. |

## Sample Request

```json theme={null}
curl -X POST 'https://{{host}}/api/public/bot/{{BotId}}/ml/train' \
  --header 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \
  --header 'bot-language: de'
```

<Note>
  If the bot language is not included in the header, English is used as the default language for training. See the list of supported bot languages [here](/ai-for-service/app-settings/language-management/building-multi-language-bots).
</Note>

## Body Parameters

No body parameters are passed.

## Sample Response

```json theme={null}
[
    {
        "message": "Training Queued.",
        "Training_ID": "5dxxxxxxxxxxxxxxxxxxxxxx"
    }
]
```