Skip to main content


Run in Postman

Projects are where you can manage training examples and models for a chosen set of languages. For example, when if are working on an automatic email response classification mechanism in four languages, you would create a project called Email Response Classification in the four languages you want. In this article we will pick a use-case and walk you through the whole process.


Make sure to follow Getting Started to log in and install the Language Understanding service. If you are using APIs, save your authorization token in a variable called AUTHORIZATION_TOKEN before moving ahead.

Create Project

To create a project you will need to specify a project name and the language you want in the project. In this example we will create a project called Companion Bot in English. We will continue the same example in the following sections and pages.

neuralspace nlu create-project -p "Companion Bot" -L en

Every project has a unique project ID associated with it. Your unique ID will be shown on the terminal after running this command. Store it in a variable for future use.

You will find a list of supported languages here

List Projects

Use the following CLI command to list all your active projects. You can also use this command to see the Project ID of all projects.

neuralspace nlu list-projects

Update Project

Use the following API to update project name and number of training jobs. To know more about training jobs, check out Train Model

curl --location --request PUT '' \
--header 'Accept: application/json, text/plain, */*' \
--header 'Content-Type: application/json;charset=UTF-8' \
--header "Authorization: ${AUTHORIZATION_TOKEN}" \
--data-raw "{
\"projectId\": \"${PROJECT_ID}\",
\"projectName\":\"Companion Bot New\",
\"noOfTrainingJob\": 3

Delete Projects

CLI can also be used to delete a project which you no longer need. Simply use the following command and pass the ProjectID of the project you wish to delete. Here we are using the Project ID from the environment variable.

Delete a project using its unique project ID
neuralspace nlu delete-project -p $PROJECT_ID