---
title: "List the v1 system roles and their permission matrix."
method: GET
path: "/v1/roles"
tags: ["Roles"]
---

# List the v1 system roles and their permission matrix.

`GET /v1/roles`

## Request

- Base URL: `https://api.yardstick.team`
- URL: `https://api.yardstick.team/v1/roles`
- Auth: HTTP bearer

## Response `200`

The 5 v1 system roles (admin, recruiter, department_lead, hiring_manager, interviewer).

- object
  - `data` Role[], required
    - `id` 'admin' | 'recruiter' | 'department_lead' | 'hiring_manager' | 'interviewer', required
    - `label` string, required
    - `description` string, required
    - `scopes` string[], required
    - `permissions` object, required: Map of resource → highest action the role holds. Resources are the locked v1 list documented in docs/product/roles-and-permissions/v1-decision-record.md Appendix A.

## Other responses

- `401` (unresolved $ref)
- `403` (unresolved $ref)

---

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