---
title: "Set a node's weekly power-limit schedule"
method: PUT
path: "/api/v1/energy/sites/{siteId}/nodes/{nodeId}/power-limit-schedule"
tags: ["Energy Sites"]
---

# Set a node's weekly power-limit schedule

`PUT /api/v1/energy/sites/{siteId}/nodes/{nodeId}/power-limit-schedule`

## Request

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

Required scope: `energy:write`

Replaces the node's whole weekly power-limit schedule with `powerLimitSchedule`. Send an empty list to clear the schedule.

Each item limits the node to `powerLimitW` watts on `dayOfWeek` (`MONDAY` … `SUNDAY`) from `startTime` until `endTime`, both in `HH:mm` local site time. `startTime` must be before `endTime`, `powerLimitW` must be zero or positive, and intervals on the same day must not overlap. An `endTime` of `23:59` lasts until midnight. Outside the scheduled intervals the node's configured `powerLimitW` applies, and an active external power limit takes precedence over the schedule.

Returns 400 for an invalid schedule and 404 when the site or node is not found.

🚧 **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

- UpdatePowerLimitScheduleRequest
  - `powerLimitSchedule` PowerLimitScheduleItem[], required
    - `dayOfWeek` string, required
    - `startTime` string, required
    - `endTime` string, required
    - `powerLimitW` number, double, required

## Response `204`

updatePowerLimitSchedule 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/power-limit-schedule/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)