Create TaskStatus

POST

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 and determine which status levels are considered done.

Path parameters

projectIdstringRequired

The unique identifier of the Project for the new TaskStatus

Request

This endpoint expects an object.

namestringRequired

The name of this TaskStatus.

idstringOptional

The unique identifier of this TaskStatus.

orderintegerOptional

A numerical value that can be used to sort TaskStatus values according to the needs of your business.

Response

This endpoint returns an object.

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.

statusCodeenumOptional

The HTTP code of the response.

dataobjectOptional

Replace TaskTags

Up Next

Built with

1	curl -X POST /project-api/public/projects/projectId/tasks/statuses \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"name": "name"
6	}'

1	{
2	"error": {
3	"message": "message"
4	},
5	"success": true,
6	"hasError": true,
7	"statusCode": "Continue",
8	"data": {
9	"id": "id",
10	"projectId": "projectId",
11	"name": "name",
12	"order": 1,
13	"isDone": true
14	}
15	}