> ## 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 Export API

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

Exports the ML utterances of a bot by creating a request ID, which can then be used to retrieve the download link via the [ML Utterances Export Status API](/ai-for-service/apis/automation/ml-utterances-export-status).

| **Field**         | **Value**                                                                                                                          |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Method**        | POST                                                                                                                               |
| **Endpoint**      | `https://{{host}}/api/public/bot/{{BotID}}/mlexport`                                                                               |
| **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: Utterances Export; Admin Console: Test > Utterances Export and Train                                                  |

## 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/{{bot_id}}/mlexport?state=configured&=&type=csv' \
  -H 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \
  -H 'content-type: application/json'
```

## Body Parameters

No body parameters are passed.

## Sample Response

```json theme={null}
{
    "status": "IN_PROGRESS",
    "percentageComplete": 0,
    "streamId": "st-22184e1f-e116-5ed4-8741-7aec3be466d7",
    "jobType": "ML_UTTERANCE",
    "action": "EXPORT",
    "countOfDockStatuses": 1,
    "createdBy": "u-8214dc3a-c749-5d23-b8ad-2a21bfa396ca",
    "fileType": "CSV",
    "statusLogs": [],
    "_id": "ds-db32ec69-7f80-5873-890a-576fe585965f",
    "lMod": "2023-07-26T13:15:04.000Z",
    "createdOn": "2023-07-26T13:15:04.983Z",
    "requestedTime": "2023-07-26T13:15:04.984Z",
    "__v": 0
}
```