EaserixDocs
DevelopersAPI referenceTasksStates

Delete a workflow state

Hard delete, and only when nothing points at the state. Issues carry a NOT NULL state, so a state that still has issues is a 409 naming how many — move them to another state first, then delete it. Also a 409 when this is the last state of its `type` in the team: progress bars, completion %, and My Issues' active filter all read a state's type, not its name, so a category (e.g. every `completed` state) left empty would silently stop working rather than fail loudly. Create or keep another state of the same type first.

View as Markdown
DELETE
/v1/states/{id}

Authorization

bearer
AuthorizationBearer <token>

In: header

Path Parameters

id*string
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/states/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "message": "string"}

Update a workflow state

Partial update — only provided fields change. A `name` that another state in the same team already uses is a 409; a blank one is a 400. Re-sending the state's own name is always allowed. A `type` outside the enum is a 400 naming the allowed set. Changing `type` away from the team's only state of that category is a 409, same rule DELETE already enforces — re-sending the state's own current type is always allowed, even when it is that only state.

List projects

Projects across the org's teams, newest first. Filter with team_id.