Удалить участников из группы

Удаляет из группы участников (сотрудников организации, отдельные подразделения, внешние контакты или вложенные группы) по их идентификаторам.

Примечание

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

Request

PATCH

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

Path parameters

Name

Description

groupId*

Type: integer<int64>

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

orgId*

Type: integer<int64>

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

Body

application/json
{
    "userIds": [
        "string"
    ],
    "departmentIds": [
        0
    ],
    "groupIds": [
        0
    ],
    "externalContactIds": [
        "string"
    ],
    "sharedMailboxIds": [
        "string"
    ]
}

Name

Description

departmentIds

Type: integer<int64>[]

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

externalContactIds

Type: string[]

Идентификаторы внешних контактов.

groupIds

Type: integer<int64>[]

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

sharedMailboxIds

Type: string<uint64>[]

Идентификаторы общих ящиков.

userIds

Type: string<uint64>[]

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

Responses

200 OK

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

Body

application/json
{}

400 Bad Request

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

Body

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

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: protobufAny[]

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

message

Type: string

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

protobufAny

Name

Description

@type

Type: string

...rest

Type: any

401 Unauthorized

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

Body

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

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: protobufAny[]

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

message

Type: string

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

403 Forbidden

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

Body

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

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: protobufAny[]

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

message

Type: string

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

404 Not Found

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

Body

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

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: protobufAny[]

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

message

Type: string

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

500 Internal Server Error

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

Body

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

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: protobufAny[]

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

message

Type: string

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

No longer supported, please use an alternative and newer version.