Изменение статуса 2FA для подразделения

Изменяет статус обязательной двухфакторной аутентификации для подразделения. Чтобы изменить остальные параметры, воспользуйтесь запросом «Изменить параметры подразделения» на хост на хост api360.yandex.net.

Отправить запрос может администратор организации или сотрудник с ролью Менеджер пользователей.

Этот инструмент доступен в тарифах для крупных организаций Корпоративный + Безопасность и Корпоративный Максимум. Чтобы узнать подробности, оставьте заявку: менеджер Яндекс 360 свяжется с вами, ответит на все вопросы и поможет с подключением. Оставить заявку

Метод актуален, если:

В организации установлена двухфакторная аутентификация через сервис для управления 2FA с возможностью персональной настройки или в интерфейсе Кабинета организации.
Режим двухфакторной аутентификации enforcement_mode: per_user — только отдельным сотрудникам. Узнать режим, который установлен для 2FA в вашей организации, можно с помощью метода, описанного в разделе Посмотреть статус 2FA с возможностью персональной настройки.

Особенности обязательной 2FA для подразделения

На кого распространяется

Статус 2FA действует только на участников подразделения с аккаунтами на домене организации:

Начинает действовать при вступлении сотрудника в подразделения.
Перестает действовать после удаления сотрудника из подразделения.
Не распространяется на вложенные подразделения — для них нужно задавать статус отдельно.

Как работает с персональной 2FA

Статус 2FA для подразделения не изменяет персональную настройку 2FA у сотрудников:

Если для подразделения установлено is_2fa_enabled=true, сотрудники будут обязаны проходить 2FA.
При этом методы, возвращающие персональный статус 2FA, по-прежнему будут показывать is_2fa_enabled=false для этих сотрудников.

Правила применения 2FA

Сотрудник обязан проходить 2FA, если хотя бы один из параметров is_2fa_enabled имеет значение true:

Персональная настройка 2FA.
Настройка 2FA для подразделения.
Настройка 2FA хотя бы для одной из групп, в которых состоит сотрудник.

Request

PATCH

https://cloud-api.yandex.net/v1/directory/organizations/{org_id}/departments/{department_id}

Path parameters

Name

Description

department_id

Type: integer

Идентификатор подразделения.

org_id

Type: integer

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

Body

application/json

{
  "default_email": "department@example.com",
  "is_2fa_enabled": true
}

Name

Description

default_email

Type: string

Адрес, используемый по умолчанию.

Example: department@example.com

is_2fa_enabled

Type: boolean

Статус обязательной двухфакторной аутентификации для подразделения.

Возможные значения:

true — включена;
false — выключена.

Responses

200 OK

Параметры подразделения изменены.

Body

application/json

{
  "id": 7654321,
  "name": "Отдел разработки",
  "description": "Подразделение продуктовой разработки.",
  "label": "development",
  "members_count": 25,
  "email": "department@example.com",
  "default_email": "department@example.com",
  "aliases": [
    "developers"
  ],
  "removed": false,
  "parent": {
    "id": 7654322
  },
  "created_at": "2026-05-01T10:00:00+00:00",
  "is_2fa_enabled": true
}

Name	Description
aliases	Type: string[] Алиасы почтовых рассылок подразделения. Example `[ "developers" ]`
created_at	Type: string Дата и время создания подразделения. Example: `2026-05-01T10:00:00+00:00`
default_email	Type: string Адрес, используемый по умолчанию. Example: `department@example.com`
description	Type: string Описание подразделения. Example: `Подразделение продуктовой разработки.`
email	Type: string Адрес рассылки, по которому будут отфильтрованы подразделения. Example: `department@example.com`
id	Type: integer Идентификатор подразделения.
is_2fa_enabled	Type: boolean Статус обязательной двухфакторной аутентификации для подразделения. Возможные значения: `true` — включена; `false` — выключена.
label	Type: string Имя почтовой рассылки подразделения. Example: `development`
members_count	Type: integer Количество сотрудников подразделения с учетом вложенных подразделений.
name	Type: string Название подразделения. Example: `Отдел разработки`
parent	Type: Parent Родительское подразделение. Example `{ "id": 7654322 }`
removed	Type: boolean Признак удаленного подразделения: `true` — подразделение удалено; `false` — подразделение действующее.

Parent

Родительское подразделение.

Name

Description

Type: integer

Идентификатор родительского подразделения.

Example

{
  "id": 7654322
}

403 Forbidden

Доступ к ресурсу запрещен. У пользователя или приложения недостаточно прав.

Body

application/json

{
  "error": "forbidden",
  "description": "Forbidden",
  "message": "Forbidden",
  "details": {}
}

Name

Description

description

Type: string

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

Example: Forbidden

error

Type: string

Код ошибки

Example: forbidden

message

Type: string

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

Example: Forbidden

details

Type: object

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

Example

{}

404 Not Found

Запрашиваемый ресурс не найден.

Body

application/json

{
  "error": "not_found",
  "description": "Not found",
  "message": "Not found",
  "details": {}
}

Name

Description

description

Type: string

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

Example: Not found

error

Type: string

Код ошибки

Example: not_found

message

Type: string

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

Example: Not found

details

Type: object

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

Example

{}

422 Unprocessable Entity

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

Feature unavailable
Invalid data

Body

application/json

{
  "error": "feature_unavailable",
  "description": "Feature unavailable",
  "message": "Feature unavailable",
  "details": {}
}

Name

Description

description

Type: string

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

Example: Feature unavailable

error

Type: string

Код ошибки

Example: feature_unavailable

message

Type: string

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

Example: Feature unavailable

details

Type: object

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

Example

{}

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

Получить информацию о подразделении

Обзор