Maintenance v1
The Maintenance API allows external systems to manage service tickets in Bloxs, covering the full lifecycle of reporting, tracking, and resolving maintenance issues on real estate objects. It supports creating, retrieving, and updating service tickets, changing a ticket's state to done, and enriching tickets with notes and file attachments.
Service tickets
A service ticket represents a reported issue or maintenance request tied to a real estate object, such as a building, complex, section, or unit. Each ticket records who reported the issue, its priority and problem category, whether a supplier is handling it, and whether the associated costs are for the tenant or the owner. Tickets move through a configurable set of states, from active through to done, and can be enriched over time with notes and file attachments as the issue is worked on.
Generic and reference endpoints
Alongside the service ticket endpoints, the API exposes read-only lookup endpoints for the configurable reference data used on tickets: ticket states, problem categories, and cost categories. These reflect the configuration defined in the Bloxs admin settings and are intended to be checked before creating or updating a ticket, since the available values can change over time.