Изменить параметры переговорки организации
Изменяет название, офис, вместимость, этаж, возможность бронирования или описание переговорки организации.
Примечание
Чтобы выполнить запрос, приложению требуется разрешение directory:write_rooms — просмотр и изменение данных переговорок.
Запрос
PATCH https://cloud-api.yandex.net/v1/directory/organizations/{org_id}/rooms/{room_id}
Path-параметры
|
Имя параметра |
Тип |
Описание |
|
org_id * |
integer |
Идентификатор организации. |
|
room_id * |
string |
Идентификатор переговорки. |
Заголовки
Authorization: OAuth <токен>
Content-Type: application/json
Тело
|
Имя параметра |
Тип |
Описание |
|
name |
string |
Название переговорки. |
|
office_id |
string |
Идентификатор офиса, в котором расположена переговорка. |
|
capacity |
integer |
Вместимость переговорки (количество человек). |
|
floor |
integer |
Этаж, на котором расположена переговорка. |
|
can_book |
boolean |
Признак возможности бронирования переговорки:
|
|
description |
string |
Описание переговорки. |
Пример
Пример запроса
curl --request PATCH \
--url https://cloud-api.yandex.net/v1/directory/organizations/167730/rooms/a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d \
--header 'authorization: OAuth <токен>' \
--header 'content-type: application/json' \
--data '{
"name": "Байкал",
"office_id": "c3e9a742-16bd-4f58-a201-8d4f7b1e2c93",
"capacity": 10,
"floor": 3,
"can_book": true,
"description": "Переговорка с видеосвязью"
}'
Ответ
Успешный ответ
Результатом корректного запроса является ответ с кодом 204 без тела.
204 No Content — переговорка успешно обновлена.
Неуспешный ответ
Ошибки могут быть со следующими HTTP-статусами:
400 Bad Request— параметры запроса не заданы или заданы неверно;401 Unauthorized— пользователь не авторизован;403 Forbidden— у пользователя или приложения нет прав на изменение переговорки;404 Not Found— запрашиваемая организация или переговорка не найдены;415 Unsupported Media Type— ошибка в теле запроса;422 Unprocessable Entity— переданы некорректные данные (например, неверное значение поля);500 Internal Server Error— ошибка произошла на стороне сервера (в этом случае попробуйте повторно отправить запрос через некоторое время).