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

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

DELETE 
/api/v1/clients/:clientId/orgStructuresByExternalId/:externalId

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

Удаляет оргструктуру, найденную по externalId, в статусе DRAFT или ARCHIVED. Удаление опубликованной оргструктуры запрещено — сначала её нужно заархивировать. Удаление допустимо, если режим редактирования свободен либо захвачен инициатором операции; чужой режим блокирует удаление.

Для черновика-копии опубликованной оргструктуры (basedOnId != null) удаление снимает связку с оригиналом — это штатный способ отменить незавершённое редактирование. Оригинал в статусе PUBLISHED при этом не затрагивается.

Удаление выполняется одной транзакцией: сначала удаляются вхождения сотрудников и узлы оргструктуры, затем сама запись. Снепшоты публикаций удаляются каскадно на уровне БД.

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

  • Тело запроса задано.

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

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

  • Оргструктура с заданным externalId существует и принадлежит клиенту.

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

  • Статус оргструктуры не PUBLISHED.

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

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

Request​

Responses​

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