Создание
Операция: Create
Создаёт задачу.
POST /api/v01/Task/rest/Create
Content-Type: application/json
Тело запроса
| Поле | Тип | Обязательность | Описание |
|---|---|---|---|
TaskData.ProjectID | string | один из двух | Проект-владелец задачи (по внутреннему ID) |
TaskData.ProjectCode | string | один из двух | Проект-владелец задачи (по коду) |
TaskData.TaskText | string | да | Заголовок задачи |
TaskData.StatusID | string | нет | Статус (если не задан — стартовый для типа) |
TaskData.TaskTypeID | string | нет | Тип задачи |
TaskData.PriorityID | string | нет | Приоритет |
TaskData.AssigneeID | string | нет | Исполнитель |
TaskData.ReporterID | string | нет | Постановщик (по умолчанию — текущий пользователь) |
TaskData.OriginalEstimate | number (sec) | нет | Исходная оценка |
TaskData.StoryPoint | number | нет | Story points |
TaskData.DateTimeStart | string ISO | нет | Плановая дата начала |
TaskData.DateTimeEnd | string ISO | нет | Плановая дата окончания |
TaskData.DueDateTime | string ISO | нет | Срок |
TaskData.Label | string | нет | Метка |
TaskData.Component | string | нет | Компонент |
TaskData.FixVersion | string | нет | Версия исправления |
TaskData.ParentTaskID | string | нет | Родительская задача (если иерархия) |
TaskData.ParentTaskKey | string | нет | То же по бизнес-ключу |
TaskData.ParentTaskIntegrationID | string | нет | То же по внешнему ID |
ParentTaskKeyField | string | нет | Имя ведущего ключа родителя: TaskID/TaskKey/IntegrationID |
TaskData.MeetingHeaderID | string | нет | Привязка к совещанию |
TaskData.AgendaID | string | нет | Привязка к пункту повестки |
TaskData.IntegrationID | string | нет | Внешний ID задачи |
TaskData.AttachmentID | string | нет | Привязать существующее вложение к создаваемой задаче |
TaskData.Watchers | array | нет | Список UserID подписчиков |
TaskData.Sprints | array | нет | Список SprintID |
TaskData.CustomFields | array | нет | Значения кастомных полей |
Description | string (HTML) | нет | Описание задачи в формате RTE; передаётся на верхнем уровне тела запроса (не внутри TaskData) |
Валидация
- Должен быть указан
ProjectIDилиProjectCode. Если оба отсутствуют —HTTP 500,statusText: "Wrong parameters". - Тело запроса должно содержать объект
TaskData.
Побочные эффекты
- Если в теле передан
Description, после создания задачи описание сохраняется отдельно как HTML-файл в подсистеме вложений.
Ответ
Успех:
{
"status": "Success",
"statusCode": 200,
"details": {
"TaskKey": "PROJ-42",
"TaskID": "0000004242"
}
}
Ошибка (пример бизнес-ошибки):
{
"status": "Error",
"statusCode": 399,
"statusText": "JBTASKS.TASK_PROJECT_NOT_FOUND"
}
Пример
POST /api/v01/Task/rest/Create
Content-Type: application/json
{
"TaskData": {
"ProjectCode": "PROJ",
"TaskText": "Починить логин",
"TaskTypeID": "BUG",
"PriorityID": "HIGH",
"AssigneeID": "0000001234",
"DueDateTime": "2026-06-01T18:00:00",
"Watchers": ["0000001111", "0000002222"]
},
"Description": "<p>При вводе пароля более 20 символов происходит сброс формы.</p>"
}