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

Создает новую переговорку организации.

Примечание

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

Запрос

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

Path-параметры

Имя параметра	Тип	Описание
org_id *	integer	Идентификатор организации.

Заголовки

Authorization: OAuth <токен>
Content-Type: application/json

Тело

Имя параметра	Тип	Описание
name	string	Название переговорки.
email	string	Адрес электронной почты переговорки.
office_id	string	Идентификатор офиса, в котором расположена переговорка.
capacity	integer	Вместимость переговорки (количество человек).
floor	integer	Этаж, на котором расположена переговорка.
can_book	boolean	Признак возможности бронирования переговорки: `true` — можно забронировать; `false` — бронирование недоступно.
description	string	Описание переговорки.

Пример

Пример запроса

curl --request POST \
  --url https://cloud-api.yandex.net/v1/directory/organizations/167730/rooms \
  --header 'authorization: OAuth <токен>' \
  --header 'content-type: application/json' \
  --data '{
  "name": "Байкал",
  "email": "baikal@sdfdafsd.auto.connect-tk.tk",
  "office_id": "c3e9a742-16bd-4f58-a201-8d4f7b1e2c93",
  "capacity": 12,
  "floor": 3,
  "can_book": true,
  "description": "Большая переговорка с видеосвязью"
}'

Ответ

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

Результатом корректного запроса является ответ с кодом 201 и телом в формате JSON, где содержится идентификатор созданной переговорки.

201 Created — переговорка успешно создана.

Поле	Тип	Описание
id	string	Идентификатор созданной переговорки.

Пример

Пример ответа

{
  "id": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d"
}

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

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

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

Была ли статья полезна?

Получить список переговорок

Изменить параметры переговорки