Labels

Coloured tags used to categorise and filter records across modules (Todo, Business Case, Business Offer, Business Order, Contact, Note, Page, Invoice, Purchase, Product, Chart, File, and more).

*

A label is assigned to one or more spaces via the spaces field. A label with no spaces is global: it is visible to every user and can be attached to records in any space. A label assigned to specific spaces is visible to users who have access to at least one of those spaces.

*

Module scoping: a label can only be attached to a record whose module matches the label's module constraint. The constraint is the global module field, or - more granularly - the list of modules configured per space inside spaces. A label with no module constraint can be attached to records of any module.

*

Labels are attached to records via sub-resource endpoints: POST /{module}/{id}/label/{labelId}.

*

When listing labels, the space query parameter restricts the result to labels belonging to the given space(s). It accepts a single space ID or a comma-separated list (e.g. ?space=12,34). Global labels (those with no space assigned) are always included regardless of the filter.