Overview
The two built-in object types and how they relate.
Every workspace starts with two object types. They cover the physical layer: locations, and the equipment at them.
| Type | What it is | Relationship |
|---|---|---|
| Sites | A physical location with coordinates. | Contains assets through the built-in part attribute assets. stats.total_capacity_kw sums them. |
| Assets | A wind turbine, solar panel, or battery with a capacity. | A part of a site, or a workspace root on its own. |
An asset is contained by its site: it is created inside the site or with parent_id, it reads back inlined in the site's values.assets, and deleting the site deletes it. GET /objects/sites/{id}/assets lists a site's assets in full.
Both types are served by the generic endpoints under /objects/sites and /objects/assets, and both can carry timeseries. Their schemas are fixed: standard types cannot be modified or deleted through the API (403), and filters on their lists are a 400. To model anything else, or to group sites and assets into larger structures, define a custom object type.