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://smartassist.kore.ai	String, Required
BotId	BotId or StreamId. You can access it from the General 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 'accountId: {{accountId}}'
      --header 'Content-Type: application/json' \
      --data-raw '{
    {
    
    "name": "test",
    "description": "test",
    "agents": [
        {
            "userId": "u-ca2cc57f-5c2b-5437-bb07-fe9020d8xxxx",
            "proficiencyLevel": "average",
            "aId":""
        }
     ]
    }'

Headers

• accountId (required): The account ID associated with the API request.
• auth (required): JWT token for authentication.

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	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 Example: ‘expert’	String, Optional

 

Sample Response

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