---
title: "Add multiple members to a group chat"
method: POST
path: "/v1/chat/rooms/{roomId}/members/batch"
tags: ["chat"]
---

# Add multiple members to a group chat

`POST /v1/chat/rooms/{roomId}/members/batch`

## Request

- Base URL: `https://app.legend.trade/api/rest`
- URL: `https://app.legend.trade/api/rest/v1/chat/rooms/{roomId}/members/batch`
- Auth: HTTP bearer

Process at most 50 items in input order. Each item has an independent outcome. Retry only failed or unknown items.

## Path parameters

- `roomId` string, uuid, required

## Request body

- object
  - `userIds` string[], required

## Response `200`

Successful response

- ChatAddMembersOutput
  - `results` ChatAddMembersResult[], required
    - union
      - object
        - `userId` string, uuid, required
        - `success` true, required
      - object
        - `userId` string, uuid, required
        - `success` false, required
        - `error` ChatAddMembersBatchError, required
          - `code` 'PARSE_ERROR' | 'BAD_REQUEST' | 'INTERNAL_SERVER_ERROR' | 'NOT_IMPLEMENTED' | 'BAD_GATEWAY' | 'SERVICE_UNAVAILABLE' | 'GATEWAY_TIMEOUT' | 'UNAUTHORIZED' | 'PAYMENT_REQUIRED' | 'FORBIDDEN' | 'NOT_FOUND' | 'METHOD_NOT_SUPPORTED' | 'TIMEOUT' | 'CONFLICT' | 'PRECONDITION_FAILED' | 'PAYLOAD_TOO_LARGE' | 'UNSUPPORTED_MEDIA_TYPE' | 'UNPROCESSABLE_CONTENT' | 'PRECONDITION_REQUIRED' | 'TOO_MANY_REQUESTS' | 'CLIENT_CLOSED_REQUEST', required
          - `message` string, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `500`: Internal server error

## Changes

- **2026-10-20** `dafcd00312dc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/legend/apis/legend-api/changes/v1/chat/rooms/:roomId/members/batch/post.md)

---

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