To export the bot definition and all the associated components.
Note: This API only initiates the export process. Please use the Export Status API to view the export progress status and obtain a link to download the file once the export completes.
| Method | POST |
| Endpoint | https://{{host}}/api/public/bot/{{BotID}}/export |
| Content Type | application/json |
| Authorization |
|
| API Scope |
|
Query Parameters
| Parameter | Description | Mandate |
|---|---|---|
| host | The environment URL. For example, https://bots.kore.ai |
Required |
| BotID | Bot ID or Stream ID can be accessed under General Settings on the Bot Builder. | Required |
Sample Request
curl --location 'https://{host}/api/public/bot/{BotID}/export' \
--header 'auth: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMTIyIiwibmFtZSI6IjM0NCIsImFwcElkIjoiY3MtN2Q1NDM2Y2QtNzliNi01YjI3LTg3OTgtMWQyNWNhMWQ5MWE2In0.xKEFeQPof33gbo-CCw-QLvJFrfC0tQEYwWDda1pg024' \
--header 'content-type: application/json' \
--data '{
"exportType": "published",
"exportOptions": {
"settings": [
"botSettings",
"botVariables",
"ivrSettings"
],
"tasks": [
"botTask",
"knowledgeGraph",
"smallTalk"
],
"nlpData": [
"nlpSettings",
"utterances",
"patterns",
"standardResponses"
]
},
"subTasks": {
"alerts": [],
"actions": [],
"dialogs": []
},
"allTasks": true,
"customDashboards": true,
"IncludeDependentTasks": true
}’
Body Parameters
| Parameter | Description | Mandate |
|---|---|---|
| exportType |
Bot type –
|
Required |
| exportOptions |
All the bot components are exported by default. If required, you may specify the components to be included for the export. Usage: "exportOptions": {
"tasks": [
"botTask",
"knowledgeGraph"
],
"nlpData": [
"nlpSettings",
"utterances",
"standardResponses"
],
"settings": [
"botSettings",
"botVariables",
"ivrSettings"
]
},
|
Optional |
| subTasks |
For partial export mention the tasks to be exported. Usage: "subTasks": {
"dialogs": ["<dialog Name 1>","<dialog Name 2>"],
"alerts": ["<alert name 1>","<alert name 2>"],
"actions": ["<action name 1>","<action name 2>"]
}
|
Optional |
| IncludeDependentTasks |
To include dependent tasks for export. Usage: "IncludeDependentTasks": true |
Optional |
| customDashboards |
To include custom dashboards for export. Usage: "customDashboards": true |
Optional |
| allTasks |
To include all tasks for export, will be ignored if subTasks is present. Usage: "allTasks": true |
Optional |
To learn more about the optional parameters for partial import and dependent tasks, please click here.
Sample Response
{
"status": "pending",
"streamId": "st-57af1576-bbdc-5ded-a608-5cfbc00c6415",
"createdBy": "u-f8708c55-de2c-5690-8821-ac90624779b5",
"exportType": "published",
"requestType": "Botexport",
"_id": "ber-dd746d3c-1631-53af-81ca-03a1d01f0487",
"createdOn": "2023-03-31T13:06:16.309Z",
"__v": 0
}