Sandbox

What the sandbox is

The sandbox is a read-only demo environment with a fully modeled building. It has real equipment hierarchies, sensor points, and spatial data, so you can run queries immediately without connecting your own building. The demo building includes:

Multiple wings and floors with HVAC zones
AHUs, VAVs, FCUs, pumps, and heat exchangers
Temperature, pressure, humidity, and airflow sensors
Equipment chains with feeds relationships you can traverse

Access the sandbox

Go to app.betacit.com and sign in. If you don’t have an account, sign up. The sandbox is available on all plans.

Switch to the sandbox site

In the site selector, choose Demo Building (Sandbox). This is a shared, read-only site that resets periodically.

Copy your site ID

The sandbox site ID is shown in your dashboard. You’ll need it for every query.

export TACIT_API_KEY="your-api-key"
export SITE_ID="sandbox-site-id"

Try a query

List all HVAC equipment in the demo building:

curl -X POST https://app.betacit.com/graphql \
  -H "Authorization: Bearer $TACIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "{ equipment(siteId: \"'$SITE_ID'\", is: \"HVAC_Equipment\") { name type location { name } } }"
  }'

import requests

response = requests.post(
    "https://app.betacit.com/graphql",
    headers={"Authorization": f"Bearer {TACIT_API_KEY}"},
    json={
        "query": """
        {
          equipment(siteId: "%s", is: "HVAC_Equipment") {
            name
            type
            location { name }
          }
        }
        """ % SITE_ID
    }
)

for equip in response.json()["data"]["equipment"]:
    print(f"{equip['name']} ({equip['type']}) - {equip['location']['name']}")

Response

{
  "data": {
    "equipment": [
      { "name": "TE01-XX-AHU-001", "type": "AHU", "location": { "name": "Tower East" } },
      { "name": "TW01-LBR-RPC-01", "type": "VAV", "location": { "name": "Library" } },
      { "name": "TW01-XX-AHU-001", "type": "AHU", "location": { "name": "Tower West" } }
    ]
  }
}

What you can do in the sandbox

The sandbox supports all read queries, the same API surface as production:

Browse buildings, floors, wings, and zones
Query equipment by Brick class (is: "AHU", is: "Temperature_Sensor")
Traverse upstream and downstream equipment chains
Cross-reference IFC model elements with entityByIfcId
Fetch point metadata and current values

The sandbox is read-only. REST endpoints that create, update, or delete resources will return 403 Forbidden.

Getting started

Core concepts

Guides

What the sandbox is

Access the sandbox

Try a query

What you can do in the sandbox

Next steps

Quickstart

Query your first building

​What the sandbox is

​Access the sandbox

​Try a query

​What you can do in the sandbox

​Next steps

Quickstart

Query your first building

What the sandbox is

Access the sandbox

Try a query

What you can do in the sandbox

Next steps