Deletes the task status of the workflow with the specified id. | awork API

A workflow must always have at least one task status of type ‘todo’ and one of type ‘done’. If you attempt to delete the last status of either type, this endpoint will return a BadRequest error.

If any tasks are currently using this status, you must provide a NewTaskStatusId in the request body to migrate those tasks to a different status within the same workflow.

Required Permissions

The user must be an admin or have project-manage-config:write permissions.

A workflow must always have at least one task status of type 'todo' and one of type 'done'. If you attempt to delete the last status of either type, this endpoint will return a BadRequest error. If any tasks are currently using this status, you must provide a NewTaskStatusId in the request body to migrate those tasks to a different status within the same workflow. <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

workflowIdstringRequiredformat: "uuid"

The Id of the workflow.

taskStatusIdstringRequiredformat: "uuid"

The Id of the task status to delete.

Request

Optional form containing the new status Id for migration.

newTaskStatusIdstring or nullOptionalformat: "uuid"

The Id of the task status to migrate tasks to. Required if any tasks are currently using the status being deleted. Must be a different status within the same workflow.

Response

No Content

Errors

400

Bad Request Error

404

Not Found Error

1	curl -X POST https://api.awork.com/api/v1/workflows/workflowId/taskstatuses/taskStatusId/delete \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"newTaskStatusId": "9f8b7c6d-1234-4a56-b789-0c1d2e3f4a5b"
6	}'