# Изменить подразделение

> Переименование, перенос в другое подразделение вместе со всем содержимым, смена руководителя.

export default function Layout(props) {
  const { OpenAPIPage } = props.components ?? {};
  return (
    <>
      {props.children}
      ## Изменить подразделение

`PATCH /api/v1/security/org/units/{id}`

Переименование, перенос в другое подразделение вместе со всем содержимым, смена руководителя.

**Авторизация:** dpop или oauth2: `security.users:read`, `security.users:write`

**Параметры**

| Имя | Где | Обязательный | Тип | Описание |
| --- | --- | --- | --- | --- |
| `id` | path | да | string (uuid) | Идентификатор подразделения |
| `idempotency-key` | header | нет | string | Ключ идемпотентности для безопасного повтора запроса: 8–255 символов из набора A-Za-z0-9_.:+/=-, ответ кэшируется на 24 ч |

**Тело запроса** (`application/json`, обязательное): OrgUnitPatch
- `headUserId`: string (uuid), nullable — Новый руководитель
- `name`: string — Новое название
- `parentId`: string (uuid), nullable — Новое вышестоящее подразделение
- `position`: integer — Новый порядок

**Ответы**

- `200` — Подразделение (`application/json`, OrgUnit)
  - `headUserId`: string (uuid), nullable, обязательное — Руководитель подразделения
  - `id`: string (uuid), обязательное — Идентификатор подразделения
  - `name`: string, обязательное — Название, например «Судебная практика»
  - `parentId`: string (uuid), nullable, обязательное — Вышестоящее подразделение; null — верхний уровень
  - `position`: integer, обязательное — Порядок среди подразделений одного уровня
- `400` — Некорректный запрос: не прошла валидация параметров или тела (`application/problem+json`, ProblemDetails)
- `401` — Токен отсутствует, недействителен или истёк (`application/problem+json`, ProblemDetails)
- `403` — Недостаточно прав или scope (`application/problem+json`, ProblemDetails)
- `429` — Превышен лимит запросов, повторите через Retry-After секунд (`application/problem+json`, ProblemDetails)

    </>
  );
}