Удалить переговорку организации
Удаляет переговорку организации.
Примечание
Чтобы выполнить запрос, приложению требуется разрешение 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— ошибка произошла на стороне сервера (в этом случае попробуйте повторно отправить запрос через некоторое время).
Была ли статья полезна?
Предыдущая
Следующая