POWERCIRCUIT: Power Circuit
The POWERCIRCUIT entity represents an electrical circuit feeding a rack, tracking voltage, amperage, phase, upstream feed path, and real-time load.
POWERCIRCUIT 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 POWERCIRCUIT.Entity properties
| Property | Value |
|---|---|
| Entity code | POWERCIRCUIT |
| Display name | Power Circuit |
| Plural | Power Circuits |
| Level | 275 |
Use cases
Power Circuit represents an individual electrical circuit feeding a rack, bridging the gap between room-level power infrastructure (RPPs, panel boards) and rack-level PDUs. It is a child of RACK via comboKeyEntity - matching the existing relatedlist already defined on RACK's Power panel (which expects name, voltage, amperage, phase fields). The upstream feed fields (sourcePanel, sourceBreakerPosition, feedPath) trace the circuit back to its panel board and identify which power path (A/B/STS) it belongs to - critical for understanding redundancy. connectedPdu links to COMPINV because PDUs are physical assets that should be tracked in the asset register. The Metering panel provides readonly fields for integration with intelligent PDU or BMS data, plus threshold-based alerting. Connector types cover both North American (NEMA) and international (IEC 60309) standards plus busway tap-off for overhead busbar systems.
Fields
General
| Field | Type | Required | Notes |
|---|---|---|---|
name | text | Yes | Unique circuit identifier (e.g., A1-C01, RPP-B-12). |
circuitLabel | text | Label as shown on the panel board or breaker. | |
status | enum | Yes | Status. Valid ids: 1 (Active), 2 (Planned), 3 (Reserved), 4 (Maintenance), 5 (Faulted), 6 (Decommissioned). |
circuitPurpose | enum | Purpose. Valid ids: 1 (Primary), 2 (Redundant), 3 (Maintenance), 4 (Emergency). | |
description | text (multi-line) | Description. | |
voltage | number | Yes | Voltage (V). |
amperage | number | Yes | Amperage (A). |
phase | enum | Yes | Phase. Valid ids: 1 (Single Phase), 2 (Three Phase). |
ratedCapacityKw | number | Maximum design load for this circuit. | |
connectorType | enum | Connector Type. Valid ids: 1 (NEMA L5-30), 2 (NEMA L6-20), 3 (NEMA L6-30), 4 (NEMA L6-50), 5 (NEMA L14-30), 6 (NEMA L15-30), 7 (NEMA L21-30), 8 (IEC 60309 16A), 9 (IEC 60309 32A), 10 (IEC 60309 63A), 11 (IEC 60309 125A), 12 (Hardwired), 13 (Busway Tap). | |
wireGauge | text | e.g., 10 AWG, 6 AWG, 4mm². | |
breakerSize | number | Breaker Size (A). | |
sourcePanel | text | Panel board or RPP this circuit originates from. | |
sourceBreakerPosition | text | Position in panel board (e.g., Slot 12, Breaker 3). | |
feedPath | enum | Feed Path. Valid ids: 1 (A Feed (Utility)), 2 (B Feed (UPS/Generator)), 3 (C Feed), 4 (STS (Static Transfer Switch)). | |
connectedPdu | reference → COMPINV | PDU asset this circuit feeds. | |
pduInlet | text | Which inlet on the PDU (e.g., Inlet 1, Inlet A). |
Metering
| Field | Type | Required | Notes |
|---|---|---|---|
measuredLoadKw | number | Measured Load (kW). Read-only. | |
measuredLoadAmps | number | Measured Load (A). Read-only. | |
loadPercentage | number | Percentage of rated capacity in use. Read-only. | |
lastReadingDate | datetime | Last Reading. Read-only. | |
powerFactor | number | Power Factor. Read-only. | |
warningThresholdPercent | number | Alert when load exceeds this percentage. | |
criticalThresholdPercent | number | Critical alert when load exceeds this percentage. | |
peakLoadKw | number | Peak Load (kW). Read-only. | |
peakLoadDate | datetime | Peak Load Date. Read-only. | |
averageLoadKw | number | Average Load (kW). Read-only. |
Maintenance
| Field | Type | Required | Notes |
|---|---|---|---|
installDate | date | Installation Date. | |
lastInspectionDate | date | Last Inspection. | |
nextInspectionDate | date | Next Inspection. | |
lastThermographyDate | date | Last infrared thermography inspection. | |
notes | text (multi-line) | Notes. |
Relationships
- Lookups:
connectedPdupoints atCOMPINVrecord.
Creating a Power Circuit via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "POWERCIRCUIT",
"level": 275,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "Example",
"status": 1,
"voltage": 100,
"amperage": 100
}
Listing POWERCIRCUIT records
# All power circuits in your tenant
GET /v1/entities/POWERCIRCUIT/SUB