---
metadata:
  - name: generator
    content: Diplodoc Platform v5.61.1
alternate:
  - https://yandex.com/dev/telemost/doc/ru/conferences/conference-read.md
  - href: https://yandex.com/dev/telemost/doc/ru/conferences/conference-read.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.com/dev/telemost/doc/ru/llms.txt?revision=r21356348
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/telemost/doc/ru/llms.txt?revision=r21356348

<!-- source: ru/openapi/telemost_api/ApiConferenceGet.md -->
<div class="openapi">

# Просмотр параметров видеовстречи

<!-- markdownlint-disable-file -->

<p>Получает данные о видеовстрече и трансляции:</p>
<ul>
<li>ссылку для подключения;</li>
<li>уровень доступа комнаты ожидания;</li>
<li>данные трансляции;</li>
<li>SIP-реквизиты (<code>sip_uri_meeting</code>, <code>sip_uri_telemost</code>, <code>sip_id</code>) для подключения с оборудования.</li>
</ul>

## Request

<div class="openapi__requests">

<div class="openapi__request__wrapper" style="--method: var(--dc-openapi-methods-get);margin-bottom: 12px">

<div class="openapi__request">

GET {.openapi__method}
```text translate=no
https://cloud-api.yandex.net/v1/telemost-api/conferences/{id}
```

</div>

</div>

</div>

### Path parameters

#|
|| **Name** | **Description** ||
||

_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

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

_Example:_{.json-schema-reset .json-schema-example} ``
{.table-cell}
||
|#{.json-schema-properties}

## Responses

<div class="openapi__response__code__200">

## 200 OK

OK

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "id": "example",
  "join_url": "example",
  "access_level": "PUBLIC",
  "waiting_room_level": "PUBLIC",
  "live_stream": {
    "watch_url": "example",
    "access_level": "PUBLIC",
    "title": "example",
    "description": "example"
  },
  "is_auto_summarization_enabled": true,
  "should_create_public_chat_if_not_exists": true
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_access_level_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

<p>Устаревшее поле, используйте <code>waiting_room_level</code>.</p>
<p>Настройка уровня доступа:</p>
<ul>
<li><code>PUBLIC</code> — комната ожидания выключена, все пользователи смогут сразу присоединиться к встрече;</li>
<li><code>ORGANIZATION</code> — комната ожидания включена для внешних пользователей, к встрече сразу смогут присоединиться только пользователи с аккаунтами на домене организации;</li>
<li><code>UNKNOWN</code> — параметр для обеспечения обратной совместимости: все остальные значения поля обрабатываются как <code>UNKNOWN</code>.</li>
</ul>

_Enum:_{.json-schema-reset .json-schema-value} `PUBLIC`, `ORGANIZATION`, `UNKNOWN`
{.table-cell}
||
||

_id_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

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

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_is_auto_summarization_enabled_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: boolean

Автоматический запуск конспектирования при старте встречи. Включается при входе первого участника. Останавливается автоматически при выходе всех участников из встречи.
{.table-cell}
||
||

_join_url_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

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

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_live_stream_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [ApiLiveStream](#entity-ApiLiveStream)

Данные о трансляции. Если видеовстреча создана без трансляции, параметр отсутствует.

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "watch_url": "example",
  "access_level": "PUBLIC",
  "title": "example",
  "description": "example"
}
```

{% endcut %}
{.table-cell}
||
||

_should_create_public_chat_if_not_exists_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: boolean

Должен ли создаваться открытый чат для конференции, если он еще не создан.
{.table-cell}
||
||

_waiting_room_level_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

<p>Настройка уровня доступа комнаты ожидания — кто попадает на встречу, минуя ожидание:</p>
<ul>
<li><code>PUBLIC</code> — комната ожидания выключена, пользователи смогут сразу присоединиться к встрече;</li>
<li><code>ORGANIZATION</code> — комната ожидания включена для внешних пользователей, к встрече сразу смогут присоединиться только пользователи с аккаунтами на домене организации;</li>
<li><code>ADMINS</code> — комната ожидания включена для всех пользователей, кроме организаторов и соорганизаторов встречи.</li>
</ul>

_Enum:_{.json-schema-reset .json-schema-value} `PUBLIC`, `ORGANIZATION`, `ADMINS`
{.table-cell}
||
|#{.json-schema-properties}

</div>

<div class="openapi-entity">

### ApiLiveStream {#entity-ApiLiveStream}

#|
|| **Name** | **Description** ||
||

_access_level_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

<p>Настройка уровня доступа:</p>
<ul>
<li><code>PUBLIC</code> — комната ожидания выключена, все пользователи смогут сразу присоединиться к встрече;</li>
<li><code>ORGANIZATION</code> — комната ожидания включена для внешних пользователей, к встрече сразу смогут присоединиться только пользователи с аккаунтами на домене организации;</li>
<li><code>UNKNOWN</code> — параметр для обеспечения обратной совместимости: все остальные значения поля обрабатываются как <code>UNKNOWN</code>.</li>
</ul>

_Enum:_{.json-schema-reset .json-schema-value} `PUBLIC`, `ORGANIZATION`, `UNKNOWN`
{.table-cell}
||
||

_description_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

Описание трансляции, которое отображается на странице для зрителей.

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_title_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

Название трансляции, которое отображается на странице для зрителей.

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_watch_url_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

Ссылка для просмотра трансляции.

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "watch_url": "example",
  "access_level": "PUBLIC",
  "title": "example",
  "description": "example"
}
```

{% endcut %}

</div>

</div>

<div class="openapi__response__code__400">

## 400 Bad Request

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

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "error": "example",
  "description": "example",
  "message": "example",
  "details": {}
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_description_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Техническое описание ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_error_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Уникальный код ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Человекочитаемое описание ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_details_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: object

Дополнительные детали ошибки

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{}
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__401">

## 401 Unauthorized

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

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "error": "example",
  "description": "example",
  "message": "example",
  "details": {}
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_description_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Техническое описание ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_error_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Уникальный код ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Человекочитаемое описание ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_details_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: object

Дополнительные детали ошибки

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{}
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__402">

## 402 Payment Required

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

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "error": "example",
  "description": "example",
  "message": "example",
  "details": {}
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_description_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Техническое описание ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_error_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Уникальный код ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Человекочитаемое описание ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_details_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: object

Дополнительные детали ошибки

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{}
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__403">

## 403 Forbidden

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

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "error": "example",
  "description": "example",
  "message": "example",
  "details": {}
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_description_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Техническое описание ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_error_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Уникальный код ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Человекочитаемое описание ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_details_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: object

Дополнительные детали ошибки

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{}
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__404">

## 404 Not Found

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

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "error": "example",
  "description": "example",
  "message": "example",
  "details": {}
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_description_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Техническое описание ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_error_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Уникальный код ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Человекочитаемое описание ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_details_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: object

Дополнительные детали ошибки

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{}
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__406">

## 406 Not Acceptable

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

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "error": "example",
  "description": "example",
  "message": "example",
  "details": {}
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_description_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Техническое описание ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_error_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Уникальный код ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Человекочитаемое описание ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_details_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: object

Дополнительные детали ошибки

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{}
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__409">

## 409 Conflict

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

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "error": "example",
  "description": "example",
  "message": "example",
  "details": {}
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_description_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Техническое описание ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_error_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Уникальный код ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Человекочитаемое описание ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_details_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: object

Дополнительные детали ошибки

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{}
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__410">

## 410 Gone

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

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "error": "example",
  "description": "example",
  "message": "example",
  "details": {}
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_description_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Техническое описание ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_error_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Уникальный код ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Человекочитаемое описание ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_details_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: object

Дополнительные детали ошибки

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{}
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__429">

## 429 Too Many Requests

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

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "error": "example",
  "description": "example",
  "message": "example",
  "details": {}
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_description_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Техническое описание ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_error_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Уникальный код ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Человекочитаемое описание ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_details_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: object

Дополнительные детали ошибки

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{}
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__503">

## 503 Service Unavailable

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

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "error": "example",
  "description": "example",
  "message": "example",
  "details": {}
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_description_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Техническое описание ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_error_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Уникальный код ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Человекочитаемое описание ошибки

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_details_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: object

Дополнительные детали ошибки

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{}
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

</div>
<!-- endsource: ru/openapi/telemost_api/ApiConferenceGet.md -->


[*Deprecated]: No longer supported, please use an alternative and newer version.