EaserixDocs
DevelopersAPI referenceTasksLabels

List labels

Labels across the org's teams, ordered by name. Filter with team_id.

View as Markdown
GET
/v1/labels

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/labels"
{  "labels": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec",      "name": "string",      "color": "string"    }  ]}

Fetch an attachment (no auth — presigned redirect)

PUBLIC — deliberately unauthenticated and not org-checked so presigned redirects work directly in an <img src>: the unguessable attachment UUID is the access capability. 302-redirects to a presigned R2 URL valid for 24 hours. 501 when storage is not configured.

Create a label

Color defaults to "#95a2b3". The team must belong to the caller's org (else 404). `name` is stored trimmed and must be unique within the team, compared case-insensitively — a name already in use is a 409, whatever colour it is sent with. Two different teams may each use the same name.