Удалить переговорку организации

Удаляет переговорку организации.

Примечание

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

Запрос

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

Path-параметры

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

Тип

Описание

org_id *

integer

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

room_id *

string

Идентификатор переговорки.

Заголовки

Authorization: OAuth <токен>

Пример

Пример запроса
curl --request DELETE \
  --url https://cloud-api.yandex.net/v1/directory/organizations/167730/rooms/a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d \
  --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 — ошибка произошла на стороне сервера (в этом случае попробуйте повторно отправить запрос через некоторое время).