---
title: "Change group members"
method: POST
path: "/v1/connections/{connection}/groups/{group}/participants"
tags: ["Groups"]
---

# Change group members

`POST /v1/connections/{connection}/groups/{group}/participants`

## Request

- Base URL: `https://www.chatrail.dev`
- URL: `https://www.chatrail.dev/v1/connections/{connection}/groups/{group}/participants`
- Auth: HTTP bearer

`add`, `remove`, `promote` to admin or `demote`. Adding counts against the member-add guardrail (20 per connection per hour). Paid plans.

## Path parameters

- `connection` string, required
- `group` string, required

## Request body

- object
  - `action` 'add' | 'remove' | 'promote' | 'demote', required
  - `participants` string[], required

## Response `200`

The group after the change.

## Other responses

- `429`: Over the member-add guardrail for this hour.

---

[API](https://skmtc.dev/chatrail/apis/chatrail-api.md) · [All operations](https://skmtc.dev/chatrail/apis/chatrail-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatrail/apis/chatrail-api/revisions/acc5b88c6f59?raw)