Skills

Skills determine which tasks an agent can perform. A task can be assigned to an agent during a shift if they have all the required skills to perform the task. For more information about skills, see the Skills section of the Administrator guide.

Getting the list of skills

You can get a list of skills with their data: ID, name, creation and update date and time.

To get the list of skills, send a GET request to /v1/skills with the limit parameter - the maximum number of skills in the response (from 1 to 100).

Request example:

curl --request GET \
   --url 'https://geoflow.2gis.ru/public/api/v1/skills?limit=3' \
   --header 'Authorization: Bearer <token>'

Response example:

response.json

{
    "items": [
        {
            "id": "374af95f-4370-4091-8ea7-dcdc3542f296",
            "name": "Fragile goods delivery",
            "created_at": "2026-08-20T08:13:11.10992Z",
            "updated_at": "2026-08-20T08:13:11.10992Z"
        },
        {
            "id": "46a71b6b-e124-475f-b63e-0ff8f3f0506a",
            "name": "Access by pass",
            "created_at": "2026-08-20T10:11:39.051787Z",
            "updated_at": "2026-08-20T10:11:39.051787Z"
        },
        {
            "id": "8c80a174-8b51-4e39-89c2-f4038739c064",
            "name": "Document delivery",
            "created_at": "2026-08-20T10:11:43.641298Z",
            "updated_at": "2026-08-20T10:11:43.641298Z"
        }
    ],
    "cursor": {}
}