Create task

Request body

namestringRequired

Task name (1 to 255 characters).

parentIdinteger | nullRequired

ID of the parent task. null makes the task top-level.

projectIdintegerRequired

ID of the project the task belongs to.

responsibleUserIdinteger | nullRequired

ID of the user assigned to the task. null leaves it unassigned.

ballHoldingUserIdinteger | nullRequired

ID of the user who currently holds the ball, meaning who needs to act next. null means nobody.

statusIdinteger | nullRequired

ID of the status, which must belong to the task's project. null clears the status.

milestoneIdinteger | nullRequired

ID of the milestone, which must belong to the task's project. null clears the milestone.

priorityinteger | null

Priority: 1 is High, 2 is Mid, 3 is Low. null clears the priority.

descriptionstring | null

Task description as Markdown (up to 20,000 characters). null clears it.

startDatenumber | null

Start date as a Unix timestamp in milliseconds. null clears it.

dueDatenumber | null

Due date as a Unix timestamp in milliseconds. null clears it.

extraobject | null

Extra display settings. Only color (a color string such as #8CC230, or null) is meaningful.

tagsstring[]

Names of tags to attach. Tags that do not exist yet are created.

subTasksobject[]

Subtasks to create under the new task (up to 100). They share the new task's project and status.

Responses

• 200Task created
• 400Invalid request payload
• 401Authentication is required