Skip to main content

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

​
Authorization
string
required
API токен сервисного пользователя в формате Bearer. Получите токен в панели администратора школы. Формат: Bearer YOUR_TOKEN.
​
Seller-Id
string
required
Уникальный идентификатор продавца в системе. Используется для разграничения доступа между разными продавцами.
​
School-Id
string
required
Уникальный идентификатор школы в системе. Определяет контекст выполнения операции.
Руководитель департамента привязывается к активному трудоустройству сотрудника. У департамента может быть несколько руководителей, но только один из них — основной (isPrimary).
Все эндпоинты модуля staff доступны только для школ сегмента Corporate. Для остальных сегментов запрос вернёт ошибку 403 Forbidden.

​
Назначить руководителя

POST /saas/v2/staff/department-manager/set
Требуется аутентификация и право StaffManage. Эндпоинт работает как upsert: если руководитель для пары департамент + трудоустройство уже назначен — обновляется только флаг isPrimary, иначе создаётся новая запись. При isPrimary=true предыдущий основной руководитель департамента автоматически снимается с этой роли (флаг isPrimary у него сбрасывается в false). Департамент и трудоустройство должны принадлежать школе, трудоустройство должно быть активным.

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

​
departmentId
integer
required
ID департамента. Департамент должен принадлежать школе.
​
employmentId
integer
required
ID активного трудоустройства сотрудника, который назначается руководителем.
​
isPrimary
boolean
Назначить сотрудника основным руководителем департамента. По умолчанию false. При true предыдущий основной руководитель автоматически перестаёт быть основным.
curl --location 'https://api.exode.biz/saas/v2/staff/department-manager/set' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "departmentId": 4,
    "employmentId": 9,
    "isPrimary": true
  }'

{
  "success": true,
  "code": 201,
  "payload": {
    "id": 2,
    "createdAt": "2026-07-02T11:15:47.328Z",
    "updatedAt": "2026-07-02T11:15:47.328Z",
    "archivedAt": null,
    "schoolId": 198,
    "departmentId": 4,
    "employmentId": 9,
    "isPrimary": true
  }
}

​
Снять руководителя

DELETE /saas/v2/staff/department-manager/{managerId}/remove
Требуется аутентификация и право StaffManage. Удаляет запись руководителя департамента (мягкое удаление). После снятия основного руководителя департамент остаётся без основного руководителя, пока не будет назначен новый.

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

​
managerId
integer
required
ID записи руководителя департамента (поле id из ответа на назначение).

​
Ответ

​
deleted
boolean
required
Флаг успешного снятия руководителя.
curl --location --request DELETE 'https://api.exode.biz/saas/v2/staff/department-manager/2/remove' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Authorization: Bearer YOUR_TOKEN'

{
  "success": true,
  "code": 200,
  "payload": {
    "deleted": true
  }
}

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

Модуль staff доступен только для школ сегмента Corporate. Для назначения и снятия руководителей департаментов требуется право StaffManage.
Сервисный пользователь должен быть аутентифицирован по токену и иметь соответствующие права доступа к указанной школе.