---
title: "ListRoles lists all the roles available for orgs and projects."
method: GET
path: "/v1/roles"
---

# ListRoles lists all the roles available for orgs and projects.

`GET /v1/roles`

## Response `200`

A successful response.

- V1ListRolesResponse
  - `organizationRoles` V1OrganizationRole[]
    - `id` string
    - `name` string
    - `permissions` V1OrganizationPermissions
      - `admin` boolean
      - `createProjects` boolean
      - `guest` boolean
      - `manageOrg` boolean
      - `manageOrgAdmins` boolean
      - `manageOrgMembers` boolean
      - `manageProjects` boolean
      - `readOrg` boolean
      - `readOrgMembers` boolean
      - `readProjects` boolean
  - `projectRoles` V1ProjectRole[]
    - `id` string
    - `name` string
    - `permissions` V1ProjectPermissions
      - `admin` boolean
      - `createAlerts` boolean
      - `createBookmarks` boolean
      - `createMagicAuthTokens` boolean
      - `createReports` boolean
      - `manageAlerts` boolean
      - `manageBookmarks` boolean
      - `manageDev` boolean
      - `manageMagicAuthTokens` boolean
      - `manageProd` boolean
      - `manageProject` boolean
      - `manageProjectAdmins` boolean
      - `manageProjectMembers` boolean
      - `manageProvisionerResources` boolean
      - `manageReports` boolean
      - `readDev` boolean
      - `readDevStatus` boolean
      - `readProd` boolean
      - `readProdStatus` boolean
      - `readProject` boolean
      - `readProjectMembers` boolean
      - `readProvisionerResources` boolean

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/rilldata/apis/rill-admin-api.md) · [All operations](https://skmtc.net/rilldata/apis/rill-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rilldata/rill-admin-api/revisions/289a0ca9ce49/schema)