---
title: "ListProjectMemberUsergroups lists the user groups assigned to a project"
method: GET
path: "/v1/orgs/{org}/projects/{project}/usergroups"
---

# ListProjectMemberUsergroups lists the user groups assigned to a project

`GET /v1/orgs/{org}/projects/{project}/usergroups`

## Path parameters

- `org` string, required
- `project` string, required

## Query parameters

- `role` string
- `includeCounts` boolean
- `pageSize` integer
- `pageToken` string

## Response `200`

A successful response.

- V1ListProjectMemberUsergroupsResponse
  - `members` V1MemberUsergroup[]
    - `createdOn` string, date-time
    - `groupId` string
    - `groupManaged` boolean
    - `groupName` string
    - `resources` V1ResourceName[]
      - `name` string
      - `type` string
    - `restrictResources` boolean
    - `roleName` string
    - `updatedOn` string, date-time
    - `usersCount` integer
  - `nextPageToken` string

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-02-17** (v1) `5dda040d7e2b` — 1 info
  - endpoint added
- **2025-12-11** (v1) `f317ff96998d` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/rilldata/apis/rill-admin-api/changes/v1/orgs/:org/projects/:project/usergroups/get.md)

---

[API](https://skmtc.dev/rilldata/apis/rill-admin-api.md) · [All operations](https://skmtc.dev/rilldata/apis/rill-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rilldata/rill-admin-api/revisions/abe7a430f373/schema)