Task Status

Update TaskStatus

PUT

Updates an existing 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

projectIdstringRequired
The unique identifier of the Project for the new TaskStatus

Request

This endpoint expects an object.
id
stringOptional
The unique identifier of this TaskStatus.
name
stringOptional
The name of this TaskStatus.
order
integerOptional
A numerical value that can be used to sort TaskStatus values according to the needs of your business.

Response

This endpoint returns an object
error
objectOptional
If the API call failed, this will contain information about the error that occurred.
success
booleanOptional
True if the API call succeeded; false otherwise.
hasError
booleanOptional
True if the API call failed.
statusCode
enumOptional
The HTTP code of the response.
data
objectOptional
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.
PUT
1curl -X PUT /api/data/projects/projectId/tasks/statuses \
2 -H "Authorization: Bearer <token>" \
3 -H "Content-Type: application/json" \
4 -d '{}'
200
Updated
1{
2 "error": {
3 "technicalError": "technicalError",
4 "additionalErrors": [
5 "additionalErrors"
6 ],
7 "message": "message"
8 },
9 "success": true,
10 "hasError": true,
11 "statusCode": "Continue",
12 "data": {
13 "id": "id",
14 "projectId": "projectId",
15 "name": "name",
16 "order": 1,
17 "isDone": true
18 }
19}