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

class Skill

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.

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