FLOOR: Floor
A floor within a building, tracking rooms, capacity, infrastructure, and environmental metrics.
Default definition. This article describes the default
FLOOR definition shipped with DemandFlow. Administrators can add, remove, rename, or re-type fields, change which ones are required, and alter the layout from the Definitions screen in Settings. Your tenant's current schema may differ from what is shown here. To read the current definition at any time, GET the DEFINITION object whose id matches FLOOR.Entity properties
| Property | Value |
|---|---|
| Entity code | FLOOR |
| Display name | Floor |
| Plural | Floors |
| Level | 250 |
Use cases
FLOOR is the third level in the physical hierarchy (SITE > BUILDING > FLOOR > ROOM > RACK). Each floor belongs to a parent BUILDING via comboLookup, with a floorNumber field (0 for ground, negative for basements) for ordered display. Status uses the FLOORSTATUS lookup.
Fields
General
| Field | Type | Required | Notes |
|---|---|---|---|
name | text | Yes | Name. |
floorId | text | Floor ID. | |
floorNumber | number | 0 for ground floor, negative for basement levels | |
building | reference → BUILDING | Parent Building. | |
status | reference → FLOORSTATUS | Floor Status. | |
description | text (multi-line) | Description. |
Physical Attributes
| Field | Type | Required | Notes |
|---|---|---|---|
totalArea | number | Total Floor Area (sq ft). | |
usableArea | number | Usable Area (sq ft). | |
whiteSpaceArea | number | White Space Area (sq ft). | |
supportSpaceArea | number | Support Space Area (sq ft). | |
floorHeight | number | Floor Height (ft). | |
ceilingHeight | number | Ceiling Height (ft). | |
floorLoading | number | Floor Loading Capacity (lbs/sq ft). |
Floor Plan
| Field | Type | Required | Notes |
|---|---|---|---|
floorPlanUrl | text (URL) | Link to floor plan document |
Space Capacity
| Field | Type | Required | Notes |
|---|---|---|---|
totalRackCapacity | number | Total Rack Capacity. | |
usedRackSpace | number | Used Rack Space. | |
availableRackSpace | number | Available Rack Space. | |
maxRackHeight | number | Maximum Rack Height (U). |
Power & Cooling
| Field | Type | Required | Notes |
|---|---|---|---|
totalPowerCapacity | number | Total Power Capacity (kW). | |
usedPower | number | Used Power (kW). | |
availablePower | number | Available Power (kW). | |
totalCoolingCapacity | number | Total Cooling Capacity (kW). | |
usedCooling | number | Used Cooling (kW). | |
availableCooling | number | Available Cooling (kW). |
Electrical Systems
| Field | Type | Required | Notes |
|---|---|---|---|
powerDistributionType | reference → POWERDIST | Power Distribution Type. | |
powerCircuitCount | number | Power Circuit Count. | |
pduCount | number | PDU Count. | |
upsAvailable | boolean | UPS Available. | |
voltageTypes | array of enums | Valid ids: 1 (120V Single-Phase), 2 (208V Single-Phase), 3 (208V Three-Phase), 4 (240V Single-Phase), 5 (480V Three-Phase). |
Cooling & Air Systems
| Field | Type | Required | Notes |
|---|---|---|---|
coolingType | reference → COOLINGFLOOR | Cooling Type. | |
hasCracUnits | boolean | Has CRAC Units. | |
cracUnitCount | number | CRAC Unit Count. | |
hasRaisedFloor | boolean | Has Raised Floor. | |
raisedFloorHeight | number | Raised Floor Height (inches). | |
airContainment | reference → AIRCONT | Air Containment. |
Access Control
| Field | Type | Required | Notes |
|---|---|---|---|
accessControlType | reference → ACCESSCONT | Access Control Type. | |
entrancePoints | number | Number of Entrance Points. | |
exitPoints | number | Number of Exit Points. | |
cameraCount | number | Security Camera Count. | |
securityNotes | text (multi-line) | Security Notes. |
Fire Safety
| Field | Type | Required | Notes |
|---|---|---|---|
fireDetectionType | reference → FIREDET | Fire Detection Type. | |
fireSuppression | reference → FIRESUP | Fire Suppression System. | |
emergencyExit | boolean | Emergency Exit Available. | |
fireExtinguisherCount | number | Fire Extinguisher Count. |
Maintenance Information
| Field | Type | Required | Notes |
|---|---|---|---|
lastMaintenanceDate | date | Last Maintenance Date. | |
nextMaintenanceDate | date | Next Scheduled Maintenance. | |
maintenanceProvider | reference → COM | Maintenance Provider. | |
maintenanceNotes | text (multi-line) | Maintenance Notes. |
Environmental Metrics
| Field | Type | Required | Notes |
|---|---|---|---|
targetTemperature | number | Target Temperature (°F). | |
targetHumidity | number | Target Humidity (%). | |
tempHumidSensorCount | number | Temperature/Humidity Sensor Count. | |
leakDetection | boolean | Leak Detection System Installed. |
Energy Metrics
| Field | Type | Required | Notes |
|---|---|---|---|
powerDensity | number | Power Density (W/sq ft). | |
annualPowerConsumption | number | Annual Power Consumption (kWh). | |
pue | number | Power Usage Effectiveness for this floor |
Relationships
- Lookups:
buildingpoints at aBUILDINGrecord;statuspoints at aFLOORSTATUSrecord;powerDistributionTypepoints at aPOWERDISTrecord;coolingTypepoints at aCOOLINGFLOORrecord;airContainmentpoints at aAIRCONTrecord;accessControlTypepoints at aACCESSCONTrecord;fireDetectionTypepoints at aFIREDETrecord;fireSuppressionpoints at aFIRESUPrecord;maintenanceProviderpoints at aCOMrecord. - Related lists:
ROOM.
Creating a Floor via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "FLOOR",
"level": 250,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "Example",
"floorId": "...",
"floorNumber": 1,
"building": "..."
}
Listing Floors
# All records in your tenant
GET /v1/entities/FLOOR/SUB:<your-sub-id>