Energy Charge Intents

Set user charge intent

Changed on

Required scope: energy:write

Only type is required, e.g. {"type": "CHARGE_NOW"}. PRICE_OPTIMIZE additionally requires target and departureTime; scheduleOverrides defaults to an empty list and priority to 0.

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

post/api/v1/energy/sites/{siteId}/users/{userId}

Request

  • Base URL
    https://partner-api.monta.com
  • URL
    https://partner-api.monta.com/api/v1/energy/sites/{siteId}/users/{userId}
  • Auth
    HTTP bearer

Path parameters

siteIdinteger required
userIdinteger required

Request body

type'PRICE_OPTIMIZE' | 'CHARGE_NOW' required

Charge intent type

departureTimestring nullable

Departure time (local time of the site). Required for PRICE_OPTIMIZE.

priorityinteger nullable

Priority of the charge intent. Defaults to 0.

Example request

{
  "type": "CHARGE_NOW",
  "departureTime": "07:30:00"
}

Response

setUserChargeIntent 201 response

type'PRICE_OPTIMIZE' | 'CHARGE_NOW' required
departureTimestring partial-time nullable
priorityinteger nullable

Changes