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

Заархивировать оргструктуру по внешнему ID

PUT 
/api/v1/clients/:clientId/orgStructuresByExternalId/:externalId/archive

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

Переводит оргструктуру, найденную по externalId, в статус ARCHIVED. Если оргструктура уже архивирована — операция no-op: возвращается текущее состояние без изменения версии.

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

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

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

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

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

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

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

  • Оргструктура не используется в настройках автоподстановки руководителей ни одного шаблона маршрута подписания.

  • Если оргструктура опубликована — у неё нет связанной незавершённой копии-черновика.

  • Оргструктура не является копией-черновиком (basedOnId != null).

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

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

Request​

Responses​

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