API ReferenceTask Status

Create TaskStatus

Creates a new TaskStatus level for a specific Project within your Workspace. A TaskStatus is a named status level used by your business to determine how to measure the progress of Tasks. You can define your own named status levels that are appropriate for your business.

Path parameters

projectIdstringRequiredformat: "uuid"
The unique identifier of the Project for the new TaskStatus

Headers

AuthorizationstringRequired

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

x-integration-namestringOptional
The name of the calling system passed along as a header parameter

Request

Information about the new TaskStatus level to create within this Project
namestringRequired>=1 character
The name of this TaskStatus.
idstringOptionalformat: "uuid"
The unique identifier of this TaskStatus.
isDonebooleanOptional
A numerical value that can be used to sort TaskStatus values according to the needs of your business.
orderintegerOptional
A numerical value that can be used to sort TaskStatus values according to the needs of your business.

Response

Success
errorobjectOptional
If the API call failed, this will contain information about the error that occurred.
successbooleanOptional

True if the API call succeeded; false otherwise.

hasErrorbooleanOptional
True if the API call failed.
statusCodeobjectOptional
The HTTP code of the response.
dataobjectOptional
A TaskStatus is a named status level used by your business to determine how to measure the progress of Tasks. You can define your own named status levels that are appropriate for your business and determine which status levels are considered done.