Create

Operation: Create

Creates a task.


POST /api/v01/Task/rest/Create
Content-Type: application/json


Request body

FieldTypeRequiredDescription
TaskData.ProjectIDstringone of twoOwner project (by internal ID)
TaskData.ProjectCodestringone of twoOwner project (by code)
TaskData.TaskTextstringyesTask title
TaskData.StatusIDstringnoStatus (if not set — starting status for the type)
TaskData.TaskTypeIDstringnoTask type
TaskData.PriorityIDstringnoPriority
TaskData.AssigneeIDstringnoAssignee
TaskData.ReporterIDstringnoReporter (defaults to the current user)
TaskData.OriginalEstimatenumber (sec)noOriginal estimate
TaskData.StoryPointnumbernoStory points
TaskData.DateTimeStartstring ISOnoPlanned start date
TaskData.DateTimeEndstring ISOnoPlanned end date
TaskData.DueDateTimestring ISOnoDue date
TaskData.LabelstringnoLabel
TaskData.ComponentstringnoComponent
TaskData.FixVersionstringnoFix version
TaskData.ParentTaskIDstringnoParent task (if hierarchy)
TaskData.ParentTaskKeystringnoSame by business key
TaskData.ParentTaskIntegrationIDstringnoSame by external ID
ParentTaskKeyFieldstringnoName of the parent leading key: TaskID/TaskKey/IntegrationID
TaskData.MeetingHeaderIDstringnoLink to a meeting
TaskData.AgendaIDstringnoLink to an agenda item
TaskData.IntegrationIDstringnoTask external ID
TaskData.AttachmentIDstringnoAttach an existing attachment to the new task
TaskData.WatchersarraynoList of watcher UserIDs
TaskData.SprintsarraynoList of SprintIDs
TaskData.CustomFieldsarraynoCustom field values
Descriptionstring (HTML)noTask description in RTE format; passed at the top level of the request body (not inside TaskData)


Validation

  • Either ProjectID or ProjectCode must be provided. If both are missing — HTTP 500, statusText: "Wrong parameters".
  • The request body must contain a TaskData object.


Side effects

  • If Description is included in the body, after the task is created the description is stored separately as an HTML file in the attachments subsystem.


Response

Success:


{
  "status": "Success",
  "statusCode": 200,
  "details": {
    "TaskKey": "PROJ-42",
    "TaskID": "0000004242"
  }
}


Error (example of a business error):


{
  "status": "Error",
  "statusCode": 399,
  "statusText": "JBTASKS.TASK_PROJECT_NOT_FOUND"
}


Example

POST /api/v01/Task/rest/Create
Content-Type: application/json

{
  "TaskData": {
    "ProjectCode": "PROJ",
    "TaskText": "Fix login",
    "TaskTypeID": "BUG",
    "PriorityID": "HIGH",
    "AssigneeID": "0000001234",
    "DueDateTime": "2026-06-01T18:00:00",
    "Watchers": ["0000001111", "0000002222"]
  },
  "Description": "<p>When a password longer than 20 characters is entered, the form is reset.</p>"
}