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

<!-- source: ru/openapi/organization_settings/v1telemost-apiorganizationsorg_idsettings-put.md -->
<div class="openapi">

# Обновление настроек по умолчанию для всех видеовстреч организации

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

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

Чтобы изменить настройки по умолчанию, добавьте приложению разрешение `telemost-api:organization_settings.update`.

Разрешение `telemost-api:conferences.update` для этого запроса устарело и поддерживается временно.

{% note info "" %}

Для выполнения запроса требуется право `telemost-api:conferences.update`.

{% endnote %}

## Request

<div class="openapi__requests">

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

<div class="openapi__request">

PUT {.openapi__method}
```text translate=no
https://cloud-api.yandex.net/v1/telemost-api/organizations/{org_id}/settings
```

</div>

</div>

</div>

### Path parameters

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

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

Идентификатор организации.

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

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "waiting_room_level_adhoc": {
    "value": "ORGANIZATION"
  },
  "waiting_room_level_calendar": {
    "value": "ORGANIZATION"
  },
  "cloud_recording_email_receivers": {
    "value": [
      "OWNER"
    ]
  },
  "summarization_email_receivers": {
    "value": [
      "OWNER",
      "INTERNAL_COHOST"
    ]
  },
  "calendar_event_summarization_email_receivers": {
    "value": [
      "OWNER"
    ]
  },
  "cloud_recording_allowed_roles": {
    "value": [
      "OWNER",
      "INTERNAL_COHOST",
      "INTERNAL_MEMBER"
    ]
  },
  "summarization_allowed_roles": {
    "value": [
      "OWNER",
      "INTERNAL_COHOST"
    ]
  },
  "is_incoming_phone_calls_turned_on": true
}
```

{% endcut %}

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

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

Кто может вести запись видеовстречи на Яндекс Диск.

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

```json translate=no
{
  "value": [
    "OWNER",
    "INTERNAL_COHOST",
    "INTERNAL_MEMBER"
  ]
}
```

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

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

Роли участников встречи, которые получат письмо со ссылкой на Яндекс Диск с записью видеовстречи.

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

```json translate=no
{
  "value": [
    "OWNER"
  ]
}
```

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

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

Роли участников встречи, которым разрешено включать конспектирование видеовстречи.

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

```json translate=no
{
  "value": [
    "OWNER",
    "INTERNAL_COHOST"
  ]
}
```

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

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

Роли участников встречи, которые получат письмо c конспектом видеовстречи.

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

```json translate=no
{
  "value": [
    "OWNER",
    "INTERNAL_COHOST"
  ]
}
```

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

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

Настройки комнаты ожидания для видеовстреч, созданных по кнопке **Новая видеовстреча** в Телемосте.

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

```json translate=no
{
  "value": "ORGANIZATION"
}
```

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

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

Настройки комнаты ожидания для видеовстреч, созданных из Яндекс Календаря.

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

```json translate=no
{
  "value": "ORGANIZATION"
}
```

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

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

Роли участников, приглашенных на встречу в календаре, которые получат письмо c саммаризацией встречи.

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

```json translate=no
{
  "value": [
    "OWNER"
  ]
}
```

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

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

Включена ли возможность дозваниваться в встречу с телефона.
{.table-cell}
||
|#{.json-schema-properties}

</div>

<div class="openapi-entity">

### WaitingRoomLevelAdhoc {#entity-WaitingRoomLevelAdhoc}

Настройки комнаты ожидания для видеовстреч, созданных по кнопке **Новая видеовстреча** в Телемосте.

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

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

Уровень доступа встречи:

  - `PUBLIC` — комната ожидания выключена, пользователи смогут сразу присоединиться к встрече.
  - `ORGANIZATION` — комната ожидания включена для внешних пользователей, к встрече сразу смогут присоединиться только пользователи с аккаунтами на домене организации.
  - `ADMINS` — комната ожидания включена для всех пользователей, кроме организаторов и соорганизаторов.
  - `UNKNOWN` — параметр для обеспечения обратной совместимости.


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

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

```json translate=no
{
  "value": "ORGANIZATION"
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### WaitingRoomLevelCalendar {#entity-WaitingRoomLevelCalendar}

Настройки комнаты ожидания для видеовстреч, созданных из Яндекс Календаря.

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

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

Уровень доступа встречи:

  - `PUBLIC` — комната ожидания выключена, пользователи смогут сразу присоединиться к встрече.
  - `ORGANIZATION` — комната ожидания включена для внешних пользователей, к встрече сразу смогут присоединиться только пользователи с аккаунтами на домене организации.
  - `ADMINS` — комната ожидания включена для всех пользователей, кроме организаторов и соорганизаторов.
  - `UNKNOWN` — параметр для обеспечения обратной совместимости.


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

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

```json translate=no
{
  "value": "ORGANIZATION"
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### CloudRecordingEmailReceivers {#entity-CloudRecordingEmailReceivers}

Роли участников встречи, которые получат письмо со ссылкой на Яндекс Диск с записью видеовстречи.

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

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

Список ролей участников встречи.

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

```json translate=no
[
  "OWNER"
]
```

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

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

```json translate=no
{
  "value": [
    "OWNER"
  ]
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### SummarizationEmailReceivers {#entity-SummarizationEmailReceivers}

Роли участников встречи, которые получат письмо c конспектом видеовстречи.

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

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

Список ролей участников встречи.

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

```json translate=no
[
  "OWNER",
  "INTERNAL_COHOST"
]
```

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

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

```json translate=no
{
  "value": [
    "OWNER",
    "INTERNAL_COHOST"
  ]
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### CalendarEventSummarizationEmailReceivers {#entity-CalendarEventSummarizationEmailReceivers}

Роли участников, приглашенных на встречу в календаре, которые получат письмо c саммаризацией встречи.

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

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

Список ролей участников встречи.

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

```json translate=no
[
  "OWNER"
]
```

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

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

```json translate=no
{
  "value": [
    "OWNER"
  ]
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### CloudRecordingAllowedRoles {#entity-CloudRecordingAllowedRoles}

Кто может вести запись видеовстречи на Яндекс Диск.

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

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

Список ролей участников встречи.

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

```json translate=no
[
  "OWNER",
  "INTERNAL_COHOST",
  "INTERNAL_MEMBER"
]
```

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

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

```json translate=no
{
  "value": [
    "OWNER",
    "INTERNAL_COHOST",
    "INTERNAL_MEMBER"
  ]
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### SummarizationAllowedRoles {#entity-SummarizationAllowedRoles}

Роли участников встречи, которым разрешено включать конспектирование видеовстречи.

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

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

Список ролей участников встречи.

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

```json translate=no
[
  "OWNER",
  "INTERNAL_COHOST"
]
```

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

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

```json translate=no
{
  "value": [
    "OWNER",
    "INTERNAL_COHOST"
  ]
}
```

{% endcut %}

</div>

## Responses

<div class="openapi__response__code__200">

## 200 OK

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

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "waiting_room_level_adhoc": {
    "value": "ORGANIZATION"
  },
  "waiting_room_level_calendar": {
    "value": "ORGANIZATION"
  },
  "cloud_recording_email_receivers": {
    "value": [
      "OWNER"
    ]
  },
  "summarization_email_receivers": {
    "value": [
      "OWNER",
      "INTERNAL_COHOST"
    ]
  },
  "calendar_event_summarization_email_receivers": {
    "value": [
      "OWNER"
    ]
  },
  "cloud_recording_allowed_roles": {
    "value": [
      "OWNER",
      "INTERNAL_COHOST",
      "INTERNAL_MEMBER"
    ]
  },
  "summarization_allowed_roles": {
    "value": [
      "OWNER",
      "INTERNAL_COHOST"
    ]
  },
  "is_incoming_phone_calls_turned_on": true
}
```

{% endcut %}

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

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

Кто может вести запись видеовстречи на Яндекс Диск.

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

```json translate=no
{
  "value": [
    "OWNER",
    "INTERNAL_COHOST",
    "INTERNAL_MEMBER"
  ]
}
```

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

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

Роли участников встречи, которые получат письмо со ссылкой на Яндекс Диск с записью видеовстречи.

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

```json translate=no
{
  "value": [
    "OWNER"
  ]
}
```

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

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

Роли участников встречи, которым разрешено включать конспектирование видеовстречи.

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

```json translate=no
{
  "value": [
    "OWNER",
    "INTERNAL_COHOST"
  ]
}
```

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

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

Роли участников встречи, которые получат письмо c конспектом видеовстречи.

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

```json translate=no
{
  "value": [
    "OWNER",
    "INTERNAL_COHOST"
  ]
}
```

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

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

Настройки комнаты ожидания для видеовстреч, созданных по кнопке **Новая видеовстреча** в Телемосте.

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

```json translate=no
{
  "value": "ORGANIZATION"
}
```

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

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

Настройки комнаты ожидания для видеовстреч, созданных из Яндекс Календаря.

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

```json translate=no
{
  "value": "ORGANIZATION"
}
```

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

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

Роли участников, приглашенных на встречу в календаре, которые получат письмо c саммаризацией встречи.

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

```json translate=no
{
  "value": [
    "OWNER"
  ]
}
```

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

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

Включена ли возможность дозваниваться в встречу с телефона.
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__400">

## 400 Bad Request

Некорректный запрос.

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "error": "TelemostBadRequestError",
  "description": "Некорректный запрос.",
  "message": "Некорректный запрос.",
  "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} `Некорректный запрос.`
{.table-cell}
||
||

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

Код ошибки

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

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

Сообщение об ошибке.

_Example:_{.json-schema-reset .json-schema-example} `Некорректный запрос.`
{.table-cell}
||
||

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

#|
|#{.json-schema-properties}

{% endcut %}

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

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

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

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

</div>

</div>

<div class="openapi__response__code__403">

## 403 Forbidden

Возможные ошибки:

- Нет прав на выполнение запроса.
- API доступен пользователям Яндекс 360 для бизнеса.

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "error": "OrganizationSettingsAccessForbidden",
  "description": "Нет прав на выполнение запроса.",
  "message": "Нет прав на выполнение запроса.",
  "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} `Нет прав на выполнение запроса.`
{.table-cell}
||
||

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

Код ошибки

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

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

Сообщение об ошибке.

_Example:_{.json-schema-reset .json-schema-example} `Нет прав на выполнение запроса.`
{.table-cell}
||
||

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

#|
|#{.json-schema-properties}

{% endcut %}

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

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

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

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

</div>

</div>

</div>
<!-- endsource: ru/openapi/organization_settings/v1telemost-apiorganizationsorg_idsettings-put.md -->


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