Удаление соорганизаторов видеовстречи

Удаляет пользователей с указанными электронными адресами из списка соорганизаторов видеовстречи.

Если вы не знаете электронных адресов соорганизаторов, вы можете удалить всех соорганизаторов встречи с помощью метода Обновление.

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

Запрос

DELETE

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

Path-параметры

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

Тип

Описание

id

string

Идентификатор видеовстречи

Query-параметры

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

Тип

Описание

cohost_emails

string

Список электронных адресов соорганизаторов, разделённых знаком ,.

Максимальное количество электронных адресов: 30.

Заголовки

Authorization: OAuth <токен>

Пример

https://cloud-api.yandex.net/v1/telemost-api/conferences/{id}/cohosts?cohost_emails=user1@yandex.ru,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-статусами:

  • 400 Bad Request

    • {"error": "UserIsConferenceOwner", "details": {"email": "<'адрес_организатора_видеовстречи'>"}} — в поле details.email запроса указан электронный адрес организатора видеовстречи, операции над организатором недоступны.

  • 403 Forbidden

    • {"error": "ApiRestrictedToOrganizations"} — доступ запрещен, так как вы не являетесь пользователем Яндекс 360 для бизнеса или ваш аккаунт зарегистрирован не на домене организации.
    • {"error": "ConferenceAccessForbidden"} — у вас нет доступа к запрашиваемой видеовстрече.

  • 404 Not Found

    • {"error": "ConferenceNotFound"} — Запрошенная видеовстреча не найдена.
    • {"error": "NoSuchUserPrincipalsFound", "details": {"emails": "неверный_адрес1;неверный_адрес2;..."}} — некоторые из переданных электронных адресов соорганизаторов не принадлежат пользователям с аккаунтами на Яндексе, некорректные адреса перечислены в поле details.emails через ;.

  • 4xx

    • незадокументированные ошибки, например некорректный запрос, слишком большое количество запросов или проблемы с авторизацией.
Предыдущая
Добавление в список
Следующая
Просмотр