Create Label

Creates a new label for the company. Use WORK for work-order labels or ASSET for asset labels.

Authentication

x-api-keystring
API Key authentication via header

Request

This endpoint expects an object.
namestringRequired
Label name
typeenumRequired

Label type — WORK for work-order labels, ASSET for asset labels

Allowed values:
colorstring or nullOptional

Label color as a hex code (e.g. “#FF5733”)

Response

Label created successfully
idinteger
Label identifier
namestring
Label display name
colorstring or null

Label color as a hex code (e.g. “#FF5733”), or null if unset

typeenum

Label type — WORK for work-order labels, ASSET for asset labels

Allowed values:
createdAtstringformat: "date-time"
updatedAtstringformat: "date-time"

Errors

400
Bad Request Error
401
Unauthorized Error
500
Internal Server Error