Добавление соорганизаторов к видеовстрече

Добавляет пользователей в список соорганизаторов видеовстречи.

Чтобы выполнить запрос, приложению требуется разрешение telemost-api:conferences.update.

Запрос

PATCH

https://cloud-api.yandex.net/v1/telemost-api/conferences/{id}/cohosts

Имя параметра	Тип	Описание
`id`	`string`	Идентификатор видеовстречи

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

{
  "cohosts": [
    {
      "email": "string"
    }
  ]
}

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

Обязат.

Тип

Описание

Ограничения, значение по умолчанию

cohosts[]

Нет

array of object

Список соорганизаторов встречи

Максимальная длина 30 элементов.

Если параметр не указан или указан пустой список, встреча создается без соорганизаторов.

cohosts[].email

Нет

string

Адрес электронной почты соорганизатора

Соорганизатором встречи может быть только пользователь с аккаунтом на Яндексе.

{
  "cohosts": [
    {
      "email": "user1@yandex.ru"
    },
    {
      "email": "user2@org-domain.ru"
    }
  ]
}

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

204 No Content — запрос выполнен успешно.

В случае ошибки возвращается сообщение следующего содержания:

{
  "error": "string",
  "message": "string",
  "description": "string",
  "details": "object"
}

Имя параметра	Тип	Описание
`error`	`string`	Код ошибки
`message`	`string`	Сообщение об ошибке
`description`	`object`	Техническое описание ошибки
`details`	`object`	[Опциональный параметр] Дополнительная информация об ошибке

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

403 Forbidden
- {"error": "ApiRestrictedToOrganizations"} — Доступ запрещен, так как вы не являетесь пользователем Яндекс 360 для бизнеса или ваш аккаунт зарегистрирован не на домене организации.
- {"error": "ConferenceAccessForbidden"} — У вас нет доступа к запрашиваемой видеовстрече.
404 Not Found
- {"error": "ConferenceNotFound"} — Запрошенная видеовстреча не найдена.
- {"error": "NoSuchUserPrincipalsFound", "details": {"emails": "неверный_адрес1;неверный_адрес2;..."}} — Некоторые из переданных электронных адресов соорганизаторов не принадлежат пользователям с аккаунтами на Яндексе. Некорректные адреса перечислены в поле details.emails через ;.
4xx
- Незадокументированные ошибки, например некорректный запрос, слишком большое количество запросов или проблемы с авторизацией.