Skip to content

Update a Particular Skill

To update the particular skill with the given Stream Id, Skill Group Id, and Skill Id.

Method PUT
Endpoint https://{{host}}/agentassist/api/v1/public/{{streamId}}/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
BotId BotId or StreamId. You can access it from the General Settings page of the bot. 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": "username@domain.com"
        }
    ],
}'

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"
   }