Buildings and data sources
Update a building
Changes the fields you send and keeps every other field as it is.
PUT
Update a building
The update is partial. Nothing is required. A field you leave out, send as
null, or send as an empty string keeps its stored value.
addressreplaces the stored address as a whole. Sendaddress1,city,zip, andcountrywhenever you sendaddress. The API looks up the new address again and updates the location and the time zone.sitereplaces the stored site group. Send bothidentifierandname.namemust stay unique in your organization, ignoring case.baseTempis in °F andareais in square feet.- The API ignores
published,status,products,tags,picture, andtzif you send them. To publish a building, use Set the status of a building.
Authorizations
Paste an access token from Create an access token. Tokens expire, so request a new one if you receive 401.
Path Parameters
Building identifier from List buildings.
Body
application/json
Maximum string length:
50Required range:
1600 <= x <= 2100Required range:
x >= 0Maximum string length:
255Maximum string length:
255Maximum string length:
255Maximum string length:
255Maximum string length:
255Response
The building after the update.
Date and time in UTC, with a numeric offset and no colon, for example 2026-10-28T13:51:31+0000.
Example:
"2026-10-28T13:51:31+0000"
Date and time in UTC, with a numeric offset and no colon, for example 2026-10-28T13:51:31+0000.
Example:
"2026-10-28T13:51:31+0000"

