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. <Check title="Required Permissions">Any authenticated user.</Check>

Path parameters

projectIdstringRequiredformat: "uuid"
The id of the project.

Headers

AuthorizationstringRequired

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

Request

The model to create a new task status.
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
idstring or nullformat: "uuid"
The primary identifier of this task status.
namestring or null
The name of the task status.
typestring or null
Of what general type is this task status?.
orderdouble or null
The order of the task status in a project.
iconstring or null
The icon of the task status.
projectIdstring or nullformat: "uuid"
Is set if the task status is related to a project.
projectTypeIdstring or nullformat: "uuid"
Is set if the task status is related to a project type.
createdOnstring or nullformat: "date-time"
The date this entity was created.
createdBystring or nullformat: "uuid"
The id of the user who created this entity.
updatedOnstring or nullformat: "date-time"
The date this entity was last modified.
updatedBystring or nullformat: "uuid"
The id of the user who last modified this entity.