Docs
API Reference

Asset categories

Customer-item (device) categories

Required scopes: categories:read / categories:write / categories:delete.

Collection: customerItemCategories. The app joins devices to a category by name (type / customerDeviceType), not by document id.

  • GET/organisations/{orgId}/asset-categories
  • POST/organisations/{orgId}/asset-categories
  • GET/organisations/{orgId}/asset-categories/{categoryId}
  • PUT/organisations/{orgId}/asset-categories/{categoryId}
  • DELETE/organisations/{orgId}/asset-categories/{categoryId}

icon vs iconId

Writes accept iconId only. The app's icon field is never written by the API.