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://smartassist.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 'accountId: {{accountId}}'
--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"
}
],
}'
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 | 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 Example: ‘expert’ |
String, Optional |
Sample Response
{
"id": "sk-87679",
"name": "Account Management",
"description": "Manage Account and its Settings",
"agents": 15,
"skillGroupId": "sg-4372"
}