API v1 ReferenceProject Tasks

Creates a new task status for the specified project.

Creates a new task status for the specified project. To create the task status, the user need write permissions on feature Project-Planning.

Required Permissions
Any authenticated user.

Path parameters

projectIdUUIDRequired
The id of the project.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
namestringRequired>=1 character<=30 characters
The name of the task status.
typestringRequired>=1 character

Specifies the general type of this task status. Accepted values: ‘todo’, ‘progress’, ‘review’, ‘stuck’, ‘done’.

orderdouble or nullOptional
The order of the task status. If it is null, the task status will be appended after the last task status.
iconstring or nullOptional
The icon of the task status.

Response

OK
idUUID or null
The primary identifier of this task status.
namestring or null or null
The name of the task status.
typestring or null or null
Of what general type is this task status?.
orderdouble or null or null
The order of the task status in a project.
iconstring or null or null
The icon of the task status.
projectIdUUID or null or null
Is set if the task status is related to a project.
projectTypeIdUUID or null or null
Is set if the task status is related to a project type.
createdOndatetime or null
The date this entity was created.
createdByUUID or null
The id of the user who created this entity.
updatedOndatetime or null
The date this entity was last modified.
updatedByUUID or null
The id of the user who last modified this entity.