Update a Particular Skill

Back to API List

Update a Particular Skill

To update the particular skill with the given streamId, skillGroupId, and skillId.

Method	PUT
Endpoint	https://{{host}}/agentassist/api/v1/public/{{botId}}/skill-groups/{{skillGroupId}}/skills/{skillId}
Content Type	application/json
Authorization	auth: {{JWT}} See How to generate the JWT Token
API Scope	SmartAssist Analytics

Path Parameters

PARAMETER	DESCRIPTION	TYPE
host	Environment URL, for example, https://platform.kore.ai	string, required
streamId	botId or streamId. You can get it from the App Settings page.	string, required
skillId	ID of the Skill.	string, required

Sample Request

curl --location --request PUT \
     'https://{{host}}/agentassist/api/v1/public/{{streamId}}/skill-groups/{{skillGroupId}}/skills/{skillId}' \
     --header 'auth: {jwt-code}' \
      --header 'Content-Type: application/json' \
      --data-raw '{
    "name": "Account Management",
    "description": "Manage Account and its Settings",
    "agents": [
        {
            "userId": "u-122x",
            "proficiencyLevel": "high",
            "firstName": "test",
            "lastName": "test",
            "email": "[e-mail]"
        }
    ],
}'

Body Parameters

PARAMETER	DESCRIPTION	TYPE
name	Name of the skill.	String, Required
description	Brief description of the skill up to 200 characters.	string, optional
skillGroupId	Id of the skill Group, which you can find with GET /skill-groups. Example: sg-4372	string, required
agents	An array of Objects with the following details.	string, optional
userId	This is the user Id that you can find with GET /agents.	string, optional
proficiencyLevel	The Proficiency level can be: expert, novice, average, good. For example, ‘expert’	string, optional

Sample Response

 {
    "id": "sk-87679",
    "name": "Account Management",
    "description": "Manage Account and its Settings",
    "agents": 15,
    "skillGroupId": "sg-4372"
   }