---
title: "Получить список"
method: GET
path: "/api-v2/projects/{projectId}/roles"
tags: ["Роли проекта"]
---

# Получить список

`GET /api-v2/projects/{projectId}/roles`

## Request

- Base URL: `https://api-docs.yougile.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.yougile.com/api-v2/projects/{projectId}/roles`
- Auth: HTTP bearer

## Path parameters

- `projectId` string, required

## Query parameters

- `limit` number
- `offset` number
- `name` string

## Response `200`

- ProjectRoleListDto
  - `paging` PagingMetadata, required
    - `count` number, required: Количество элементов в результате
    - `limit` number, required: Количество элементов на страницу
    - `offset` number, required: Индекс первого элемента страницы
    - `next` boolean, required: Есть ли элементы после данной страницы
  - `content` ProjectRoleListDtoBase[], required: Список ролей в проекте
    - `id` string, required: ID объекта
    - `name` string, required: Название роли
    - `description` string: Описание роли
    - `permissions` ProjectPermissionsDto, required
      - `editTitle` boolean, required
      - `delete` boolean, required
      - `addBoard` boolean, required
      - `boards` BoardPermissionsDto, required
        - `editTitle` boolean, required
        - `delete` boolean, required
        - `move` boolean, required
        - `showStickers` boolean, required
        - `editStickers` boolean, required
        - `addColumn` boolean, required
        - `columns` ColumnPermissionsDto, required
          - `editTitle` boolean, required
          - `delete` boolean, required
          - `move` 'no' | 'project' | 'yes', required
          - `addTask` boolean, required
          - `allTasks` TaskPermissionsDto, required
            - `show` boolean, required
            - `delete` boolean, required
            - `editTitle` boolean, required
            - `editDescription` boolean, required
            - `complete` boolean, required
            - `close` boolean, required
            - `assignUsers` 'no' | 'yes' | 'add-self' | 'set-self' | 'change-from-self', required
            - `connect` boolean, required
            - `editSubtasks` 'no' | 'yes' | 'complete', required
            - `editStickers` boolean, required
            - `editPins` boolean, required
            - `move` 'no' | 'project' | 'yes' | 'board', required
            - `sendMessages` boolean, required
            - `sendFiles` boolean, required
            - `editWhoToNotify` 'no' | 'yes' | 'self', required
          - `withMeTasks` TaskPermissionsDto, required
            - `show` boolean, required
            - `delete` boolean, required
            - `editTitle` boolean, required
            - `editDescription` boolean, required
            - `complete` boolean, required
            - `close` boolean, required
            - `assignUsers` 'no' | 'yes' | 'add-self' | 'set-self' | 'change-from-self', required
            - `connect` boolean, required
            - `editSubtasks` 'no' | 'yes' | 'complete', required
            - `editStickers` boolean, required
            - `editPins` boolean, required
            - `move` 'no' | 'project' | 'yes' | 'board', required
            - `sendMessages` boolean, required
            - `sendFiles` boolean, required
            - `editWhoToNotify` 'no' | 'yes' | 'self', required
          - `myTasks` TaskPermissionsDto, required
            - `show` boolean, required
            - `delete` boolean, required
            - `editTitle` boolean, required
            - `editDescription` boolean, required
            - `complete` boolean, required
            - `close` boolean, required
            - `assignUsers` 'no' | 'yes' | 'add-self' | 'set-self' | 'change-from-self', required
            - `connect` boolean, required
            - `editSubtasks` 'no' | 'yes' | 'complete', required
            - `editStickers` boolean, required
            - `editPins` boolean, required
            - `move` 'no' | 'project' | 'yes' | 'board', required
            - `sendMessages` boolean, required
            - `sendFiles` boolean, required
            - `editWhoToNotify` 'no' | 'yes' | 'self', required
          - `createdByMeTasks` TaskPermissionsDto, required
            - `show` boolean, required
            - `delete` boolean, required
            - `editTitle` boolean, required
            - `editDescription` boolean, required
            - `complete` boolean, required
            - `close` boolean, required
            - `assignUsers` 'no' | 'yes' | 'add-self' | 'set-self' | 'change-from-self', required
            - `connect` boolean, required
            - `editSubtasks` 'no' | 'yes' | 'complete', required
            - `editStickers` boolean, required
            - `editPins` boolean, required
            - `move` 'no' | 'project' | 'yes' | 'board', required
            - `sendMessages` boolean, required
            - `sendFiles` boolean, required
            - `editWhoToNotify` 'no' | 'yes' | 'self', required
        - `settings` boolean, required
      - `children` object: Точечные права для отдельных досок, колонок или задач проекта, ключ — id объекта

## Other responses

- `404`

---

[API](https://skmtc.dev/yougile/apis/yougile-rest-api-v2-0.md) - [All operations](https://skmtc.dev/yougile/apis/yougile-rest-api-v2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/yougile/apis/yougile-rest-api-v2-0/revisions/9452cba35716?raw)