Sign in

v1

latestOpenAPI 3.1.02026-08-066984441.1 MB
workflows

Deletes a project status from the workflow.

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>

post/workflows/{workflowId}/projectstatuses/{projectStatusId}/delete

Path parameters

workflowIdstring uuid required

The Id of the workflow.

projectStatusIdstring uuid required

The Id of the project status to delete.

Headers

Authorizationstring required

Bearer authentication

Request body

newProjectStatusIdstring uuid nullable

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

object required