Skip to content

Import Bot into an Existing Bot API

To import the bot definition file to an existing bot for a current version upgrade or previous version restoration.

You can import into a bot using either individual Definition, Config, Functions and Icon files, or you can directly use the zip file that is creating while performing bot export. In this case you will need to upload the zip file and use the File ID thus generated.

Note

This API requires the JWT generated by an application created on the Admin Console.

Method POST
Endpoint https://{{host}}/api/public/bot/{{BotID}}/import
Content Type application/json
Authorization auth: {{JWT}}
See How to generate the JWT Token
API Scope - App Builder: Not Applicable
- Admin Console: Bot Definition > Bot Import
  • App Builder: Not Applicable
  • Admin Console: Bot Definition > Bot Import
  • ## Query Parameters
    PARAMETER MANDATE DESCRIPTION
    host Required The environment URL. For example, https://platform.kore.ai
    BotID Required The Bot ID or Stream ID. You can access it under General Settings on the App Builder.
    ## Sample Request for the Universal Bot
    curl -X POST \
      https://{{host}}/api/public/bot/{{BotID}}/import \
      -H 'auth: YOUR_JWT_ACCESS_TOKEN' \
      -H 'content-type: application/json' \
      -d '{
      "botDefinition" : "5bxxxxxxxxxxxxxxxxxxxxxx",
      "configInfo" : "5bxxxxxxxxxxxxxxxxxxxxxx",
      "importOptions": {
        "nlpData": [
            "training_data",
            "bot_synonyms",
            "nlpSettings",
            "defaultDialog",
            "standardResponses"
        ],
        "settings": [
            "botSettings",
            "ivrSettings",
            "botVariables",
            "ivrSettings",
            "genAIandLLMSettings"
        ],
        "options": {
            "utterances": {
            "append": true,
            "replace": false
            }
        },
        "customDashboard": true
    }
    }'
    
    ## Sample Request
    curl -X POST \
      https://{{host}}/api/public/bot/{{BotID}}/import \
      -H 'auth: YOUR_JWT_ACCESS_TOKEN' \
      -H 'content-type: application/json' \
      -d '{
      "botDefinition" : "5bxxxxxxxxxxxxxxxxxxxxxx",
      "configInfo" : "5bxxxxxxxxxxxxxxxxxxxxxx",
      "botFunctions":["5bxxxxxxxxxxxxxxxxxxxxxx"]
    }'
    
    ## Body Parameters
    Parameter Mandate Description
    botDefinition Required “Bot Definition File id”
    configInfo Required “Bot Configuration File id”
    botFunctions Optional “Fileid”
    importOptions Required All bot components are imported by default. If needed, you may specify the components to be included in the import.

    Usage:

    "importOptions": {
    "tasks": [
    "botTask",
    "knowledgeGraph"
     ],
    "nlpData": [
    "nlpSettings",
    "utterances",
    "standardResponses"
    ],
    "settings": [
    "botSettings",
    "botVariables",
    "ivrSettings",
    "genAIandLLMSettings"
    ]
    },
    options Optional This will indicate incremental import options for the ML utterances, whether to replace or append.

    Usage:

    "options": 
    {
    "utterances": {
    "replace": true
    "append":false
     },
    }
    ## Sample Response
    {
        "streamRefId": "c685t327-xxxx-58xx-9xbx-33xxxxxxxxxx",
        "statusLogs": [
            {
                "taskType": "importRequest",
                "taskName": "Sample Task",
                "status": "success"
            }
        ],
        "createdBy": "u-3xxxxxxx-axxe-5bxx-bxxb-8xxxxxxxxxxx",
        "requestType": "Botimport",
        "_id": "bir-00bxxxxx-7xx2-5xxx-bxxx-79xxxxxxxxxx",
        "status": "pending",
        "createdOn": "2018-12-05T07:40:51.956Z",
        "__v": 0
    }