Skills
Skills are used to route calls to specific agents:
For incoming calls, prefer skilled agents;
For outgoing calls, run all campaigns for an agent’s main skills before those for its backup skills.
Fields
API
- GET /j/skills
Retrieves the list of skills.
Example request:
GET /j/skills HTTP/1.1 Authorization: Bearer 0a1b2c3d4e5f
Example response:
HTTP/1.1 200 OK Content-Type: application/json [ { "created_at": "2025-07-04T19:11:34.985Z", "description": "Some description", "id": 1, "name": "A first skill", "team": 1 }, { "created_at": "2025-07-04T19:13:46.246Z", "description": "Other description", "id": 2, "name": "Another skill", "team": 1 } ]
- Request Headers:
Authorization – OAuth token to authenticate
- Query Parameters:
team (integer) – An optional team ID.
- Response JSON Array of Objects:
created_at (datetime) – The skill’s creation date and time.
description (string) – The skill’s description.
id (integer) – The skill’s unique ID.
name (string) – The skill’s name.
team (integer) – The skill’s team.
- Status Codes:
200 OK – no error
400 Bad Request – for instance a required field is missing
403 Forbidden – you tried to access a forbidden resource, check you provided a valid OAuth token