GuidesAPI ReferenceChangelogDiscussions
Log In
Changelog

v2.2.0 Release: Flex schedules and group curtialment support


Functional changes

  • Introduced dedicated flex schedule endpoints (/flex/schedules) for group curtailment operations
  • Added support for group-level curtailment controls using:
    • groupGridTargetKw
    • addressGridTargetW
    • solarInverterCapacityPercentage
  • Mapped flex schedule fields to Amber group schedule fields:
    • group_grid_target_kw
    • grid_target_w
    • powerlimit
  • Added inverter-level flex schedule views exposing resulting groupSolarInverterScheduleInterval data and steered watt targets
  • Separated flex curtailment schedules from user/home inverter schedules (/schedules) to support distinct operational domains
  • Retained user inverter schedules for home control use cases using:
    • powerlimit
    • zeroExport

Purpose

Provides a dedicated curtailment-oriented scheduling model for group operations while maintaining separate user-facing inverter scheduling functionality.

This enables:

  • Grid-target-based curtailment operations for operators and flexibility services
  • Read-only inverter-level visibility into executed group curtailment actions
  • Clear separation between group curtailment logic and user/home inverter controls
  • More scalable and future-proof scheduling APIs for curtailment and flexibility use cases

Additional notes

  • addressGridTargetW is not equivalent to zeroExport; it represents a watt-based grid target used in curtailment operations
  • solarInverterCapacityPercentage is analogous to powerlimit within the flex/group curtailment domain, but does not include the user scheduling concept of zeroExport