Energy Sites

Set a temporary power limit on a node

Changed on

Required scope: energy:write

Limits the node to limitW watts until expiresAt (must be in the future), after which the limit is lifted automatically. A limit of 0 fully curtails the node.

A node holds at most one external power limit: setting a new one replaces the existing one. While active, the external limit replaces the node's configured and scheduled powerLimitW, so it can be higher or lower than them. The node's fuse limit still applies.

The active limit is returned as externalPowerLimitW and externalPowerLimitExpiresAt on the node in GET /sites/{siteId}. Both are null when no limit is active. A limit set by a meter integration may have a null externalPowerLimitExpiresAt.

On a node with a Perific meter that has a digital-input rule configured, the meter controls this limit and overwrites or clears it on every meter report.

🚧 BETA — This endpoint is currently in the BETA phase and its response structure may change in the future.

📘 Feature flag required — This endpoint is not available by default. It must be explicitly enabled for your operator account upon request. Please contact your Monta Business Partner to request access to this feature.

put/api/v1/energy/sites/{siteId}/nodes/{nodeId}/external-power-limit

Request

  • Base URL
    https://partner-api.monta.com
  • URL
    https://partner-api.monta.com/api/v1/energy/sites/{siteId}/nodes/{nodeId}/external-power-limit
  • Auth
    HTTP bearer

Path parameters

siteIdinteger required
nodeIdinteger required

Request body

limitWnumber double required
expiresAtstring date-time required

Response

setNodeExternalPowerLimit 204 response

Changes