---
title: "List Roles"
method: GET
path: "/api/v1/auth-management/roles"
tags: ["userManagement"]
---

# List Roles

`GET /api/v1/auth-management/roles`

List all assignable roles.

The roles returned are scoped to the roles context.
For example, if the roles_context is "dataset:123", the endpoint will return all roles
that are assignable to dataset with id "123". If the roles_context is "system", the endpoint
will return all system-level roles that are assignable in the organization.

If no roles_context is provided, the endpoint will return all system-level and dataset-level
roles in the organization.

## Query parameters

- `roles_context` string, nullable

## Headers

- `Authorization` string, required

## Response `200`

A list of assignable roles

- RolesListResponse — Response model for listing all available roles.
  - `roles` RoleDefinition[], required — List of roles
    - `role_id` string, required — Unique identifier for the role
    - `name` string, required — Display name of the role
    - `description` string, nullable — Optional description of the role's purpose
    - `resource` string, nullable — Optional resource type this role applies to

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/coactive/apis/api-reference.md) · [All operations](https://skmtc.dev/coactive/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coactive/api-reference/revisions/1223758be9ba/schema)