---
title: "Создать"
method: POST
path: "/api-v2/projects"
tags: ["Проекты"]
---

# Создать

`POST /api-v2/projects`

## 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`
- Auth: HTTP bearer

## Request body

- CreateProjectDto
  - `title` string, required: Название проекта
  - `users` object: Сотрудники на проекте и их роль. Возможные значения: <br/><div>1) системные роли: worker, admin, observer</div><div>2) ID пользовательской роли</div><div>3) "-" для удаления существующего пользователя из проекта</div><div>Нельзя изменять роли пользователей, получивших доступ через отдел</div>
  - `departments` object: Отделы на проекте и маппинг ролей. Возможные значения: <br/><div>1) объект с manager и member</div><div>2) "-" для удаления привязки отдела</div>
  - `idempotencyKey` string: Идемпотентный ключ создания проекта. Повторный запрос с тем же ключом вернет уже созданный проект.

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