Agent Skills Management

Manage agent competencies by retrieving current skill sets, overwriting entire skill profiles, or assigning new individual skills.

Get Agent Skills

GET /Advanced Dialer/api/agent/{userId}/skills

Returns a collection of skills currently assigned to an agent, including their ability ratings (0-100).

Path Parameters

Parameter	Type	Description
`userId`	integer	The unique identifier of the agent.

Example Request

curl --request GET \
     --url 'https://api.talkdeskapp.com/Advanced Dialer/api/agent/1001/skills' \
     --header 'Ocp-Apim-Subscription-Key: YOUR_API_KEY' \
     --header 'X-Api-Version: 2.0'

Response Example

{
  "statusCode": 0,
  "message": null,
  "payload": [
    {
      "skillId": 1,
      "name": "Customer Service",
      "ability": 95
    },
    {
      "skillId": 2,
      "name": "Sales",
      "ability": 80
    }
  ]
}

Update Agent Skills

PUT /Advanced Dialer/api/agent/{userId}/skills

Note: This endpoint overwrites the entire skill set for the agent. Any existing skills not included in this request will be removed.

Request Body (Array)

Field	Type	Description
`skillId`	integer	The ID of the skill to assign.
`name`	string	The display name of the skill.
`ability`	integer	The proficiency level (typically 0-100).

Example Request

curl --request PUT \
     --url 'https://api.talkdeskapp.com/Advanced Dialer/api/agent/1001/skills' \
     --header 'Content-Type: application/json' \
     --header 'Ocp-Apim-Subscription-Key: YOUR_API_KEY' \
     --header 'X-Api-Version: 2.0' \
     --data '[
  {
    "skillId": 1,
    "name": "Customer Service",
    "ability": 90
  },
  {
    "skillId": 5,
    "name": "Product Knowledge",
    "ability": 85
  }
]'

Assign Single Skill

PATCH /Advanced Dialer/api/agent/{userId}/skill

Assigns a single skill to an agent. Unlike the PUT method, this does not affect existing skill assignments.

Example Request

curl --request PATCH \
     --url 'https://api.talkdeskapp.com/Advanced Dialer/api/agent/1001/skill' \
     --header 'Content-Type: application/json' \
     --header 'Ocp-Apim-Subscription-Key: YOUR_API_KEY' \
     --header 'X-Api-Version: 2.0' \
     --data '{
  "skillId": 6,
  "name": "Conflict Resolution",
  "ability": 80
}'