Перейти к основному содержимому

Удалить сотрудников из узла оргструктуры

DELETE 
/api/v1/clients/:clientId/orgStructures/:id/elements/:elementId/employees

Описание метода​

Массово удаляет вхождения сотрудников из указанного узла оргструктуры. Поведение fail-fast: все указанные сотрудники должны состоять в узле, иначе операция отклоняется целиком. Возвращает обновлённые метаданные структуры и затронутые узлы (сам узел + предки до корня) с пересчитанными счётчиками.

Для узла типа EMPLOYEE_AS_NODE удаление текущего HEAD_MANAGER (ключевого сотрудника, заданного при создании) запрещено — такой узел удаляется целиком отдельным запросом удаления узла; не-HEAD_MANAGER сотрудников из EMPLOYEE_AS_NODE-узла удалять можно.

Эндпоинт не идемпотентен: повторный вызов с теми же employeeIds приведёт к ошибке, так как один из сотрудников уже не состоит в узле. Это намеренный fail-fast — сигнал клиенту, что состояние изменилось.

Валидации запроса​

  • Тело запроса задано; employeeIds не пуст, элементы не null.

  • IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента соответствует формату UUID; клиент существует, не удалён, к нему относится пользователь, выполняющий операцию.

  • У пользователя клиента есть право ORG_STRUCTURES_UPDATE.

  • IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. оргструктуры соответствует формату UUID; оргструктура существует, принадлежит клиенту, не является Юридической, находится в статусе DRAFT.

  • Если version задана — совпадает с актуальной версией оргструктуры в БД.

  • Режим редактирования оргструктуры свободен либо захвачен инициатором операции.

  • IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. узла соответствует формату UUID; узел существует в указанной оргструктуре.

  • Все указанные сотрудники состоят в этом узле.

  • Удаление текущего HEAD_MANAGER из узла типа EMPLOYEE_AS_NODE запрещено.

  • Функционал оргструктур включён в настройках клиента.

Request​

Responses​

Успешная операция.