Перейти к содержимому

Частично обновить задачу.

PATCH
/api/public/v1/tasks/{id}
curl -X PATCH \
-H "Authorization: Bearer $FW_KEY" \
-H "Content-Type: application/json" \
-d '{ /* fields per request body schema */ }' \
"https://api.flowworker.ru/api/public/v1/tasks/{id}"

Все поля в FlowWorker.Backend.PublicApi.Dto.PublicTaskPatchDto опциональны - записываются только не-null значения. Чтобы очистить DueDate, передайте ClearDueDate: true. При смене Status задача перемещается в конец новой колонки (KanbanOrder = max(target) + 1024).

Поддерживает оптимистическую конкурентность: передавайте заголовок If-Match: "<version>" (из ETag предыдущего GET); запрос отклоняется с 412, если задача была изменена после того, как вы её получили.

id
required
integer format: int64

Идентификатор задачи.

Параметры заголовков

Заголовок раздела «Header Parameters »
If-Match
string

Опциональный заголовок If-Match с ожидаемой текущей версией.

Patch-payload - применяются только не-null поля.

Тело запроса для PATCH /api/public/v1/tasks/{id}. Все поля опциональны; применяются только не-null значения.

object
title

Новое название (1..200 символов).

string
nullable
description

Новое описание.

string
nullable
status

Новый ключ статуса; смена статуса перемещает задачу в конец целевой Kanban-колонки.

string
nullable
priority

Новый приоритет.

integer format: int32
nullable
dueDate

Новая дата дедлайна. Игнорируется, если FlowWorker.Backend.PublicApi.Dto.PublicTaskPatchDto.ClearDueDate равен true.

string format: date-time
nullable
clearDueDate

Установите true, чтобы очистить DueDate (имеет приоритет над DueDate, если оба заданы).

boolean
assigneeId

Новый идентификатор основного исполнителя. Передайте 0 (или любое не-положительное число), чтобы снять назначение.

integer format: int32
nullable
Example generated
{
"title": "example",
"description": "example",
"status": "example",
"priority": 1,
"dueDate": "2026-04-15T12:00:00Z",
"clearDueDate": true,
"assigneeId": 1
}

Обновлённая задача. Заголовок ETag содержит новую версию.

Рабочая задача FlowWorker.

object
id

Идентификатор задачи.

integer format: int64
projectId

Идентификатор проекта, которому принадлежит задача.

integer format: int32
title

Название.

string
nullable
description

Описание (свободный текст / Markdown - зависит от клиента).

string
nullable
status

Task status as exposed via public API. Resolves StatusKey (Todo/InProgress/Done/Blocked/Custom1..12) against per-project ProjectTaskStatus row to obtain human-readable Label, IsDone, and Color.

object
key
string
nullable
label
string
nullable
isDone
boolean
color
string
nullable
priority

Приоритет (числовая шкала проекта; 0 означает «не задан»).

integer format: int32
nullable
dueDate

Дата дедлайна (только дата; сериализуется как DateTime в полночь UTC).

string format: date-time
nullable
assigneeId

Идентификатор основного исполнителя (null, если основной исполнитель не назначен).

integer format: int32
nullable
tags

Список тегов задачи (project-defined ключи).

Array<string>
nullable
createdAt

Время создания (UTC).

string format: date-time
updatedAt

Время последнего изменения (UTC).

string format: date-time
nullable
version

Токен оптимистической конкурентности; совпадает с заголовком ответа ETag.

integer format: int32
Example
{
"id": 9001,
"projectId": 123,
"title": "Refactor auth handler",
"description": "Move scope-check into middleware.",
"status": "in-progress",
"priority": 2,
"dueDate": "2026-05-30",
"assigneeId": 7,
"createdAt": "2026-05-16T10:42:18Z",
"updatedAt": "2026-05-16T11:15:02Z",
"version": 3
}

Ошибка валидации (например, длина title, исполнитель не входит в аккаунт).

Задача не найдена.

Устаревшая версия в If-Match. Текущий ETag возвращается в ответе.