Добавить участника в группу

Добавляет участника в группу. Участником группы может быть сотрудник организации, отдельное подразделение или другая группа.

Примечание

Требуется разрешение на изменение данных о группах.

Request

POST

https://api360.yandex.net/directory/v1/org/{orgId}/groups/{groupId}/members

Path parameters

Name

Description

groupId*

Type: integer<int64>

Идентификатор группы.

orgId*

Type: integer<int64>

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

Body

application/json
{
    "type": "user",
    "id": "string"
}

Name

Description

id*

Type: string<uint64>

Идентификатор участника группы.

type*

Type: GroupMemberGroupMemberType

Тип участника группы.

Default: user

Enum: user, group, department

GroupMemberGroupMemberType

Тип участника группы.

  • user: Сотрудник.
  • group: Группа.
  • department: Подразделение.

Type

Description

GroupMemberGroupMemberType

Default: user

Enum: user, group, department

Responses

200 OK

Запрос успешно выполнен.

Body

application/json
{
    "id": "string",
    "type": "string",
    "added": false
}

Name

Description

added

Type: boolean

Признак добавления участника: true — добавлен; false — не добавлен.

id

Type: string<uint64>

Идентификатор участника группы.

type

Type: string

Тип участника группы.

401 Unauthorized

Пользователь не авторизован.

Body

application/json
{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: any[]

Дополнительные сведения об ошибке.

message

Type: string

Описание ошибки.

403 Forbidden

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

Body

application/json
{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: any[]

Дополнительные сведения об ошибке.

message

Type: string

Описание ошибки.

404 Not Found

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

Body

application/json
{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: any[]

Дополнительные сведения об ошибке.

message

Type: string

Описание ошибки.

500 Internal Server Error

Внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время.

Body

application/json
{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: any[]

Дополнительные сведения об ошибке.

message

Type: string

Описание ошибки.