Labels — list and create

Manage labels that can be applied to work orders and assets.

Endpoints

MethodPathDescription
GET/labelsList all active labels (paginated, filterable by type)
POST/labelsCreate a label
GET/labels/{labelId}Get a label by ID

Query parameters (GET /labels)

ParameterTypeDefaultDescription
typeWORK | ASSETFilter by label type. Omit to return all types.
pageinteger1Page number (1-based, max 1000)
page_sizeinteger20Results per page (max 100)

Create a label

POST /labels
1{
2 "name": "Urgent",
3 "color": "#FF5733",
4 "type": "WORK"
5}
  • name — required, non-empty string.
  • type — required; WORK applies the label to work orders, ASSET to assets. Note: the public API uses WORK where the internal system uses TASK.
  • color — optional hex color code; pass null to create a label with no color.

Label object

1{
2 "id": 101,
3 "name": "Urgent",
4 "color": "#FF5733",
5 "type": "WORK",
6 "createdAt": "2026-04-30T00:00:00.000Z",
7 "updatedAt": "2026-04-30T00:00:00.000Z"
8}