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

Обновить метаданные оргструктуры

PUT 
/api/v1/clients/:clientId/orgStructures/:id

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

Обновляет метаданные оргструктуры: название, описание, назначение, тип доступа, цветовую схему. externalId неизменяем после создания — изменение требует удаления и создания оргструктуры заново.

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

Если все переданные поля совпадают с текущими значениями (no-op), версия не увеличивается и возвращается текущая карточка без изменений.

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

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

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

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

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

  • Оргструктура не является Юридической.

  • Оргструктура не находится в статусе ARCHIVED.

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

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

  • Если оргструктура опубликована — у неё нет активной копии-черновика (правка опубликованной напрямую допустима только при отсутствии связанной копии).

  • Если name задано — не пустое после trim, не длиннее 500 символов, не начинается с * (для обычной оргструктуры), не совпадает с зарезервированным именем Юридической структуры, уникально в клиенте среди оргструктур любого статуса. Для черновика-копии (basedOnId != null) проверка резервного префикса * пропускается, а уникальность и резерв проверяются по нормализованному имени без *.

  • Если description задано — не длиннее 1000 символов; пустое или blank-значение трактуется как очистка.

  • Если purpose задано — не длиннее 500 символов.

  • Если colourSchema задана — входит в список разрешённых цветовых схем.

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

Request​

Responses​

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