Управление сотрудниками

Что такое Employee Management

Employee Management — это программный доступ к управлению сотрудниками бизнес-организации через API. Раздел позволяет:

заводить и удалять аккаунты сотрудников, делать массовый импорт по списку email;
получать список сотрудников с пагинацией, фильтрами и командами;
создавать и удалять команды;
добавлять и удалять сотрудников из команд.

Система ролей

Запрос к API выполняется не от имени пользователя напрямую, а от имени API-ключа. Ключ действует с ролью того пользователя, который его создал. Поэтому «кто вызывает» — это ключ, сгенерированный пользователем с ролью Owner, Admin или Member; именно эта роль определяет доступ.

Роли образуют иерархию по уровню прав (сверху вниз — от большего к меньшему):

Owner (Владелец) — высшая роль;
Admin (Администратор);
Member (Участник) — низшая роль.

Стрелка «ключ видит и управляет» направлена вниз — ключ действует только над сотрудниками строго ниже своей роли. Обратных стрелок нет: ключ не видит и не управляет сотрудниками равной или более высокой роли.

Кто кем может управлять и кого видит

Единое правило для всех эндпоинтов раздела. «Кто вызывает» — это ключ, созданный пользователем с некоторой ролью:

ключ видит и управляет только сотрудниками, чья роль строго ниже роли создателя ключа;
сотрудников с равной или более высокой ролью (в том числе самого создателя ключа) ключ видеть и изменять не может;
ключ, созданный пользователем с самой низкой ролью (Member), доступа к разделу не имеет.

Роль создателя ключа	Ключ видит и управляет	Доступ к разделу
Owner	Admin и Member	да
Admin	Только Member	да
Member	Никого	нет (403)

Правило работает на двух уровнях:

Доступ к запросу. Если ключ создан пользователем самой низкой роли (или в личном аккаунте), любой запрос раздела вернёт 403.
Область видимости и действия. В списке сотрудников возвращаются только те, кто строго ниже по роли, чем создатель ключа. При удалении сотрудника или изменении его команды операция над сотрудником равной или более высокой роли отклоняется (в батч-эндпоинтах — статусом/причиной forbidden по этому сотруднику).