Удалить офис организации

Удаляет офис организации.

Примечание

Чтобы выполнить запрос, приложению требуется разрешение directory:write_offices — просмотр и изменение данных офисов.

Запрос

DELETE https://cloud-api.yandex.net/v1/directory/organizations/{org_id}/offices/{office_id}

Path-параметры

Имя параметра

Тип

Описание

org_id *

integer

Идентификатор организации.

office_id *

string

Идентификатор офиса.

Заголовки

Authorization: OAuth <токен>

Пример

Пример запроса
curl --request DELETE \
  --url https://cloud-api.yandex.net/v1/directory/organizations/167730/offices/c3e9a742-16bd-4f58-a201-8d4f7b1e2c93 \
  --header 'authorization: OAuth <токен>'

Ответ

Успешный ответ

Результатом корректного запроса является ответ с кодом 204 без тела.

204 No Content — офис успешно удален.

Неуспешный ответ

Ошибки могут быть со следующими HTTP-статусами:

  • 400 Bad Request — параметры запроса не заданы или заданы неверно;
  • 401 Unauthorized — пользователь не авторизован;
  • 403 Forbidden — у пользователя или приложения нет прав на удаление офиса;
  • 404 Not Found — запрашиваемая организация или офис не найдены;
  • 422 Unprocessable Entity — переданы некорректные данные (например, неверное значение поля);
  • 500 Internal Server Error — ошибка произошла на стороне сервера (в этом случае попробуйте повторно отправить запрос через некоторое время).