Update skill group

Access: write. Not available to read-only API credentials (returns 403).

Update a skill group and, optionally, the set of users assigned to it. Send the skill group id in the path.

When to use. Rename a skill group, change its description, or reassign which users belong to it. To create a skill group, use POST /skill-groups.

Request body. Send only the fields you want to change.

  • name (string): Skill group name.
  • description (string): Skill group description.
  • userIds (array of integers): The complete set of user IDs that should belong to the skill group. The assignment is rewritten to match this list. Omit it to leave the current assignments unchanged.

Returns. { "skillGroup": { ... } }, the updated skill group including its current userIds. Returns 404 if the skill group does not exist.

Example.

PUT /api/skill-groups/6

{ "name": "english", "description": "All agents that speak English", "userIds": [1, 2] }

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

Skill group ID.

string
required

Dialer Name (subdomain)

Body Params

Skill group name.

Skill group description.

array | null

The complete set of user IDs that should belong to the skill group; omit to leave assignments unchanged.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json