Buildings and data sources
Set the status of a building
Sets a building to PUBLISHED or UNPUBLISHED. You can switch it back at any time.
PUT
Set the status of a building
A new building is
UNPUBLISHED. The building keeps this status in published (true for PUBLISHED) until you change it again.
The values are case-sensitive. Sending the status the building already has returns
409, so a repeated call is not safe to treat as a no-op.
The status does not delete any data. If your service account’s role limits access to published buildings, an unpublished building returns 403 on reads, including Get a building and Get a job. Publishing and unpublishing still work in that case.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
Pattern:
^(PUBLISHED|UNPUBLISHED)$Response
The building with its new status.
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"

