---
title: "Get resource groups"
method: GET
path: "/api/organizations/{name}/resource-groups"
tags: ["resource-groups"]
---

# Get resource groups

`GET /api/organizations/{name}/resource-groups`

Retrieve accessible resource groups. Get all resource groups the user has access to.

Requires the org to have a Team plan or higher.

## Path parameters

- `name` string, required

## Response `200`

Resource groups the user has access to

- 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/8443210055e0/schema)