---
title: "Создать"
method: POST
path: "/api-v2/projects/{projectId}/roles"
tags: ["Роли проекта"]
---

# Создать

`POST /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

## Request body

- CreateProjectRoleDto
  - `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 объекта

## Response `201`

- WithIdDto
  - `id` string, required: ID объекта

---

[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)