Deletes a project status from the workflow. | awork API

If any projects are currently using this status, you must provide a NewProjectStatusId in the request body to migrate those projects 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 project status to ensure projects using this workflow have a valid status. If you attempt to delete the last remaining project status, this endpoint will return a BadRequest error. If any projects are currently using this status, you must provide a NewProjectStatusId in the request body to migrate those projects 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.

projectStatusIdstringRequiredformat: "uuid"

The Id of the project status to delete.

Request

Optional form containing the new status Id for migration.

newProjectStatusIdstring or nullOptionalformat: "uuid"

The Id of the project status to migrate projects to. Required if any projects 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/projectstatuses/projectStatusId/delete \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"newProjectStatusId": "9f8b7c6d-1234-4a56-b789-0c1d2e3f4a5b"
6	}'