---
title: "Add Group Users"
method: POST
path: "/group/users/add"
---

# Add Group Users

`POST /group/users/add`

## Request

- Base URL: `https://api.tellers.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tellers.ai/group/users/add`
- Auth: none declared

## Headers

- `authorization` string, nullable

## Request body

- GroupUsersRequest
  - `group_id` string, required
  - `user_ids` string[]
  - `emails` string[]
  - `right` 'ADMIN' | 'READ' | 'WRITE' | 'VIEW': A right on an asset, a chat or an assistant, weakest first: VIEW < READ < WRITE < ADMIN. On an asset, VIEW sees the file and everything about it except its comments, which READ adds. Chats and assistants have nothing READ adds, so VIEW opens what READ does there. Group memberships start at READ.

## Response `200`

Successful Response

- GroupUsersResponse: The ``user_ids`` asked for that were found and those that were not. Emails are never listed in either: the reply must not tell which have a Tellers account. An email without one is invited and joins the group when someone signs in with it.
  - `user_ids` string[], required
  - `not_found` string[], required

## Other responses

- `422`: Validation Error

---

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