---
title: "Get available roles"
method: GET
path: "/v1/roles"
tags: ["Platform Config"]
---

# Get available roles

`GET /v1/roles`

## Request

- Base URL: `https://lpad-backend.stage.defi.ovh.gala.com`
- URL: `https://lpad-backend.stage.defi.ovh.gala.com/v1/roles`
- Auth: none declared
- TypeScript: <https://skmtc.dev/gala/apis/launchpad-backend-api/docs/v1/roles/get.ts> (a function with typed inputs; its response is checked against the schema)

Get available roles

## Response `200`

Available roles retrieved successfully

- object
  - `error` false, required: Successful response marker.
  - `message` string, required: Response message.
  - `status` number, required: HTTP status code.
  - `data` AvailableRolesResponse, required
    - `permissions` string[], required: List of all available permission names
    - `roles` RoleInfo[], required: List of available roles with their details
      - `description` string, required: Human-readable description of the role
      - `level` number, required: Hierarchy level (higher = more privileges). MODERATOR=0, TECHNICAL_PRODUCER=1, MANAGER=2, OWNER=3
      - `name` 'OWNER' | 'MANAGER' | 'TECHNICAL_PRODUCER' | 'MODERATOR', required: Role name identifier
      - `permissions` string[], required: List of permissions this role has

## Other responses

- `500`: Available roles could not be retrieved.
- `default`: Shared error envelope returned by the application exception filter.

---

[API](https://skmtc.dev/gala/apis/launchpad-backend-api.md) - [All operations](https://skmtc.dev/gala/apis/launchpad-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gala/apis/launchpad-backend-api/revisions/74545971be2b?raw)