---
title: "List roles"
method: GET
path: "/cloud/v1/users/roles"
tags: ["User Role Assignments"]
deprecated: true
---

# List roles

`GET /cloud/v1/users/roles`

> **Deprecated.**

List of available roles is now exposed as an enum in endpoints where they are used,
for example (/v1/users/assignments).

## Query parameters

- `project_id` integer — Project ID

## Response `200`

OK

- RoleCollectionSerializer
  - `count` integer, required — Number of objects
  - `results` UserRoleSerializer[], required — Objects
    - `role` 'ClientAdministrator' | 'InternalNetworkOnlyUser' | 'Observer' | 'ProjectAdministrator' | 'User', required
    - `scope` string, required — Role's scope

---

[API](https://skmtc.dev/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.dev/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)