DemandFlow Support Centre

SITE: Site

The SITE entity: A physical site or data centre location with buildings, capacity, security, and operational metrics.

Default definition. This article describes the default SITE 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 SITE.

Entity properties

Property	Value
Entity code	`SITE`
Display name	Site
Plural	Sites
Level	40000

Use cases

SITE is the top-level node in the physical infrastructure hierarchy (SITE > BUILDING > FLOOR > ROOM > RACK). It captures the geographic location (address, lat/lon for map rendering), physical attributes (area, building count), and capacity metrics (power, cooling, racks). Lookup references to SITESTATUS, SITETYPE, and SITEOWN classify the site's operational state, purpose, and ownership model.

The isWarehouse flag differentiates storage/logistics sites from data centres. Contacts link to PPL records for operational roles (primary, manager, emergency, security, tech, vendor). Security & Compliance tracks Uptime Institute tier certification, ISO/SOC/PCI/HIPAA/LEED compliance, audit schedules, and security level classification.

Fields

General

Field	Type	Required	Notes
`name`	text	Yes	Name
`siteId`	text		Site ID
`siteCode`	text		Site Code
`status`	reference → `SITESTATUS`		Site status
`sitetype`	reference → `SITETYPE`		Site type
`siteown`	reference → `SITEOWN`		Site ownership
`description`	text (multi-line)		Description
`isWarehouse`	boolean		Warehouse

Location

Field	Type	Notes
`pri_add_street1`	text	Street 1
`pri_add_street2`	text	Street 2
`pri_add_street3`	text	Street 3
`pri_add_city`	text	City
`pri_add_county`	text	County
`pri_add_postcode`	text	Postcode
`pri_add_country`	reference → `COUNTRY`	Country
`lat`	number	Latitude
`lon`	number	Longitude

Physical Attributes

Field	Type	Notes
`totalArea`	number	Total Area (sq ft)
`usableArea`	number	Usable Area (sq ft)
`whiteSpaceArea`	number	White Space (sq ft)
`numBuildings`	number	Number of Buildings
`numFloors`	number	Number of Floors
`yearBuilt`	date	Year Built
`lastRenovated`	date	Last Renovated

Capacity

Field	Type	Notes
`totalPowerCapacity`	number	Total Power Capacity (kW)
`availablePowerCapacity`	number	Available Power (kW)
`totalRackCapacity`	number	Total Rack Capacity
`availableRackCapacity`	number	Available Rack Capacity
`totalCoolingCapacity`	number	Total Cooling Capacity (tons)
`availableCoolingCapacity`	number	Available Cooling (tons)

Site contacts

Field	Type	Notes
`contact_primary`	reference → `PPL`	Primary contact
`contact_manager`	reference → `PPL`	Site manager
`contact_emergency`	reference → `PPL`	Emergency contact
`contact_security`	reference → `PPL`	Security manager
`contact_tech`	reference → `PPL`	Tech. support manager
`contact_vendor`	reference → `PPL`	Vendor / service manager

Online Resources

Field	Type	Notes
`contact_website`	text (URL)	Primary website for this facility
`contact_portal`	text (URL)	Client access portal URL
`contact_docs`	text (URL)	Link to site documentation repository
`contact_support`	text (URL)	Support ticket system URL

Security

Field	Type	Notes
`securityLevel`	enum	Security Level Classification Valid ids: `1` (Level 1 (Basic)), `2` (Level 2 (Enhanced)), `3` (Level 3 (Advanced)), `4` (Level 4 (High)), `5` (Level 5 (Maximum)).
`physicalAccessReq`	text (multi-line)	Physical Access Requirements
`securitySystems`	array of references → `SITESEC`	Security Systems

Certifications & Compliance

Field	Type	Notes
`uptimeTier`	enum	Uptime Institute Tier Valid ids: `1` (Tier I), `2` (Tier II), `3` (Tier III), `4` (Tier IV).
`certifications`	array (enum)	Certifications Valid ids: `1` (ISO 27001), `2` (SSAE 18/SOC 2), `3` (PCI DSS), `4` (HIPAA), `5` (LEED).
`lastAuditDate`	date	Last Audit Date
`nextAuditDate`	date	Next Scheduled Audit
`complianceStatus`	enum	Compliance Status Valid ids: `1` (Compliant), `2` (In Progress), `3` (Non-Compliant), `4` (Exempt).

Efficiency Metrics

Field	Type	Notes
`pue`	number	PUE (Power Usage Effectiveness)
`wue`	number	WUE (Water Usage Effectiveness)
`carbonFootprint`	number	Carbon Footprint (tons CO2)
`energyEfficiencyRating`	enum	Energy Efficiency Rating Valid ids: `1` (A++), `2` (A+), `3` (A), `4` (B), `5` (C), `6` (D).

Cost Metrics

Field	Type	Notes
`operationalCostMonthly`	number	Monthly Operational Cost
`maintenanceCostMonthly`	number	Monthly Maintenance Cost
`energyCostMonthly`	number	Monthly Energy Cost
`costPerKwh`	number	Cost per kWh

Maintenance Information

Field	Type	Notes
`maintenanceSchedule`	text (multi-line)	Maintenance Schedule
`lastMaintenanceDate`	date	Last Maintenance Date
`nextMaintenanceDate`	date	Next Maintenance Date
`maintenanceProvider`	reference → `COM`	Maintenance Provider
`maintenanceNotes`	text (multi-line)	Maintenance Notes

Disaster Recovery Systems

Field	Type	Notes
`backupPowerType`	array of references → `POWER`	Backup Power Type
`backupPowerCapacity`	number	Backup Power Capacity (kW)
`fireSuppType`	array of references → `POWER`	Fire Suppression Type

Risk Assessment

Field	Type	Notes
`floodRisk`	enum	Flood Risk Valid ids: `1` (Low), `2` (Medium), `3` (High).
`earthquakeRisk`	enum	Earthquake Risk Valid ids: `1` (Low), `2` (Medium), `3` (High).
`hurricaneRisk`	enum	Hurricane/Tornado Risk Valid ids: `1` (Low), `2` (Medium), `3` (High).
`drPlanUrl`	text (URL)	Link to disaster recovery plan document

Additional panels

Map panel rendered from latitude/longitude fields.

Relationships

Lookups: status points at a SITESTATUS record; sitetype points at a SITETYPE record; siteown points at a SITEOWN record; pri_add_country points at a COUNTRY record; contact_primary points at a PPL record; contact_manager points at a PPL record; contact_emergency points at a PPL record; contact_security points at a PPL record; contact_tech points at a PPL record; contact_vendor points at a PPL record; securitySystems points at a SITESEC record; maintenanceProvider points at a COM record; backupPowerType points at a POWER record; fireSuppType points at a POWER record.
Related lists: BUILDING (format comboKeyEntity), INFRAUNIT (format link).

Creating a Site via the API

POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json

{
  "entity":   "SITE",
  "level":    40000,
  "comboKey": "SUB:|ENT:",
  "name":    "Example name",
  "siteId":    "Example value",
  "siteCode":    "Example value",
  "status":    ""
}

Listing Sites records

GET /v1/entities/SITE/SUB

DemandFlow Support Centre

SITE: Site

SITE: Site

Entity properties

Use cases

Fields

Relationships

Creating a Site via the API

Listing Sites records

See also

Was this article helpful?