> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a Skill API

[Back to API List](https://koreai.mintlify.site/ai-for-service/apis/contact-center/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](https://koreai.mintlify.site/ai-for-service/apis/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 |
| `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

```bash expandable=true theme={null}
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](https://koreai.mintlify.site/ai-for-service/apis/contact-center/get-a-skill-group). 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](https://koreai.mintlify.site/ai-for-service/apis/contact-center/list-all-agents). | string, optional |
| `proficiencyLevel` | Proficiency level. Values: `expert`, `novice`, `average`, `good`. | string, optional |

## Sample Response

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.