@koredotcom/contact-center

--8<-- "includes/ccai-api-back-link.md"

# 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}}` <br>See [How to generate the JWT Token](../automation/api-introduction.md#generating-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": "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](../contact-center/get-a-skill-group.md). 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](../contact-center/list-all-agents.md).     | 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"
   }
```