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.
View as MarkdownAuthorization
bearer In: header
Path Parameters
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/v1/states/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Content-Type: application/json" \ -d '{}'{ "state": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec", "name": "string", "type": "backlog", "color": "string", "position": 0 }}Create a workflow state
Color defaults to "#95a2b3"; position defaults to (max position in the team) + 1. The team must belong to the caller's org (else 404 — org tenancy). `name` is stored trimmed and must be unique within the team, compared case-insensitively — a name already in use is a 409. Two different teams may each use the same name.
Delete a workflow state
Hard delete. Issues referencing the state are not reassigned.