---
title: "Add users"
method: POST
path: "/api/organizations/{name}/resource-groups/{resourceGroupId}/users"
tags: ["resource-groups"]
---

# Add users

`POST /api/organizations/{name}/resource-groups/{resourceGroupId}/users`

Add one or more organization members to a resource group.

Requires the org to have a Team plan or higher.

## Path parameters

- `name` string, required
- `resourceGroupId` string, required

## Request body

- object
  - `users` union[], required
    - union
      - object
        - `name` string, required
        - `role` union, required
          - 'admin' | 'write' | 'contributor' | 'read' | 'no_access'
          - string — Custom role name
      - object
        - `user` string, required
        - `role` union, required
          - 'admin' | 'write' | 'contributor' | 'read' | 'no_access'
          - string — Custom role name

## Response `200`

The updated resource group

- object
  - `id` string, required
  - `name` string, required
  - `description` string, nullable
  - `autoJoin` union
    - object
      - `enabled` unknown, required
      - `role` union, required
        - 'admin' | 'write' | 'contributor' | 'read' | 'no_access'
        - string — Custom role name
      - `scope` 'all' | 'read_plus'
    - object
      - `enabled` unknown, required
  - `users` object[], required
    - `type` 'user', required
    - `_id` string, required
    - `fullname` string, required
    - `name` string, required
    - `avatarUrl` string, required
    - `role` union, required
      - 'admin' | 'write' | 'contributor' | 'read' | 'no_access'
      - string — Custom role name
    - `addedBy` string
  - `resources` union[], required
    - union
      - object
        - `type` 'dataset' | 'model' | 'space' | 'bucket' | 'kernel', required
        - `name` string, required
        - `addedBy` string
        - `private` boolean, required
      - object
        - `type` 'collection', required
        - `id` string, required
        - `slug` string, required
        - `title` string, required
        - `addedBy` string
        - `private` boolean, required
      - object
        - `type` 'blog', required
        - `id` string, required
        - `slug` string, required
        - `title` string, required
        - `addedBy` string
        - `private` boolean, required
      - object
        - `type` 'job', required
        - `id` string, required
        - `name` string
        - `addedBy` string
      - object
        - `type` 'scheduled-job', required
        - `id` string, required
        - `name` string
        - `addedBy` string

---

[API](https://skmtc.net/huggingface/apis/hub-api-endpoints.md) · [All operations](https://skmtc.net/huggingface/apis/hub-api-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/huggingface/hub-api-endpoints/versions/6ab9f7d9cfb5/schema)