---
title: "Создать"
method: POST
path: "/api-v2/tasks"
tags: ["Задачи"]
---

# Создать

`POST /api-v2/tasks`

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

## Request body

- CreateTaskDto
  - `title` string, required: Название задачи
  - `columnId` string: Id колонки родителя
  - `description` string: Описание задачи
  - `archived` boolean: Задача перенесена в архив - да/нет
  - `completed` boolean: Задача выполнена - да/нет
  - `subtasks` string[]: Массив Id подзадач
  - `assigned` string[]: Массив Id пользователей, на которых назначена задача
  - `deadline` Deadline
    - `deadline` number, required: Timestamp дэдлайна
    - `startDate` number: Timestamp начала задачи
    - `withTime` boolean: Отображать на стикере время, или только дату
    - `history` string[]: История изменений дедлайна
    - `blockedPoints` string[], required: Точки, которые блокируют дату дедлайна (Начало или Конец)
    - `links` string[], required: Связанные задачи
  - `timeTracking` TimeTracking
    - `plan` number, required: Сколько часов было запланировано на выполнение задачи
    - `work` number, required: Сколько часов было затрачено на выполнение задачи
  - `checklists` CheckList[]: Чеклисты. К задаче всегда будет присвоен переданный объект. Если необходимо внести изменения, нужно сначала получить чеклисты, затем произвести корректировку, а затем записать в задачу заново.
    - `title` string, required: Название списка чеклистов
    - `items` CheckListItem, required
      - `title` string, required: Название чеклиста
      - `isCompleted` boolean, required: Выполненность чеклиста
  - `stickers` object: Пользовательские стикеры. Передаются в виде объекта ключ-значение, где ключ — ID стикера, значение — ID состояния для стикеров с состоянием или строка со значением для стикеров свободных полей.<br /> Для открепления стикера от задачи, используйте "-" как значение состояния.<br /> Для прикрепления пустого стикера (без состояния), используйте "empty" как значение состояния.<br /> Для стикеров типа "свободное текстовое поле" передавайте произвольную строку, например "ООО «Производство»".<br /> Для стикеров типа "свободное числовое поле" передавайте строку, содержащую число, например "123" или "345.123"; разделитель целой и дробной части — точка "."<br /> Стикер с состояниями, в настройках которого разрешено несколько значений, принимает и возвращает массив ID состояний.
  - `color` 'task-primary' | 'task-gray' | 'task-red' | 'task-pink' | 'task-yellow' | 'task-green' | 'task-turquoise' | 'task-blue' | 'task-violet': Цвет карточки задач на доске, доступны цвета: task-primary, task-gray, task-red, task-pink, task-yellow, task-green, task-turquoise, task-blue, task-violet
  - `idTaskCommon` string: ID задачи, сквозной через всю компанию
  - `idTaskProject` string: ID задачи, внутри проекта
  - `apiData` object: Данные конфигуратора
  - `stopwatch` CreateStopwatch
    - `running` boolean, required: Запустить или остановить секундомер
  - `timer` CreateTimer
    - `seconds` number, required: Установить время таймера в секундах.
    - `running` boolean, required: Запустить или остановить таймер.
  - `deal` DealDataDto
    - `dealAmount` number, nullable: Сумма сделки (null для удаления)
    - `contactPersonIds` string[], nullable: ID контактных лиц. Передать [] для отвязки всех контактов
    - `organizationId` string, nullable: ID организации. Передать null для отвязки организации
    - `customFields` object: Кастомные поля CRM (fieldId -> value)
  - `extensionData` object: Данные для работы расширения
  - `idempotencyKey` string: Идемпотентный ключ создания задачи. Повторный запрос с тем же ключом вернет уже созданную задачу.

## Response `201`

Задача успешно создана.

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

## Changes

- **2026-09-24** `0e55bd2c3698`: 1 info
  - added the new optional request property `apiData`

[Operation history](https://skmtc.dev/yougile/apis/yougile-rest-api-v2-0/changes/api-v2/tasks/post.md)

---

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