← Справочник API
GroupsPOST

Одобрить / отклонить заявки

Пакетно одобряет или отклоняет заявки на вступление. action — approve или reject; member_ids принимает один или несколько id из списка заявок.

https://api.unifyport.ai/v1/accounts/{account_id}/groups/join-requests/update

Заголовки

X-Api-Key
stringобязательно

API-ключ рабочей области. Рабочая область определяется по этому заголовку.

Content-Type
stringобязательно

Используйте application/json при отправке JSON-тела запроса.

Параметры пути

account_id
stringобязательно

Идентификатор для маршрута раздела groups.

Тело запроса

group_id
stringобязательно

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

action
stringобязательно

Поддерживаемое провайдером действие с участником или заявкой.

enum: approve, reject

member_ids[]
string[]обязательно

Идентификаторы участников заявок, которые нужно обработать.

minItems: 1

Тело ответа

ok
boolean

Всегда true при успешном выполнении операции; при ошибках вместо этого возвращается статус не из диапазона 2xx.

Ответы

200
200 OK

Запрос выполнен. См. пример тела ответа.

400
Bad Request

Тело запроса, путь или параметры некорректны.

401
Unauthorized

Заголовок X-Api-Key отсутствует или недействителен.

404
Not Found

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

409
Conflict

Запрошенная операция конфликтует с существующим аккаунтом провайдера или ресурсом.

500
Internal Server Error

Сервис столкнулся с неожиданной ошибкой.

501
Not Implemented

Выбранный провайдер не реализует эту операцию.

502
Bad Gateway

Адаптер или вышестоящий провайдер не смог завершить операцию.

Запрос

curl -X POST https://api.unifyport.ai/v1/accounts/{account_id}/groups/join-requests/update \
  -H "X-Api-Key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "group_id": "group_example",
  "action": "approve",
  "member_ids": ["member_example", "member_other"]
}'

Ответ

{
  "data": {
    "ok": true
  }
}