---
title: "Изменить"
method: PUT
path: "/api-v2/tasks/{id}"
tags: ["Задачи"]
---

# Изменить

`PUT /api-v2/tasks/{id}`

## 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/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- UpdateTaskDto
  - `deleted` boolean: Если true, значит объект удален
  - `title` string: Название задачи
  - `columnId` string: Id колонки родителя. Для удаления задачи из колонки использовать "-"
  - `description` string: Описание задачи
  - `archived` boolean: Задача перенесена в архив - да/нет
  - `completed` boolean: Задача выполнена - да/нет
  - `subtasks` string[]: Массив Id подзадач
  - `assigned` string[]: Массив Id пользователей, на которых назначена задача
  - `deadline` UpdateDeadline
    - `deadline` number: Timestamp дэдлайна
    - `startDate` number: Timestamp начала задачи
    - `withTime` boolean: Отображать на стикере время, или только дату
    - `history` string[]: История изменений дедлайна
    - `blockedPoints` string[], required: Точки, которые блокируют дату дедлайна (Начало или Конец)
    - `links` string[], required: Связанные задачи
    - `deleted` boolean: Открепить стикер от задачи (true)
    - `empty` boolean: Прикрепить стикер дедлайна без значения
  - `timeTracking` UpdateTimeTracking
    - `plan` number: Сколько часов было запланировано на выполнение задачи
    - `work` number: Сколько часов было затрачено на выполнение задачи
    - `deleted` boolean: Открепить стикер от задачи (true)
  - `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: Данные конфигуратора
  - `timer` UpdateTimer
    - `seconds` number: Установить время таймера в секундах.
    - `running` boolean: Запустить или остановить таймер.
    - `deleted` boolean: Открепить стикер от задачи (true)
  - `stopwatch` UpdateStopwatch
    - `running` boolean: Запустить или остановить секундомер
    - `deleted` boolean: Открепить стикер от задачи (true)
  - `deal` DealDataDto
    - `dealAmount` number, nullable: Сумма сделки (null для удаления)
    - `contactPersonIds` string[], nullable: ID контактных лиц. Передать [] для отвязки всех контактов
    - `organizationId` string, nullable: ID организации. Передать null для отвязки организации
    - `customFields` object: Кастомные поля CRM (fieldId -> value)
  - `extensionData` object: Данные для работы расширения

## Response `200`

Задача успешно обновлена.

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

## Other responses

- `404`

## 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/:id/put.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)