Create a Skill API

Back to API List

Use this API to add a skill with the given stream ID and skill group ID.

Method	POST
Endpoint	https://{{host}}/agentassist/api/v1/public/{{streamId}}/skill-groups/{{skillGroupId}}/skills
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 App Settings page of the bot.	string, required
skillGroupId	ID of the skill group.	string, required

Sample Request

curl --location --request POST \
     'https://{{host}}/agentassist/api/v1/public/{{streamId}}/skill-groups/{{skillGroupId}}/skills' \
      --header 'auth: {jwt-code}' \
      --header 'Content-Type: application/json' \
      --data-raw '
    {
    "name": "test",
    "description": "test",
    "agents": [
        {
            "userId": "u-ca2cc57f-5c2b-5437-bb07-fe9020d8xxxx",
            "proficiencyLevel": "average",
            "aId":""
        }
     ]
    }'

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. Find this with GET /skill-groups. For example, sg-4372.	string, required
agents	An array of agent objects with the following details.	array, optional
userId	User ID. Find this with GET /agents.	string, optional
proficiencyLevel	Proficiency level. Values: expert, novice, average, good.	string, optional

Sample Response

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