EaserixDocs
DevelopersAPI referenceTasksStates

List workflow states

Workflow states across the org's teams, ordered by position. Filter with team_id (a team outside the org just yields an empty list).

View as Markdown
GET
/v1/states

Authorization

bearer
AuthorizationBearer <token>

In: header

Query Parameters

team_id?string

Restrict to one team.

Formatuuid

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/states"
{  "states": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec",      "name": "string",      "type": "backlog",      "color": "string",      "position": 0    }  ]}

Create a team

Creates a team in the caller's org, seeded with the default workflow states (Backlog, Todo, In Progress, Done, Canceled) so it can hold issues immediately. Key and name are stored trimmed, and both are unique per WORKSPACE — not per team like the names below, since teams are the tenant root. A key or a name another team in the org already holds is a 409. The two comparisons differ: names are compared trimmed and case-insensitively (one workspace cannot hold "Design" and "design", though two workspaces may each hold their own), while the key comparison is exact, so "eng" and "ENG" are currently two different keys in one workspace.

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.