---
title: "List Roles"
method: GET
path: "/api/v2/roles"
tags: ["Roles & Permissions"]
---

# List Roles

`GET /api/v2/roles`

Get a list of roles that can be assigned to users. The platform provides several predefined roles, each with its own set of permissions:

**Admin**
- Full system access with broad privileges
- Can manage integrations, model assets, detections, and users
- Has create, delete, edit, and configuration capabilities

**Analyst**
- Focused on model scanning and detection workflows
- Can submit and update scan results
- Can review details, add notes, and close detections
- Can configure and trigger AutoRT targets and runs

**Viewer**
- Read-only access to system resources
- Can view assets, results, models, and detections
- Cannot create, edit, or delete resources

**User Admin**
- Specialized in user management
- Can create, edit, and delete users
- Limited to user administration tasks

Note: Some system resources are restricted to HiddenLayer service integrations and are not accessible through these roles.

## Response `200`

A response containing a list of roles

## Other responses

- `500` — An unexpected error occurred preventing the operation from being performed.

---

[API](https://skmtc.dev/hiddenlayerai/apis/hiddenlayer-audit-api.md) · [All operations](https://skmtc.dev/hiddenlayerai/apis/hiddenlayer-audit-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hiddenlayerai/hiddenlayer-audit-api/revisions/45f22ddfb53a/schema)