---
title: "Set a temporary power limit on a node"
method: PUT
path: "/api/v1/energy/sites/{siteId}/nodes/{nodeId}/external-power-limit"
tags: ["Energy Sites"]
---

# Set a temporary power limit on a node

`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

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.

## Path parameters

- `siteId` integer, required
- `nodeId` integer, required

## Request body

- SetNodeExternalPowerLimitRequest
  - `limitW` number, double, required
  - `expiresAt` string, date-time, required

## Response `204`

setNodeExternalPowerLimit 204 response

## Other responses

- `400`: The request is invalid
- `401`: Consumer with provided credentials was not found
- `403`: Operator doesn't have access to resource
- `404`: Entity with the provided id was not found

## Changes

- **2026-11-03** `0ca400461c52`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/monta/apis/monta-partner-api/changes/api/v1/energy/sites/:siteId/nodes/:nodeId/external-power-limit/put.md)

---

[API](https://skmtc.dev/monta/apis/monta-partner-api.md) - [All operations](https://skmtc.dev/monta/apis/monta-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monta/apis/monta-partner-api/revisions/0ca400461c52?raw)