Удалить отдел

Внимание. Сервис Яндекс Коннект больше не поддерживается. Directory API прекратит работу с 1 апреля 2023 года. С 24 марта доступность сервиса будет ограничена.

Для управления организациями, пользователями и доменами используйте сервис Яндекс 360 для бизнеса.

Документация API 360

Запрос позволяет удалить отдел.

Ограничение.

Запрос может быть выполнен только если:

  • приложение имеет разрешение на управление отделами;

  • запрос выполняется от имении администратора;

  • в отделе нет ни одного сотрудника.

Формат запроса

Чтобы удалить отдел, используйте HTTP-запрос с методом DELETE:

DELETE /v6/departments/<department_id>/
Host: https://api.directory.yandex.net
Authorization: OAuth <токен>
X-Org-ID: <идентификатор организации>
Ресурс
<department_id>

Идентификатор отдела, который вы удаляете.

Заголовки запроса
Host

Адрес узла, предоставляющего API:

https://api.directory.yandex.net
Authorization

OAuth-токен в формате OAuth <значение токена>, например:

OAuth 0c4181a7c2cf4521964a72ff57a34a07
X-Org-ID

Идентификатор организации. Заголовок необходимо передавать только если запрос выполняется от имени администратора нескольких организаций.

Формат ответа

В случае успешного выполнения запроса API возвращает ответ с кодом 200.