Перейти к содержимому

Добавление сотрудников в команду

Добавление сотрудников в команду

POST https://gptunnel.ru/api/v1/employees/addEmployeesToTeam

Добавляет одного или нескольких сотрудников (по логину) в команду (по id). Каждый логин обрабатывается независимо. Сотрудник может состоять в нескольких командах одновременно — добавление в новую команду не затрагивает его членство в других.

Headers

ПараметрТипОписание
Authorization*stringAPI ключ

Параметры запроса

ПараметрТипОписание
teamId*stringid команды
logins*string[]Массив логинов сотрудников (от 1 до 25)

Причины ошибок в failedLogins:

Причины ошибок

ПараметрТипОписание
not_foundstringСотрудника с таким логином нет в организации
forbiddenstringНельзя управлять сотрудником с более высокой ролью, чем ваша, или своим собственным аккаунтом
errorstringНепредвиденная ошибка при обработке

Пример запроса

Окно терминала
curl --request POST \
--url https://gptunnel.ru/api/v1/employees/addEmployeesToTeam \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"teamId": "66a346f64dcb57627c03d596",
"logins": ["ivanov", "petrov"]
}'

Пример ответа

{
"code": 0,
"teamId": "66a346f64dcb57627c03d596",
"added": 1,
"failed": 1,
"failedLogins": [
{
"login": "petrov",
"reason": "not_found",
"message": "Employee not found in the organization."
}
]
}