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

Создать задачу в существующем проекте.

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

Подчиняется проверке лимитов тарифа аккаунта (аккаунты в limited-mode отклоняются). Атрибуция (CreatedBy) устанавливается равной ApiKey.CreatedByUserId. Если задан AssigneeId, пользователь должен быть активным участником аккаунта.

Payload создания задачи.

Тело запроса для POST /api/public/v1/tasks.

object
projectId

Идентификатор проекта-владельца (обязателен; должен принадлежать тому же аккаунту).

integer format: int32
title

Название (1..200 символов, обязательно).

string
nullable
description

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

string
nullable
priority

Приоритет (опционально; 0 при пропуске).

integer format: int32
nullable
dueDate

Дата дедлайна (опционально; только дата - компонент времени игнорируется).

string format: date-time
nullable
assigneeId

Идентификатор основного исполнителя (опционально; должен быть активным участником аккаунта).

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

Созданная FlowWorker.Backend.PublicApi.Dto.PublicTaskDto.

Рабочая задача 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, неизвестный projectId, исполнитель не входит в аккаунт).

Отсутствует scope tasks:write или аккаунт в limited-mode.