← API Reference
GroupsPOST

Approve / reject join requests

Approves or rejects pending join requests in batch. action is approve or reject; member_ids takes one or more ids from List group join requests.

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

Headers

X-Api-Key
stringrequired

Workspace API key. The workspace is resolved from this header.

Content-Type
stringrequired

Use application/json when sending a JSON request body.

Path parameters

account_id
stringrequired

Identifier used in the groups route.

Request body

group_id
stringrequired

Target group identifier.

action
stringrequired

Member or approval action supported by the provider.

enum: approve, reject

member_ids[]
string[]required

Join-request member identifiers to process.

minItems: 1

Response body

ok
boolean

Always true when the operation succeeded; failures return a non-2xx status instead.

Responses

200
200 OK

Request succeeded. See the example response body.

400
Bad Request

The request body, path, or parameters are invalid.

401
Unauthorized

The X-Api-Key header is missing or invalid.

404
Not Found

The requested provider resource could not be found.

409
Conflict

The requested operation conflicts with an existing provider account or resource.

500
Internal Server Error

The service encountered an unexpected error.

501
Not Implemented

The selected provider does not implement this operation.

502
Bad Gateway

The provider adapter or upstream provider could not complete the operation.

Request

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

Response

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