Должности

curl --location 'https://api.exode.biz/saas/v2/staff/position/list?take=10&page=1&search=Backend' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Authorization: Bearer YOUR_TOKEN'

const axios = require('axios');

async function getPositionList() {
  const { data } = await axios.get(
    'https://api.exode.biz/saas/v2/staff/position/list',
    {
      params: {
        take: 10,
        page: 1,
        search: 'Backend',
      },
      headers: {
        'Seller-Id': '{{ sellerId }}',
        'School-Id': '{{ schoolId }}',
        'Authorization': 'Bearer YOUR_TOKEN',
      },
    }
  );
  console.log(data.payload);
}

getPositionList();

{
  "success": true,
  "code": 200,
  "payload": {
    "page": 1,
    "count": 2,
    "pages": 1,
    "isFirst": true,
    "isLast": true,
    "items": [
      {
        "id": 4,
        "createdAt": "2026-07-02T11:15:47.216Z",
        "updatedAt": "2026-07-02T11:15:47.260Z",
        "archivedAt": null,
        "schoolId": 198,
        "name": "Staff Backend Engineer",
        "extId": "e2b4a1c0-7f3d-4b6a-9c2e-1d5f8a0b3c47"
      },
      {
        "id": 3,
        "createdAt": "2026-07-02T11:15:47.207Z",
        "updatedAt": "2026-07-02T11:15:47.207Z",
        "archivedAt": null,
        "schoolId": 198,
        "name": "Backend Engineer",
        "extId": null
      }
    ],
    "next": {
      "skip": 0,
      "take": 10,
      "page": 1
    },
    "prev": {
      "skip": 0,
      "take": 10,
      "page": 1
    }
  }
}

curl --location 'https://api.exode.biz/saas/v2/staff/position/list?take=10&page=1&search=Backend' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Authorization: Bearer YOUR_TOKEN'

const axios = require('axios');

async function getPositionList() {
  const { data } = await axios.get(
    'https://api.exode.biz/saas/v2/staff/position/list',
    {
      params: {
        take: 10,
        page: 1,
        search: 'Backend',
      },
      headers: {
        'Seller-Id': '{{ sellerId }}',
        'School-Id': '{{ schoolId }}',
        'Authorization': 'Bearer YOUR_TOKEN',
      },
    }
  );
  console.log(data.payload);
}

getPositionList();

{
  "success": true,
  "code": 200,
  "payload": {
    "page": 1,
    "count": 2,
    "pages": 1,
    "isFirst": true,
    "isLast": true,
    "items": [
      {
        "id": 4,
        "createdAt": "2026-07-02T11:15:47.216Z",
        "updatedAt": "2026-07-02T11:15:47.260Z",
        "archivedAt": null,
        "schoolId": 198,
        "name": "Staff Backend Engineer",
        "extId": "e2b4a1c0-7f3d-4b6a-9c2e-1d5f8a0b3c47"
      },
      {
        "id": 3,
        "createdAt": "2026-07-02T11:15:47.207Z",
        "updatedAt": "2026-07-02T11:15:47.207Z",
        "archivedAt": null,
        "schoolId": 198,
        "name": "Backend Engineer",
        "extId": null
      }
    ],
    "next": {
      "skip": 0,
      "take": 10,
      "page": 1
    },
    "prev": {
      "skip": 0,
      "take": 10,
      "page": 1
    }
  }
}

Заголовки запроса

string

обязательно

API-токен сервисного пользователя в формате Bearer YOUR_TOKEN. Токен выпускает владелец школы в кабинете: Управление → Школа → Для разработчиков → API-ключи — подробнее в разделе «Аутентификация».

integer

обязательно

Числовой ID продавца — аккаунта, которому принадлежит школа. Скопируйте его на странице API-ключи в карточке «Данные для интеграции → Идентификаторы». По этому ID проверяются права токена.

integer

обязательно

Числовой ID школы, берётся там же, где Seller-Id. Значение должно совпадать со школой продавца — иначе вернётся ошибка 400 с cause: "ForbiddenSchoolMismatch".

Должности — это справочник наименований позиций сотрудников школы (например, «Backend Engineer»). Должности назначаются сотрудникам при найме и повышении и используются модулем персонала (staff) для описания структуры занятости.

Все эндпоинты модуля персонала доступны только для школ корпоративного сегмента (Corporate). Запрос от школы другого сегмента будет отклонён.

Требования к правам доступа

Чтение (list) требует права «Просмотр персонала» (StaffView). Создание, обновление и удаление требуют права «Управление персоналом» (StaffManage). Во всех случаях необходима аутентификация по токену и принадлежность школы к сегменту Corporate.

Сервисный пользователь должен быть аутентифицирован по токену и иметь соответствующие права доступа к указанной школе.

Название должности уникально в рамках школы без учёта регистра («Менеджер» и «менеджер» — одно и то же название). Попытка создать или переименовать должность в уже существующее название в этой же школе вернёт ошибку StaffPositionNameIsNotUniq.

Поле extId — внешний идентификатор должности из системы клиента (CRM/1C, например GUID). Уникален в рамках школы среди неудалённых записей (уникальный индекс school + extId). От 1 до 50 символов, не может содержать / и пробельные символы — значение используется в путях ext/{extId}.

Список должностей

GET /saas/v2/staff/position/list

Требуется аутентификация и право «Просмотр персонала» (StaffView).

Эндпоинт возвращает пагинированный список должностей. Параметры пагинации и фильтрации передаются как query-параметры.

Параметры

integer

Количество пропускаемых записей (offset-пагинация). Минимум 0.

integer

Количество возвращаемых записей на странице. От 1 до 1000.

integer

Номер страницы (альтернатива skip). Минимум 1.

integer[]

Фильтр по ID должностей. До 250 значений.

string

Поиск по названию должности. Максимум 50 символов. Поиск нечёткий (находит и частичные совпадения), поэтому для поиска конкретной должности по имени сравнивайте name найденных записей со своим значением без учёта регистра, а надёжнее — ищите по extIds.

string[]

Фильтр по списку внешних идентификаторов (extId). До 250 значений, каждое — максимум 50 символов.

enum

Направление сортировки по дате создания. Возможные значения: ASC, DESC. Аналогично работают параметры id и updatedAt.

Ответ

object

обязательно

Пагинированный объект: items (массив должностей), page, count, pages, isFirst, isLast, next, prev.

curl --location 'https://api.exode.biz/saas/v2/staff/position/list?take=10&page=1&search=Backend' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Authorization: Bearer YOUR_TOKEN'

const axios = require('axios');

async function getPositionList() {
  const { data } = await axios.get(
    'https://api.exode.biz/saas/v2/staff/position/list',
    {
      params: {
        take: 10,
        page: 1,
        search: 'Backend',
      },
      headers: {
        'Seller-Id': '{{ sellerId }}',
        'School-Id': '{{ schoolId }}',
        'Authorization': 'Bearer YOUR_TOKEN',
      },
    }
  );
  console.log(data.payload);
}

getPositionList();

{
  "success": true,
  "code": 200,
  "payload": {
    "page": 1,
    "count": 2,
    "pages": 1,
    "isFirst": true,
    "isLast": true,
    "items": [
      {
        "id": 4,
        "createdAt": "2026-07-02T11:15:47.216Z",
        "updatedAt": "2026-07-02T11:15:47.260Z",
        "archivedAt": null,
        "schoolId": 198,
        "name": "Staff Backend Engineer",
        "extId": "e2b4a1c0-7f3d-4b6a-9c2e-1d5f8a0b3c47"
      },
      {
        "id": 3,
        "createdAt": "2026-07-02T11:15:47.207Z",
        "updatedAt": "2026-07-02T11:15:47.207Z",
        "archivedAt": null,
        "schoolId": 198,
        "name": "Backend Engineer",
        "extId": null
      }
    ],
    "next": {
      "skip": 0,
      "take": 10,
      "page": 1
    },
    "prev": {
      "skip": 0,
      "take": 10,
      "page": 1
    }
  }
}

Создание должности

POST /saas/v2/staff/position/create

Требуется аутентификация и право «Управление персоналом» (StaffManage).

Параметры запроса

string

обязательно

Название должности. От 1 до 100 символов. Пробелы в начале и конце обрезаются автоматически. Должно быть уникальным в рамках школы.

string

Внешний идентификатор должности из системы клиента (CRM/1C). От 1 до 50 символов, не может содержать / и пробельные символы. Должен быть уникальным в рамках школы среди неудалённых записей.

curl --location 'https://api.exode.biz/saas/v2/staff/position/create' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "name": "Backend Engineer"
  }'

const axios = require('axios');

async function createPosition() {
  const { data } = await axios.post(
    'https://api.exode.biz/saas/v2/staff/position/create',
    {
      name: 'Backend Engineer',
    },
    {
      headers: {
        'Seller-Id': '{{ sellerId }}',
        'School-Id': '{{ schoolId }}',
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_TOKEN',
      },
    }
  );
  console.log(data.payload);
}

createPosition();

{
  "success": true,
  "code": 201,
  "payload": {
    "id": 3,
    "createdAt": "2026-07-02T11:15:47.207Z",
    "updatedAt": "2026-07-02T11:15:47.207Z",
    "archivedAt": null,
    "schoolId": 198,
    "name": "Backend Engineer",
    "extId": null
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffPositionNameIsNotUniq",
  "message": "Staff position name is not uniq",
  "error": "Staff position name is not uniq"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffPositionExtIdIsNotUniq",
  "message": "Staff position extId is not uniq",
  "error": "Staff position extId is not uniq"
}

{
  "code": 401,
  "success": false,
  "cause": "Forbidden",
  "error": "Forbidden seller resource - permissions StaffManage",
  "message": "Forbidden seller resource - permissions StaffManage"
}

Обновление должности

PUT /saas/v2/staff/position/{positionId}/update

Требуется аутентификация и право «Управление персоналом» (StaffManage).

Параметры

integer

обязательно

ID обновляемой должности в рамках школы.

string

Новое название должности. От 1 до 100 символов. Пробелы в начале и конце обрезаются автоматически. Должно быть уникальным в рамках школы.

string

curl --location --request PUT 'https://api.exode.biz/saas/v2/staff/position/4/update' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "name": "Staff Backend Engineer"
  }'

const axios = require('axios');

async function updatePosition() {
  const { data } = await axios.put(
    'https://api.exode.biz/saas/v2/staff/position/4/update',
    {
      name: 'Staff Backend Engineer',
    },
    {
      headers: {
        'Seller-Id': '{{ sellerId }}',
        'School-Id': '{{ schoolId }}',
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_TOKEN',
      },
    }
  );
  console.log(data.payload);
}

updatePosition();

{
  "success": true,
  "code": 200,
  "payload": {
    "id": 4,
    "createdAt": "2026-07-02T11:15:47.216Z",
    "updatedAt": "2026-07-02T11:15:47.260Z",
    "archivedAt": null,
    "schoolId": 198,
    "name": "Staff Backend Engineer",
    "extId": null
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffPositionNameIsNotUniq",
  "message": "Staff position name is not uniq",
  "error": "Staff position name is not uniq"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffPositionExtIdIsNotUniq",
  "message": "Staff position extId is not uniq",
  "error": "Staff position extId is not uniq"
}

Обновление должности по extId

PUT /saas/v2/staff/position/ext/{extId}/update

Требуется аутентификация и право «Управление персоналом» (StaffManage).

Эндпоинт-аналог обновления по ID: должность находится по внешнему идентификатору extId в рамках школы. Значение extId в пути должно быть URL-encoded.

Параметры

string

обязательно

Внешний идентификатор (extId) обновляемой должности в рамках школы. Должен быть URL-encoded.

string

Новый внешний идентификатор должности. От 1 до 50 символов, не может содержать / и пробельные символы. Должен быть уникальным в рамках школы среди неудалённых записей.

curl --location --request PUT 'https://api.exode.biz/saas/v2/staff/position/ext/e2b4a1c0-7f3d-4b6a-9c2e-1d5f8a0b3c47/update' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "name": "Staff Backend Engineer"
  }'

const axios = require('axios');

async function updatePositionByExtId() {
  const extId = encodeURIComponent('e2b4a1c0-7f3d-4b6a-9c2e-1d5f8a0b3c47');

  const { data } = await axios.put(
    `https://api.exode.biz/saas/v2/staff/position/ext/${extId}/update`,
    {
      name: 'Staff Backend Engineer',
    },
    {
      headers: {
        'Seller-Id': '{{ sellerId }}',
        'School-Id': '{{ schoolId }}',
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_TOKEN',
      },
    }
  );
  console.log(data.payload);
}

updatePositionByExtId();

{
  "success": true,
  "code": 200,
  "payload": {
    "id": 4,
    "createdAt": "2026-07-02T11:15:47.216Z",
    "updatedAt": "2026-07-02T11:15:47.260Z",
    "archivedAt": null,
    "schoolId": 198,
    "name": "Staff Backend Engineer",
    "extId": "e2b4a1c0-7f3d-4b6a-9c2e-1d5f8a0b3c47"
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffPositionNotFound",
  "message": "Staff position not found",
  "error": "Staff position not found"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffPositionNameIsNotUniq",
  "message": "Staff position name is not uniq",
  "error": "Staff position name is not uniq"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffPositionExtIdIsNotUniq",
  "message": "Staff position extId is not uniq",
  "error": "Staff position extId is not uniq"
}

Удаление должности

DELETE /saas/v2/staff/position/{positionId}/delete

Требуется аутентификация и право «Управление персоналом» (StaffManage).

Должность нельзя удалить, если на ней есть активные сотрудники (включая запланированный наём с будущей датой) — вернётся StaffPositionHasActiveEmployments. Сначала смените сотрудникам должность через promote или уволите их.

Параметры

integer

обязательно

ID удаляемой должности в рамках школы.

Ответ

integer

обязательно

Количество удалённых записей (1 при успешном удалении).

curl --location --request DELETE 'https://api.exode.biz/saas/v2/staff/position/4/delete' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Authorization: Bearer YOUR_TOKEN'

const axios = require('axios');

async function deletePosition() {
  const { data } = await axios.delete(
    'https://api.exode.biz/saas/v2/staff/position/4/delete',
    {
      headers: {
        'Seller-Id': '{{ sellerId }}',
        'School-Id': '{{ schoolId }}',
        'Authorization': 'Bearer YOUR_TOKEN',
      },
    }
  );
  console.log(data.payload);
}

deletePosition();

{
  "success": true,
  "code": 200,
  "payload": {
    "affected": 1
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffPositionHasActiveEmployments",
  "message": "Staff position has active employments",
  "error": "Staff position has active employments"
}

{
  "code": 401,
  "success": false,
  "cause": "Forbidden",
  "error": "Forbidden seller resource - permissions StaffManage",
  "message": "Forbidden seller resource - permissions StaffManage"
}

Удаление должности по extId

DELETE /saas/v2/staff/position/ext/{extId}/delete

Требуется аутентификация и право «Управление персоналом» (StaffManage).

Эндпоинт-аналог удаления по ID: должность находится по внешнему идентификатору extId в рамках школы. Значение extId в пути должно быть URL-encoded.

Параметры

string

обязательно

Внешний идентификатор (extId) удаляемой должности в рамках школы. Должен быть URL-encoded.

Ответ

integer

обязательно

Количество удалённых записей (1 при успешном удалении).

curl --location --request DELETE 'https://api.exode.biz/saas/v2/staff/position/ext/e2b4a1c0-7f3d-4b6a-9c2e-1d5f8a0b3c47/delete' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Authorization: Bearer YOUR_TOKEN'

const axios = require('axios');

async function deletePositionByExtId() {
  const extId = encodeURIComponent('e2b4a1c0-7f3d-4b6a-9c2e-1d5f8a0b3c47');

  const { data } = await axios.delete(
    `https://api.exode.biz/saas/v2/staff/position/ext/${extId}/delete`,
    {
      headers: {
        'Seller-Id': '{{ sellerId }}',
        'School-Id': '{{ schoolId }}',
        'Authorization': 'Bearer YOUR_TOKEN',
      },
    }
  );
  console.log(data.payload);
}

deletePositionByExtId();

{
  "success": true,
  "code": 200,
  "payload": {
    "affected": 1
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffPositionNotFound",
  "message": "Staff position not found",
  "error": "Staff position not found"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffPositionHasActiveEmployments",
  "message": "Staff position has active employments",
  "error": "Staff position has active employments"
}

Обновлено: 2026-09-25 13:43 UTC

Работа с API

Пользователи

Сотрудники (HR)

Группы

Курсы

Доступы и продажи

Отчеты и выгрузки

Кастомные поля

Формы

Нет нужного метода?

Все объекты

Заголовки запроса

Требования к правам доступа

Список должностей

Параметры

Ответ

Создание должности

Параметры запроса

Обновление должности

Параметры

Обновление должности по extId

Параметры

Удаление должности

Параметры

Ответ

Удаление должности по extId

Параметры

Ответ

​Заголовки запроса

​Требования к правам доступа

​Список должностей

​Параметры

​Ответ

​Создание должности

​Параметры запроса

​Обновление должности

​Параметры

​Обновление должности по extId

​Параметры

​Удаление должности

​Параметры

​Ответ

​Удаление должности по extId

​Параметры

​Ответ

Заголовки запроса

Требования к правам доступа

Список должностей

Параметры

Ответ

Создание должности

Параметры запроса

Обновление должности

Параметры

Обновление должности по extId

Параметры

Удаление должности

Параметры

Ответ

Удаление должности по extId

Параметры

Ответ