API v1 ReferenceTask Statuses

Creates a new task status for the specified project template.

<Check title="Required Permissions" icon="key">The user must be an admin or have `project-manage-config:write` permissions.</Check>

Authentication

AuthorizationBearer

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

Path parameters

projectTemplateIdstringRequiredformat: "uuid"
The id of the project template.

Request

The task Status form payload.
namestringRequired1-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.
createdOndatetime or null
The date this entity was created.
createdBystring or nullformat: "uuid"
The id of the user who created this entity.
updatedOndatetime or null
The date this entity was last modified.
updatedBystring or nullformat: "uuid"
The id of the user who last modified this entity.

Errors