UpdateDepartment

Примечание

Вызов метода доступен только администраторам организации.

Изменяет данные подразделения организации.

POST /admin/UpdateDepartment

Query Parameters:

• boxId – идентификатор ящика организации в формате GUID.

• departmentId – идентификатор подразделения организации.

Request Headers:

• Authorization – данные, необходимые для авторизации.

Request Body:

Тело запроса должно содержать данные для изменения свойств подразделения организации, представленные структурой DepartmentToUpdate.

Status Codes:

• 200 OK – операция успешно завершена.

• 400 Bad Request – данные в запросе имеют неверный формат или отсутствуют обязательные параметры.

• 401 Unauthorized – в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.

• 402 Payment Required – у организации с указанным идентификатором boxId закончилась подписка на API.

• 403 Forbidden – доступ к ящику с предоставленным авторизационным токеном запрещен или запрос сделан не от имени администратора.

• 404 Not Found – не найдены организация или подразделение с указанным идентификатором.

• 405 Method Not Allowed – используется неподходящий HTTP-метод.

• 500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка.

Response Body:

Тело ответа содержит доступные для администратора данные подразделения, представленные структурой 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

Пример тела запроса:

{
    "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 — изменяет данные подразделения организации (доступно только администраторам ящика)