Перевод сотрудника в другую команду

Один сотрудник может состоять только в одной команде.

1. Узнать id текущей команды

Основной способ — запросить сотрудника через Список сотрудников с фильтром по email или login: в поле team.teamId будет id его текущей команды (или team: null, если он ни в одной).

curl --request POST \
  --url https://gptunnel.ru/api/v1/employees/getEmployees \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "login": "ivanov" }'

{
  "code": 0,
  "items": [
    {
      "email": "ivanov@example.com",
      "login": "ivanov",
      "phone": "",
      "firstName": "Иван",
      "lastName": "Иванов",
      "team": { "teamId": "5f1c9a0b2e3d4c5a6b7c8d9e", "teamName": "Продажи" }
    }
  ],
  "page": 1,
  "pageSize": 25,
  "total": 1,
  "totalPages": 1
}

Специально провоцировать ошибку, чтобы узнать команду, не нужно. Но если вы уже получили при добавлении в команду причину already_in_team (сотрудник оказался в другой команде), то id его текущей команды уже есть в этом ответе — в поле teamId внутри объекта ошибки. В этом случае повторный запрос за id делать не нужно, берите teamId оттуда:

{
  "login": "ivanov",
  "reason": "already_in_team",
  "message": "Employee already belongs to another team.",
  "teamId": "5f1c9a0b2e3d4c5a6b7c8d9e"
}

2. Удалить из текущей команды

Вызвать Удаление из команды, передав teamId текущей команды (из шага 1) и логин сотрудника.

curl --request POST \
  --url https://gptunnel.ru/api/v1/employees/removeEmployeesFromTeam \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "teamId": "5f1c9a0b2e3d4c5a6b7c8d9e",
    "logins": ["ivanov"]
}'

3. Добавить в новую команду

Вызвать Добавление в команду с teamId новой команды.

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"]
}'