Метод: removeDepartment
Нельзя удалить подразделение:
- в котором есть пользователи,
- которым управляет администратор подразделения или автор,
- если оно является корневым.
Параметры запроса
| Параметр | Тип | Описание |
|---|---|---|
| token (обязательный) | string | Токен доступа. Вы можете получить токен с помощью запроса |
| departmentId (обязательный) | string | ID подразделения, которое нужно удалить |
Права пользователя для выполнения запроса
Владелец аккаунта, Администратор аккаунта, Администратор подразделения или роль с индивидуальными настройками, которые позволяют удалять подразделения.
Администратор подразделения может удалить только подразделение, которым управляет, и его дочерние подразделения.
Возвращаемые значения
После того, как запрос успешно обработан, система отправляет объект со следующими свойствами:
| Параметр | Тип | Описание |
|---|---|---|
| success | bool | True, если подразделение было удалено |
Возможные ошибки
Ошибка | Описание |
|---|---|
| Permission denied | У пользователя недостаточно прав для удаления подразделения |
| Wrong parameters | Подразделение с указанным ID не найдено, содержит пользователей или является корневым подразделением |
Пример запроса
<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
xmlns="https://ispringlearn.com/go/services/api/soap">
<SOAP-ENV:Body>
<RemoveDepartmentRequest>
<credentials>
<token>p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE</token>
</credentials>
<departmentId>string</departmentId>
</RemoveDepartmentRequest>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Пример ответа
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
xmlns="https://ispringlearn.com/go/services/api/soap">
<SOAP-ENV:Body>
<successResult>
<success>true</success>
</successResult>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>