---
title: "List available user roles"
method: GET
path: "/api/{org_id}/users/roles"
tags: ["Users"]
---

# List available user roles

`GET /api/{org_id}/users/roles`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/users/roles`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/users/roles/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a comprehensive list of all available user roles that can be assigned to users within the organization. Includes role names, descriptions, and permission levels to help administrators understand access control options when creating or updating user accounts. Role availability may vary based on enterprise features and organizational settings.

## Path parameters

- `org_id` string, required

## Response `200`

Success

- object[]
  - `label` string, required
  - `value` string, required

---

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