UpdateDepartment
к сведению
Вызов метода доступен только администраторам организации.
Изменяет данные подразделения организации.
POST /admin/UpdateDepartment
Параметры запроса
boxId— идентификатор ящика организации в формате GUID.departmentId— идентификатор подразделения организации.
Заголовки запроса
Authorization— данные, необходимые для авторизации.
Тело запроса
Тело запроса должно содержать данные для изменения свойств подразделения организации, представленные структурой DepartmentToUpdate.
Коды ответа
200— операция успешно завершена.400— данные в запросе имеют неверный формат или отсутствуют обязательные параметры.401— в запросе отсутствует HTTP-заголовокAuthorizationили в этом заголовке содержатся некорректные авторизационные данные.402— у организации с указанным идентификаторомboxIdзакончилась подписка на API.403— доступ к ящику с предоставленным авторизационным токеном запрещен или запрос сделан не от имени администратора.404— не найден ящик с указанным идентификатором, или изменяемое подразделение отсутствует или удалено, или указанное родительское подразделение отсутствует, удалено или принадлежит другому ящику.405— используется неподходящий HTTP-метод.409— новое значение КПП уже используется другим подразделением, или в качестве родительского указано само подразделение или его дочернее подразделение, или изменяется головное подразделение организации.415— тип содержимого запроса не поддерживается.429— превышено ограничение на количество запросов в единицу времени.500— при обработке запроса возникла непредвиденная ошибка.
Тело ответа
Тело ответа содержит доступные для администратора данные подразделения, представленные структурой Department.
Примеры использования
Пример HTTP-запроса:
POST /admin/UpdateDepartment?boxid={{boxId}}&departmentId={{departmentId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Content-Type: application/json; charset=utf-8
Accept: application/json
Пример тела запроса:
{
"ParentDepartment": {
"ParentDepartmentId": "17969b71-a3a1-4484-a4f0-5091931afc3d"
},
"DepartmentNaming": {
"Name": "Отдел кадров",
"Abbreviation": "ОК"
}
}
Примеры тела ответа:
{
"Id": "6d710055-9b5d-4bc0-ba2f-9e54adda034e",
"ParentDepartmentId": "17969b71-a3a1-4484-a4f0-5091931afc3d",
"Name": "Отдел кадров",
"Abbreviation": "ОК",
"Routing": {
"Kpp": false,
"Address": false
},
"CreationTimestamp": {
"Ticks": 638568885150838885
}
}
См. также
Инструкции:
Методы для работы с подразделениями:
- CreateDepartment — создает подразделение организации (доступно только администраторам ящика)
- DeleteDepartment — удаляет подразделение организации (доступно только администраторам ящика)
- GetDepartment (V2) — возвращает данные подразделения организации по указанному идентификатору
- GetDepartments — возвращает список подразделений организации (доступно только администраторам ящика)
- UpdateDepartment — изменяет данные подразделения организации (доступно только администраторам ящика)