---
title: "List assignable roles"
method: GET
path: "/user-management/v1/roles"
tags: ["User Management"]
---

# List assignable roles

`GET /user-management/v1/roles`

## Request

- Base URL: `https://api.langdock.com`
- URL: `https://api.langdock.com/user-management/v1/roles`
- Auth: HTTP bearer

Lists the workspace system roles and custom roles you can assign
with Update User Role. System roles come first (`member`, `editor`, `admin`),
then custom roles from oldest to newest. Each role includes `id`, `kind`,
`name`, and `description`. Permission settings are not included.
Custom role names are not unique, so use `id` when assigning a role.
Requires an API key with the `USER_MANAGEMENT_API` scope.

## Response `200`

Assignable roles

- ListRolesResponse
  - `roles` object[], required: System roles first (`member`, `editor`, `admin`), then live custom roles from oldest to newest. Deleted custom roles are omitted.
    - `id` string, required: System role name (`member`, `editor`, or `admin`) or the custom role UUID. Use this value in `customRoleIds`.
    - `kind` 'system' | 'custom', required: Whether the role is a system role or a custom role
    - `name` string, required: Display name. Custom role names are not unique.
    - `description` string, required: Role description. Empty for system roles.

## Other responses

- `401`: API key is missing, invalid, or expired
- `403`: API key is missing the USER_MANAGEMENT_API scope
- `500`: Internal server error

## Changes

- **2026-11-03** `c62bf90b4013`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langdock/apis/langdock-api/changes/user-management/v1/roles/get.md)

---

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