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

Перезаписывает список соорганизаторов видеовстречи. Все текущие соорганизаторы перестают ими быть, вместо них соорганизаторами становятся пользователи из нового списка.

С помощью этого метода можно удалить всех соорганизаторов встречи, даже если вам неизвестны их электронные адреса. Для этого отправьте в теле запроса пустой список.

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

Request

PUT

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

Path parameters

Name

Description

Type: string

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

Example: ``

Body

application/json

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

Name

Description

cohosts

Type: ApiCohost[]

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

Example

[
  {
    "email": "example"
  }
]

ApiCohost

Name

Description

email

Type: string

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

Example: example

Example

{
  "email": "example"
}

Responses

204 No Content

400 Bad Request

Тип и идентификатор сущности внешней встречи должны быть переданы вместе

Body

application/json

{
  "error": "example",
  "description": "example",
  "message": "example",
  "details": {}
}

Name	Description
description	Type: string Техническое описание ошибки Example: `example`
error	Type: string Уникальный код ошибки Example: `example`
message	Type: string Человекочитаемое описание ошибки Example: `example`
details	Type: object Дополнительные детали ошибки Example `{}`

401 Unauthorized

Не авторизован.

Body

application/json

{
  "error": "example",
  "description": "example",
  "message": "example",
  "details": {}
}

Name	Description
description	Type: string Техническое описание ошибки Example: `example`
error	Type: string Уникальный код ошибки Example: `example`
message	Type: string Человекочитаемое описание ошибки Example: `example`
details	Type: object Дополнительные детали ошибки Example `{}`

402 Payment Required

Трансляции недоступны на вашем тарифе.

Body

application/json

{
  "error": "example",
  "description": "example",
  "message": "example",
  "details": {}
}

Name	Description
description	Type: string Техническое описание ошибки Example: `example`
error	Type: string Уникальный код ошибки Example: `example`
message	Type: string Человекочитаемое описание ошибки Example: `example`
details	Type: object Дополнительные детали ошибки Example `{}`

403 Forbidden

Не удалось авторизовать переговорную.

Body

application/json

{
  "error": "example",
  "description": "example",
  "message": "example",
  "details": {}
}

Name	Description
description	Type: string Техническое описание ошибки Example: `example`
error	Type: string Уникальный код ошибки Example: `example`
message	Type: string Человекочитаемое описание ошибки Example: `example`
details	Type: object Дополнительные детали ошибки Example `{}`

404 Not Found

Пресет матрицы пермиссий не найден.

Body

application/json

{
  "error": "example",
  "description": "example",
  "message": "example",
  "details": {}
}

Name	Description
description	Type: string Техническое описание ошибки Example: `example`
error	Type: string Уникальный код ошибки Example: `example`
message	Type: string Человекочитаемое описание ошибки Example: `example`
details	Type: object Дополнительные детали ошибки Example `{}`

406 Not Acceptable

Ресурс не может быть представлен в запрошенном формате.

Body

application/json

{
  "error": "example",
  "description": "example",
  "message": "example",
  "details": {}
}

Name	Description
description	Type: string Техническое описание ошибки Example: `example`
error	Type: string Уникальный код ошибки Example: `example`
message	Type: string Человекочитаемое описание ошибки Example: `example`
details	Type: object Дополнительные детали ошибки Example `{}`

409 Conflict

Трансляция в неподходящем для операции состоянии.

Body

application/json

{
  "error": "example",
  "description": "example",
  "message": "example",
  "details": {}
}

Name	Description
description	Type: string Техническое описание ошибки Example: `example`
error	Type: string Уникальный код ошибки Example: `example`
message	Type: string Человекочитаемое описание ошибки Example: `example`
details	Type: object Дополнительные детали ошибки Example `{}`

410 Gone

Сессия пользователя не активна.

Body

application/json

{
  "error": "example",
  "description": "example",
  "message": "example",
  "details": {}
}

Name	Description
description	Type: string Техническое описание ошибки Example: `example`
error	Type: string Уникальный код ошибки Example: `example`
message	Type: string Человекочитаемое описание ошибки Example: `example`
details	Type: object Дополнительные детали ошибки Example `{}`

415 Unsupported Media Type

Неподдерживаемый формат данных в теле запроса.

Body

application/json

{
  "error": "example",
  "description": "example",
  "message": "example",
  "details": {}
}

Name	Description
description	Type: string Техническое описание ошибки Example: `example`
error	Type: string Уникальный код ошибки Example: `example`
message	Type: string Человекочитаемое описание ошибки Example: `example`
details	Type: object Дополнительные детали ошибки Example `{}`

429 Too Many Requests

Слишком много запросов.

Body

application/json

{
  "error": "example",
  "description": "example",
  "message": "example",
  "details": {}
}

Name	Description
description	Type: string Техническое описание ошибки Example: `example`
error	Type: string Уникальный код ошибки Example: `example`
message	Type: string Человекочитаемое описание ошибки Example: `example`
details	Type: object Дополнительные детали ошибки Example `{}`

503 Service Unavailable

Сейчас сервис перегружен, но мы уже работаем над этой проблемой.

Body

application/json

{
  "error": "example",
  "description": "example",
  "message": "example",
  "details": {}
}

Name	Description
description	Type: string Техническое описание ошибки Example: `example`
error	Type: string Уникальный код ошибки Example: `example`
message	Type: string Человекочитаемое описание ошибки Example: `example`
details	Type: object Дополнительные детали ошибки Example `{}`

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

Заменить список

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

Чтобы заменить текущий список соорганизаторов, передайте новый список в поле cohosts. Пользователи, которых нет в новом списке, перестанут быть соорганизаторами.

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

Чтобы удалить всех соорганизаторов, передайте в поле cohosts пустой массив:

{
  "cohosts": []
}

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

Просмотр

Добавление в список