Skip to main content

Grid Constraints Configuration

Understanding Grid Constraints​

Grid constraints in the Covolt API define the operational boundaries for battery assets in relation to the electrical grid. These constraints ensure that your battery operation stays within the limits prescribed by:

  • Grid connection agreements
  • Local regulatory requirements
  • Physical limitations of your connection point

Types of Grid Constraints​

The Covolt API supports two primary types of grid constraints:

Import Limit​

The maximum power that can be drawn from the grid (in kilowatts). This affects battery charging operations.

Export Limit​

The maximum power that can be fed back into the grid (in kilowatts). This affects battery discharging operations.

Viewing Current Grid Constraints​

To view the current grid constraints for a battery asset:

GET /v2/power-meter-assets/{asset_id}/settings/grid-constraints/

Example response:

{
  "import_limit": 10,
  "export_limit": 7
}

In this example:

  • The battery is limited to importing a maximum of 10 kW from the grid
  • The battery is limited to exporting a maximum of 7 kW to the grid

Updating Grid Constraints​

Grid constraints can be updated using a PATCH request:

PATCH /v2/power-meter-assets/{asset_id}/settings/grid-constraints/

Request body:

{
  "import_limit": 15,
  "export_limit": 10
}
info

You can update either one or both constraints in a single request.

Impact on Battery Instructions​

Grid constraints directly affect how battery instructions are executed:

  1. If a battery discharge instruction would cause the export limit to be exceeded, the actual power will be capped at the export limit
  2. If a battery charge instruction would cause the import limit to be exceeded, the actual power will be capped at the import limit

Example Scenarios​

Scenario 1: Export Limit Impact

  • Export limit: 5 kW
  • Battery discharge instruction: 7 kW
  • Result: Battery will discharge at 5 kW (not 7 kW)

Scenario 2: Import Limit Impact

  • Import limit: 10 kW
  • Current grid import: 8 kW
  • Battery charge instruction: -5 kW
  • Result: Battery will charge at -2 kW (not -5 kW) to stay within the 10 kW import limit

Best Practices for Grid Constraints​

  • Regular Review: Periodically review your grid constraints to ensure they align with your current connection agreement
  • Conservative Settings: When unsure, set slightly conservative limits to avoid potential grid violations
  • Consider Other Loads: Remember that other loads at your site contribute to the overall grid exchange
  • Telemetry Monitoring: Use telemetry data to verify that your battery operation stays within constraints

Default Constraints​

When a battery asset is first provisioned, it may be configured with default grid constraints based on your connection agreement. These defaults can be updated at any time using the method described above.